Expand description
cpal-driven standalone host for truce-rack.
Loads a single plugin via the appropriate format wrapper,
opens the default cpal output device, and renders the plugin
into the device’s audio stream. Optionally also opens a
baseview window and embeds the plugin’s editor — see the gui
feature and the windowed module.
§Layout
run_clap/run_vst3/run_au/run_lv2— one entry point per format wrapper. Each is feature-gated.run_with_plugin— common cpal plumbing every headless entry point uses.list_plugins— scan every enabled format and print one line per discovered plugin (powers--list).
Modules§
- cli
- Shared command-line entry point for the standalone runner.
- device
- Audio output device + channel-routing selection for the standalone runner.
- midi
- Hardware MIDI input via midir.
- midi_
queue - Cross-thread MIDI queue.
- transport
- Host-side transport clock for the standalone runner.
Enums§
- Format
- Which format the CLI picked. Used by the dispatcher so a single
--name "Foo"flag can resolve against the right scanner. - Plugin
Selector - How the CLI identified the plugin it wants to load.
Idis an exact unique-id match (CLAP plugin id, VST3 CID hex, AU 4cc triplet).Nameis a case-insensitive substring against the plugin’s display name. - RunMode
- What the standalone runner wants to do once it has a stream
open: stay alive for
seconds, or block until a user sends SIGINT.
Constants§
- GUI_
AVAILABLE - Whether this build can open a plugin editor window — i.e. the
guifeature is compiled in.falseon Linux (baseview’s Linux backend is gated off) and on any--no-default-featuresbuild. Callers use it to decide whether--guican be the default.
Functions§
- list_
plugins - Scan every format compiled into this build and return a flat
list of
(format, info)pairs. Used by--listand by the screenshot bin’s per-plugin walk. - run_
clap - Open a CLAP plugin by id or name and run it.
- run_
with_ plugin - Open the default cpal output device and pump
plugininto it, running formode.