Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
| Command | Purpose |
|---|---|
render | Render a Bird file to WAV audio (offline, faster than real-time) |
info | Show project metadata (BPM, time sig, tracks, clips, returns, sends) |
validate | Parse, populate, and load a Bird file — reports errors at each stage |
help | Show usage |
version | Print version |
# Render a bird file to WAV (default: 44100 Hz, 32-bit float, stereo)
songbird render song.bird -o song.wav
# Render with custom settings
songbird render song.bird -o hq.wav -r 96000 -b 24 --normalize
# Render with tail time for reverb/delay decay
songbird render song.bird -o song.wav --tail 3.0
# Render with silence trimming
songbird render song.bird -o song.wav --trim-silence
# Show project info
songbird info song.bird
# Validate a bird file (parse + populate + engine load)
songbird validate song.bird
# Pipe from stdin
cat song.bird | songbird render - -o out.wav
| Flag | Default | Description |
|---|---|---|
-o, --output | (required) | Output WAV file path |
-r, --sample-rate | 44100 | Sample rate in Hz |
-b, --bit-depth | 32 | Bit depth: 16, 24, or 32 |
-s, --block-size | 1024 | Processing block size |
-t, --tail | 2.0 | Tail time in seconds for reverb/delay decay |
--normalize | off | Normalize output to target dBFS |
--normalize-target | -1.0 | Normalization target in dBFS |
--trim-silence | off | Trim leading/trailing silence |
--silence-threshold | 0.001 | Silence threshold (linear amplitude) |
-q, --quiet | off | Suppress progress output |
Bird source text
→ songbird_project::loader::parse_bird_into_state() — tokenize + parse + state
→ songbird_session::build_session_from_project() — build AudioGraph + EngineSession
→ songbird_export::bird_render::render_bird_to_wav() — offline render to WAV
songbird-project — Bird load path (parser + state builder)songbird-session — engine session constructionsongbird-export — Offline WAV renderingcargo test -p songbird-cli