klangstudio » help
Klang Studio is an integrated development environment (IDE) for developing sounds, synthesisers and effects in C++ or the Klang C++ dialect, designed for rapid audio prototyping and DSP development.
IMPORTANT: This is a pre-release version of Klang Studio. It is provided "AS IS" with no warranty whatsoever; the developers shall not be held responsible for any ill-effects or consequences arising from use or misuse of the software. If running as a DAW plugin, it is strongly recommended to save and backup your DAW project regularly. Klang Studio runs user code in a sandbox, which protects the host from most but not all bugs that can be introduced in user code.
If you have issues or feedback, please report using the Feedback tab above, or by emailing klang@nash.audio, or by using the "Issues" feature on GitHub.com.
Klang Studio runs as a standalone app with Sound, Effect and Synth modes. Effect and Synth can also run in a compatible DAW as VST plugins on Windows or Audio Units on macOS.
Based on the LLVM/Clang toolset, Klang Studio provides tools to design, code, compile and analyse audio processes. The plugin versions let you work live within the DAW.
Klang Studio is based on a mini-plugin architecture. Each hot-swappable mini-plugin contains the core parts of the sound, synth or effect, including the code to process audio, handle input and define its controls.
In a DAW, Klang Studio appears as a regular audio plugin and connects the host to the mini-plugin.
However, the studio also allows you to edit the source code of the mini-plugin, which it can recompile and swap out at the click of a button (i.e. "Build"). Moreover, the code editor supports syntax highlighting, code completion, graph plotting, and detailed audio analysis.
On Windows, Klang Studio also supports realtime debugging, allowing you to pause at breakpoints and inspect variables. The studio runs a debug build of the mini-plugin in a separate process so you can pause it without stopping the DAW.
In addition to C++, Klang Studio supports Klang, a C++ dialect for audio programming that uses C++17 to bring all the advantages of audio programming languages to C++.
Klang is an extension of the C++ language that transforms it into a more accessible, more expressive tool for developing audio processes - without any compromises to the performance, compatibility and portability of native C++ code.
A single-header C++ include (klang.h), Klang adds signal flow semantics (<<, >>), new language primitives, and a library of optimised DSP components to C++17 projects on platforms such as Windows, macOS and WebAssembly.
Klang looks and feels like a specialist audio programming language (e.g. SOUL, CMajor, SuperCollider, CSound, ChucK), but is 100% pure, native C++ code.
The Klang project, including the language and studio, is part of an effort to make C++ audio programming more live, expressive, and accessible. The project is maintained by nash.audio, a UK-based non-profit organisation supporting projects in music and technology.
of the live plugin. Use the
controls array to define
the layout of dials, sliders,
menus, buttons, etc.
Editable controls can be
automated in the DAW.
A custom bitmap can also
be used for the background.
Analysis
and frequency plots
of the plugin output,
as well as a debug
signal you can feed from anywhere in
your code. Impulse
response plots can
also be generated.
and Tests
plugin in the DAW, a range
of test materials is provided
via the built-in audio and
MIDI player - which also
supports output capture
(recording) and the plotting
of impulse response.
| Build | Compile the code and update the plugin. Shows compiler output and advice, if unsuccessful. |
| Unload | Unload and/or reload the running plug-in. |
| Save | Save the code (happens automatically on build). |
| Help | Show/hide the help documentation. |
| Main Toolbar | |
| Debug | On Windows, rebuilds and runs the mini-plugin in Debug mode. Execution pauses and variables are shown at breakpoints. Press Resume to continue, Stop to end, or Build to return to a normal build. |
is provided for quick testing. Vertical position on the key affects velocity. The computer keyboard can also be used
- use the mouse wheel to change the base octave.
Hover over the
image to explore
the studio.