kabl

A legible modular synthesizer, written in Rust. Cables are instruments, patches explain themselves, and the sound you hear can be traced back through the patch.

Linux is the supported platform for 1.0

01 The instrument

The kabl rack with the Sounds browser open
The rack, with the Sounds browser open
The Perform view with scenes, macros and bank cards
The Perform view: scenes, macros and bank cards

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
B
mix

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.