Handbook
Welcome to the sonic-core handbook. This is the complete guide to integrating audio playback, synthesis, and device routing into your TypeScript applications.
What’s inside
Section titled “What’s inside”- Beginners — New to sonic-core? Start here for core concepts and first steps
- Getting Started — Clone, build, and run your first playback
- Architecture — Packages, protocol boundary, and event flow
- API Reference — Engine methods, MCP tools, and configuration
- Security — Threat model and security posture
What sonic-core is
Section titled “What sonic-core is”sonic-core is the TypeScript control plane for audio. It decides what to play, when to stop, how loud, and which device. The actual audio processing happens in sonic-runtime, a NativeAOT C# sidecar that sonic-core manages over a strict ndjson-stdio protocol.
What sonic-core is not
Section titled “What sonic-core is not”- Not a DAW or audio editor
- Not a streaming service or media player
- Not a standalone audio library — it requires sonic-runtime for real audio output
- Not a user-facing application (see Stillpoint for that)