01 The instrument
02 Modules 24 kinds
Composite modules can be built from these and saved.
03 Functional cables
A cable is more than a wire. It can carry a step pattern, a pass probability, an A/B morph and glide, all locked to the patch clock, and macros can drive cable parameters.
A diagram of the idea, not kabl's audio engine. Turn the sound on to hear it (the browser's Web Audio): the cable's level drives the VCA of a small synth. To make the morph audible, pulses from pattern A play a low saw arpeggio and pulses from pattern B a brighter square voice; a kabl cable carries one signal. Each pulse of the clock (a 16th note) moves one step: Morph mixes each step's chance between pattern A and pattern B (the mix row), so the rhythm crossfades from A to B. One draw against that, times the cable's Chance, decides whether the pulse passes, and Glide slews the level. In kabl each step also has its own level and chance; here a step is simply on (100 %) or off (0 %).
Clock-locked. Macro-addressable. Details: docs/functional-cables
04 Signal path of the source
The workspace, patched like a rack: each cable is a direct dependency between crates (transitive ones left out). Click a crate (or tab to it and press Enter) to pin it and open its source; drag to move it, or use the arrow keys.
Click, or tab to a crate and press Enter, to pin it. Drag to move.
Real-time safe audio path: no allocation or locking in the callback, enforced by the tests (assert_no_alloc).
05 Build & run
From source
Needs a current stable Rust toolchain and, on Debian or Ubuntu, libasound2-dev libxkbcommon-dev libdbus-1-dev.
cargo run --release -p kabl-ui # the standalone synth
cargo build --release -p kabl-clap # the plugin: target/release/libkabl_clap.so
cargo test --workspace
From a release tarball
When a release is published on the Releases page, download kabl-<version>-linux-<arch>.tar.gz, then:
tar -xzf kabl-*-linux-*.tar.gz
cd kabl-*-linux-*
./install.sh # standalone, desktop entry, plugin in ~/.clap
./install.sh --uninstall
Runtime needs ALSA (libasound2), X11 or Wayland with OpenGL, and libxkbcommon-x11. In a DAW, scan ~/.clap and load kabl as an instrument. Your own sounds are saved to ~/.local/share/kabl/sounds and are never touched by an upgrade or an uninstall.
06 Licence
Source code: GPL-3.0-or-later. The name “kabl” and the logo are reserved; a fork needs its own name. Music you make with kabl is yours, with no conditions. Details in the repository’s COPYRIGHT, TRADEMARKS.md and ASSET-LICENSES.md.