truce-rack-standalone

Reference standalone host for the truce-rack audio plugin framework. cpal for the audio device, midir for hardware MIDI input, optional baseview window with the plugin's editor embedded as a child. Ships two binaries:

• truce-rack-standalone — load one plugin, render through the default output device. With --gui opens the plugin's editor; headless otherwise.
• truce-rack-screenshot — walk every installed plugin and capture its editor to a PNG (macOS only).

Quick start

# Scan everything every enabled format scanner can find.
cargo run --bin truce-rack-standalone --features "gui,vst3,au,au3,lv2" -- --list

# Load a plugin by name. With --gui, embeds its editor in a window;
# without --gui, runs headless until SIGINT (or --seconds N).
cargo run --bin truce-rack-standalone --features "gui,vst3,au" -- \
    --format vst3 --name "Surge XT" --gui

# Drive a tempo/grid-synced plugin with a synthesized transport.
cargo run --bin truce-rack-standalone --features "vst3" -- \
    --format vst3 --name "Surge XT" --tempo 140 --time-sig 7/8 --seconds 5

cargo run -q swallows piped stdout — if --list | head looks empty, build once and run the binary directly (cargo build --release --bin truce-rack-standalone --features … then target/release/truce-rack-standalone --list), or drop -q.

Default features are clap only; opt in to vst3, au, au3, lv2 as needed. The gui feature pulls baseview + the QWERTY keyboard MIDI handler. Linux gates gui off (baseview drags wayland-sys); the headless path works there.

Host transport

There's no DAW timeline behind the runner, so it synthesizes one and passes it to the plugin every block — each format wrapper maps it to its native transport (VST3 ProcessContext, CLAP clap_event_transport, LV2 time:Position, AU host callbacks). Control it with:

Companion crates

Per-format wrapper crates this binary dispatches to:

• truce-rack-core — traits + types
• truce-rack-clap — CLAP
• truce-rack-vst3 — VST3
• truce-rack-au — Audio Unit v2
• truce-rack-au3 — Audio Unit v3
• truce-rack-lv2 — LV2

License

MIT or Apache-2.0, at your option.