Skip to main content

songbird-headless

Headless WebSocket server — runs the Songbird audio engine as a pure backend service without a GUI. Serves the same protocol as the Tauri app, so the React UI (or any WebSocket client) can connect and control playback, mixing, and rendering remotely.

Architecture

Protocol

Text frames

JSON messages mirroring the Tauri IPC protocol:

Binary frames

Tag-based, little-endian encoding:

Modules

Dependencies

  • Internal: songbird-engine, songbird-plugins, songbird-state, songbird-export
  • Async: tokio (runtime), tokio-tungstenite (WebSocket), futures-util
  • Serialization: serde, serde_json

Usage

Status

Production-ready for basic WebSocket DAW control (transport, mixing, rendering). Plugin hosting (ffi_bridge.rs) and Ableton Link (link.rs) are infrastructure stubs — not yet functional.