Repository navigation
Releases
kabelsalat 0.2.0
Added
-
MIDI-controlled parameters appear on the interface automatically: binding
a MIDI CC (via MIDI learn, the MIDI Matrix, an agent/MCP tool, or a loaded
session) to a CLAP or LV2 parameter that is not currently shown on the unit's
face now adds it as a face knob (with itsCC nbadge, live value tracking,
and right-click MIDI menu), yielding an unbound main control when needed and
prioritizing MIDI-controlled knobs on narrow faces. Clearing the binding
removes the auto-added knob and restores the unit's main controls. -
Adaptive input range on MIDI learn: moving a controller during MIDI
learn (e.g. a wind controller's bite CC spanning 64–104) tracks the min and
max values seen while learning, shows the live range on the badge, and
adapts the binding's input curve once the controller settles (1.5 s, or
press Enter / click Finish MIDI learn) so that partial travel steers the
full knob. The learned Input range appears in the knob's right-click menu
(editable 0–127, preserved when capping output Controller range, and
reset by Full range), is saved with the session, and is exposed to agents
viaset_cc_map(in_min/in_max) andlist_cc_maps(input_range). -
Controller range on a MIDI-mapped knob: right-click a bound knob and
set MIN / MAX under Controller range. The controller's whole travel then
spans only that stretch, so an expression pedal on organ drive can be held
below 60 % and still use its full sweep. The knob shows the reachable
stretch in blue between two ticks, Full range lifts the limit, and the
range is saved with the session. Agents set it withset_cc_map
min/max, andlist_cc_mapsreports it. -
MIDI strip on the software keyboard: the keyboard dock now carries a
pitch-bend wheel (springs back to centre), a modulation wheel (CC 1, holds
its value), a sustain pedal (CC 64) and a velocity slider (the Keys unit's
VEL knob), like GarageBand's. They go out as the Keys source, so every rig
the keys feed responds, and they light the Keys unit's MIDI cables. Pitch
bend from a hardware controller now reaches the instruments too, and CC 1 /
CC 64 reach LV2 instruments as they already reached CLAP ones (#97). -
The assistant can listen (#35). A new
listentool records a few
seconds of the master and sends them to an audio-capable model on
OpenRouter (Gemini 3.8 Flash by default;agent_listen_modelin
config.json picks another). The model scores the sound 0-10 on the words
of your request ("8-bit", "heroic", "warm") and says what it heard and how
to move toward them. The agent plays notes, listens, changes one thing and
listens again. A listen takes the recording plus about 3 s. It needs an
OpenRouter key; without one the agent is pointed atmeasure_mix. MCP
agents get the samelistentool, headless and attached.
kabelsalat listen-testchecks that the model ranks known reference clips
the right way round and prints its latency. -
Plugin windows: a CLAP instrument's own editor (Surge XT, Odin 2,
Dexed, YANES, Aeolus) opens from "Open plugin window" at the top of its
editor pane, in a window of its own, and closes from the same button or the
window's close button. kabelsalat now runs the plugin's timers and file
descriptor callbacks, which these editors paint from.
kabelsalat editor-testopens, checks and closes every installed editor. -
Vital patches in Vitalium: Vitalium (the Linux port of Vital) now plays
.vitalpatches, wavetables and modulation included. Its sound list in the
editor and the assistant'slist_sounds/load_soundshow every patch in
Vitalium's folder. Drop a.vitalbankor.vitalfile on the window to add
it (or runkabelsalat vital-import <file>). A loaded patch is kept in saved
sessions, through rig edits and through undo. -
Instrument profiles: map a whole hardware instrument at once. Pick the
instrument for a hardware port in the MIDI matrix (a port whose name names
the instrument is matched by itself) and its knobs, drawbars and switches
drive the rack, with no MIDI learn per control. The first profile is the
Nord Electro 2: its nine upper drawbars, rotary slow/fast, percussion and
overdrive drive the setBfree organ face. Profiles are MIDI Guide CSV files
with arolecolumn; more go in~/.config/kabelsalat/instruments/. -
Odin 2 and Floe in the instrument catalog (Plugins → Install). Odin 2
installs from its prebuilt release on x86_64 and builds from source on
aarch64; its 260 factory patches are fetched too, so the assistant can list,
search and load them. Floe installs from its release on x86_64; it publishes
no aarch64 Linux build, and its card says so there. Release downloads are
checked against a pinned SHA-256. -
Aeolus in the instrument catalog: a pipe organ with additive pipe
models, several divisions of stops and a convolution reverb. It installs
from its v0.3.0 release on x86_64 and builds from source on aarch64.
Aeolus starts with every stop off, so kabelsalat starts it with a
principal chorus drawn, andlist_sounds/load_soundoffer 12
registrations (principals, flutes, celeste, reeds, full organ). The
Aeolus unit has a stop panel like a console's stop jamb: Manual III, II,
I and Pedal down the left, and each stop of the shown division with an
indicator light; a click draws it or pushes it in. The panel reads the stops
back from the plugin, so it follows sound and session loads. -
Catalog cards say what you install: a short description, the licence,
how it is installed on this machine, and buttons that open the source code
and the project's website.list_instrumentsreports the same fields. -
GitHub stars on catalog cards: each card shows its project's star count
(★ 235, ★ 3.9k), read live from GitHub once per run when the Install tab
opens. Without internet access, or when GitHub refuses, cards show no stars. -
Sessions save themselves (#51): with Autosave sessions on (Settings,
on by default) the open session is written every 20 s when it changed, and
on quit; a patch that was never saved goes toAutosave. Loading a session
or saving one makes it the open session; a starter template never replaces
it. Each saved session has an Overwrite action (with a confirm) that
saves the current patch over it, and the open session is marked in the list. -
AppImage download links in every release: release notes link the
x86_64 and aarch64 AppImages directly, and the Release workflow can attach
packages to a tag that was released before it existed (-f tag=v0.1.0).
The README links the newest AppImage for each architecture directly; the
AppImages are namedkabelsalat-<arch>.AppImage, and AppImageUpdate or
Gear Lever update them in place. -
Organ face for setBfree: nine drawbars to pull (16′ … 1′) and LESLIE
(stop/slow/fast), PERC, DRIVE and REVERB knobs. setBfree only listens to MIDI
controllers, so the face sends its CCs; values are saved with the session,
work with MIDI learn, and a loaded programme shows its registration. -
Octave per split zone: a split Keys face shows LOW and HIGH octave
steppers (−3…+3). A bass below the split no longer has to sound as deep as
the low keys it is played on; the assistant sets the LOW zone an octave up
when it puts a bass there. Saved with the session. -
ProgramChangeengine command: a MIDI programme change to one
instrument node (how setBfree changes its registration), and
kabelsalat sound-library-test, which lists, searches and loads one sound
per installed catalog instrument through the real engine. -
Main controls on every instrument: a synth's face shows up to four of
the controls its designer marked as most important, left ofLEVEL, as
many as the unit is wide. They come from the plugin's CLAP remote-controls
pages (Surge XT: the patch's named macros, else the scene mixer), from LV2
ports with aparam:designation, or else from its first continuous
parameters, macros first (Dexed, YANES, Vitalium). The knobs drive the real
parameters, are MIDI-learnable, follow the plugin's value (a loaded patch
moves and renames them), and LV2 ones are saved with the session. The
agent'slist_paramsreturns the same list asmain_controlsahead of the
full parameter list, and a control's name binds with
set_cc_map knob=<name>.kabelsalat main-controls-testprints each
installed instrument's main controls and moves one through the engine. -
Settings view (
,/ top barSettings): added a main-stage Settings view
for configuring per-role agent models (agent_decide_modelwith On/Off switch,
agent_act_model,agent_perceive_model) via themed dropdowns or custom model
IDs with effective route and key status, saving/removing DeepSeek and
OpenRouter API keys (masked, restarting the assistant worker immediately),
and editing preferences (ui_reduce_motion, count-in on/bars, audio output,
plus read-only detected UI scale). -
Packages for every release, on x86_64 and aarch64: a Flatpak bundle
(io.github.ssalentin.kabelsalat), an AppImage, a plain.tar.gzand an
Arch package, built by GitHub Actions on eachvX.Y.Ztag and attached to
the release. Every push and pull request builds and runs the unit suite on
both architectures. Seedocs/PACKAGING.md. -
kabelsalat --versionandkabelsalat --help. -
Live agent run UI & rack animations: docked assistant panel sizes cleanly to show >= 3 transcript turns at minimum window height, replaces static
"thinking…"with an animated phase/route indicator (Jev · deciding,DeepSeek · step N,Gemini · looking at the image), renders tool action chips under user messages with rule-7 padding, outcome states (Running,Done,NotApplied,Failed), collapsing (+N more), and one-line run cost. Agent rack edits gli...
kabelsalat nightly 0.1.0-dev.10562be
Automatic build of main at 10562be (2026-11-20).
Not a release: it may break; stable versions are the other releases.
Changes since the last release
Added
-
Controller range on a MIDI-mapped knob: right-click a bound knob and
set MIN / MAX under Controller range. The controller's whole travel then
spans only that stretch, so an expression pedal on organ drive can be held
below 60 % and still use its full sweep. The knob shows the reachable
stretch in blue between two ticks, Full range lifts the limit, and the
range is saved with the session. Agents set it withset_cc_map
min/max, andlist_cc_mapsreports it. -
MIDI strip on the software keyboard: the keyboard dock now carries a
pitch-bend wheel (springs back to centre), a modulation wheel (CC 1, holds
its value), a sustain pedal (CC 64) and a velocity slider (the Keys unit's
VEL knob), like GarageBand's. They go out as the Keys source, so every rig
the keys feed responds, and they light the Keys unit's MIDI cables. Pitch
bend from a hardware controller now reaches the instruments too, and CC 1 /
CC 64 reach LV2 instruments as they already reached CLAP ones (#97). -
The assistant can listen (#35). A new
listentool records a few
seconds of the master and sends them to an audio-capable model on
OpenRouter (Gemini 3.8 Flash by default;agent_listen_modelin
config.json picks another). The model scores the sound 0-10 on the words
of your request ("8-bit", "heroic", "warm") and says what it heard and how
to move toward them. The agent plays notes, listens, changes one thing and
listens again. A listen takes the recording plus about 3 s. It needs an
OpenRouter key; without one the agent is pointed atmeasure_mix. MCP
agents get the samelistentool, headless and attached.
kabelsalat listen-testchecks that the model ranks known reference clips
the right way round and prints its latency. -
Plugin windows: a CLAP instrument's own editor (Surge XT, Odin 2,
Dexed, YANES, Aeolus) opens from "Open plugin window" at the top of its
editor pane, in a window of its own, and closes from the same button or the
window's close button. kabelsalat now runs the plugin's timers and file
descriptor callbacks, which these editors paint from.
kabelsalat editor-testopens, checks and closes every installed editor. -
Vital patches in Vitalium: Vitalium (the Linux port of Vital) now plays
.vitalpatches, wavetables and modulation included. Its sound list in the
editor and the assistant'slist_sounds/load_soundshow every patch in
Vitalium's folder. Drop a.vitalbankor.vitalfile on the window to add
it (or runkabelsalat vital-import <file>). A loaded patch is kept in saved
sessions, through rig edits and through undo. -
Instrument profiles: map a whole hardware instrument at once. Pick the
instrument for a hardware port in the MIDI matrix (a port whose name names
the instrument is matched by itself) and its knobs, drawbars and switches
drive the rack, with no MIDI learn per control. The first profile is the
Nord Electro 2: its nine upper drawbars, rotary slow/fast, percussion and
overdrive drive the setBfree organ face. Profiles are MIDI Guide CSV files
with arolecolumn; more go in~/.config/kabelsalat/instruments/. -
Odin 2 and Floe in the instrument catalog (Plugins → Install). Odin 2
installs from its prebuilt release on x86_64 and builds from source on
aarch64; its 260 factory patches are fetched too, so the assistant can list,
search and load them. Floe installs from its release on x86_64; it publishes
no aarch64 Linux build, and its card says so there. Release downloads are
checked against a pinned SHA-256. -
Aeolus in the instrument catalog: a pipe organ with additive pipe
models, several divisions of stops and a convolution reverb. It installs
from its v0.3.0 release on x86_64 and builds from source on aarch64.
Aeolus starts with every stop off, so kabelsalat starts it with a
principal chorus drawn, andlist_sounds/load_soundoffer 12
registrations (principals, flutes, celeste, reeds, full organ). The
Aeolus unit has a stop panel like a console's stop jamb: Manual III, II,
I and Pedal down the left, and each stop of the shown division with an
indicator light; a click draws it or pushes it in. The panel reads the stops
back from the plugin, so it follows sound and session loads. -
Catalog cards say what you install: a short description, the licence,
how it is installed on this machine, and buttons that open the source code
and the project's website.list_instrumentsreports the same fields. -
GitHub stars on catalog cards: each card shows its project's star count
(★ 235, ★ 3.9k), read live from GitHub once per run when the Install tab
opens. Without internet access, or when GitHub refuses, cards show no stars. -
Sessions save themselves (#51): with Autosave sessions on (Settings,
on by default) the open session is written every 20 s when it changed, and
on quit; a patch that was never saved goes toAutosave. Loading a session
or saving one makes it the open session; a starter template never replaces
it. Each saved session has an Overwrite action (with a confirm) that
saves the current patch over it, and the open session is marked in the list. -
AppImage download links in every release: release notes link the
x86_64 and aarch64 AppImages directly, and the Release workflow can attach
packages to a tag that was released before it existed (-f tag=v0.1.0).
The README links the newest AppImage for each architecture directly; the
AppImages are namedkabelsalat-<arch>.AppImage, and AppImageUpdate or
Gear Lever update them in place. -
Organ face for setBfree: nine drawbars to pull (16′ … 1′) and LESLIE
(stop/slow/fast), PERC, DRIVE and REVERB knobs. setBfree only listens to MIDI
controllers, so the face sends its CCs; values are saved with the session,
work with MIDI learn, and a loaded programme shows its registration. -
Octave per split zone: a split Keys face shows LOW and HIGH octave
steppers (−3…+3). A bass below the split no longer has to sound as deep as
the low keys it is played on; the assistant sets the LOW zone an octave up
when it puts a bass there. Saved with the session. -
ProgramChangeengine command: a MIDI programme change to one
instrument node (how setBfree changes its registration), and
kabelsalat sound-library-test, which lists, searches and loads one sound
per installed catalog instrument through the real engine. -
Main controls on every instrument: a synth's face shows up to four of
the controls its designer marked as most important, left ofLEVEL, as
many as the unit is wide. They come from the plugin's CLAP remote-controls
pages (Surge XT: the patch's named macros, else the scene mixer), from LV2
ports with aparam:designation, or else from its first continuous
parameters, macros first (Dexed, YANES, Vitalium). The knobs drive the real
parameters, are MIDI-learnable, follow the plugin's value (a loaded patch
moves and renames them), and LV2 ones are saved with the session. The
agent'slist_paramsreturns the same list asmain_controlsahead of the
full parameter list, and a control's name binds with
set_cc_map knob=<name>.kabelsalat main-controls-testprints each
installed instrument's main controls and moves one through the engine. -
Settings view (
,/ top barSettings): added a main-stage Settings view
for configuring per-role agent models (agent_decide_modelwith On/Off switch,
agent_act_model,agent_perceive_model) via themed dropdowns or custom model
IDs with effective route and key status, saving/removing DeepSeek and
OpenRouter API keys (masked, restarting the assistant worker immediately),
and editing preferences (ui_reduce_motion, count-in on/bars, audio output,
plus read-only detected UI scale). -
Packages for every release, on x86_64 and aarch64: a Flatpak bundle
(io.github.ssalentin.kabelsalat), an AppImage, a plain.tar.gzand an
Arch package, built by GitHub Actions on eachvX.Y.Ztag and attached to
the release. Every push and pull request builds and runs the unit suite on
both architectures. Seedocs/PACKAGING.md. -
kabelsalat --versionandkabelsalat --help. -
Live agent run UI & rack animations: docked assistant panel sizes cleanly to show >= 3 transcript turns at minimum window height, replaces static
"thinking…"with an animated phase/route indicator (Jev · deciding,DeepSeek · step N,Gemini · looking at the image), renders tool action chips under user messages with rule-7 padding, outcome states (Running,Done,NotApplied,Failed), collapsing (+N more), and one-line run cost. Agent rack edits glide knobs visually (~200 ms, engine sound updated immediately), draw added cables in from source to destination, pulse touched unit highlights once and fade removed units/cables (all disabled whenui_reduce_motionistrueinconfig.json), and fix faint zero-alphaAGENTbadge boxes on untouched units. Extended--demo-agent(with--demo-agent-anim/Shift+F12replay) for full offline UI captures. -
Single-rig presets (#34): save one rig (units, cables, knobs, plugin
states, matrix routes, mix, name) as a named.ksalat-rigpreset in
~/kabelsalat-rig-presetsand load it later as a new rig or replacing an
existing rig, independent of whole sessions. Available from the Rigs strip
("Save rig" / "Load rig" and rig-chip context menu) and as agent/MCP tools
save_rig,load_rig, andlist_rig_presets. -
Jev decides first: the in-app agent asks TypeSafe's Jev decisions model
(~typesafe/jev-latest, OpenRouter's decisions API) about every request.
A single clear action (tempo, a rig's...
kabelsalat 0.1.0
The first tagged release: a working live rack for Linux.
Added
- Rack with animated patch cables; Tab flips between the front (play)
and the back (patch). Every unit shares one face layout. - Multiple rigs that all sound at once, each with its own MIDI source and
device; + Rig adds a playable rig, also with any installed CLAP instrument. - MIDI matrix with per-cell rules (channel, transpose, key/velocity range)
and keyboard splits; held notes are always released when routing changes. - Mixer per rig (volume, pan, mute, solo) with post-fader rig meters.
- Software keyboard and assistant as bottom panels; the top bar
separates the main view (Rack, Sessions, Plugins, Matrix, Mixer) from them. - Plugin hosting: CLAP (Surge XT, Dexed, YANES, …) and LV2 (e.g. Vitalium)
with native in-app editors, sound browsers and presets; units show the
loaded instrument and patch. - Per-knob MIDI learn: right-click a knob, move a controller knob, bound.
- Recording of the master output to WAV, with the last take playable from
the top bar; transport, metronome, count-in and tap tempo. - Built-in assistant (DeepSeek, bring your own key) and an MCP server
(kabelsalat mcp,--attachto drive the running app); agent changes are
highlighted in the rack and undoable one job at a time (Ctrl+Z). - Sessions and starter templates; system-audio capture and WAV backing tracks.
- Arch/Omarchy packaging (
packaging/PKGBUILD).
Download
Recommended: the AppImage. Download the one for your machine, chmod +x it and run it. It finds your installed CLAP/LV2 plugins and gets realtime audio priority. AppImageUpdate or Gear Lever update it in place.
- x86_64: kabelsalat-x86_64.AppImage
- aarch64: kabelsalat-aarch64.AppImage
Other packages (limits in docs/PACKAGING.md):
Checksums: SHA256SUMS