Note: Still Alpha Status: SuperSonic is in active development. The API may continue to evolve, but the core synthesis engine is solid and ready for experimentation. Feedback and ideas are most welcome.
░█▀▀░█░█░█▀█░█▀▀░█▀▄░█▀▀░█▀█░█▀█░▀█▀░█▀▀
░▀▀█░█░█░█▀▀░█▀▀░█▀▄░▀▀█░█░█░█░█░░█░░█░░
░▀▀▀░▀▀▀░▀░░░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀░▀░▀▀▀░▀▀▀
Back in the late 90s James McCartney designed a series of live audio programming environments called SuperCollider. These were systems with both programming languages and audio runtimes carefully designed for live realtime modification at every level - from high sweeping programming language abstractions all the way down to the fine control of the low-level synthesis components of the audio chain.
One of the many gifts from this work is scsynth - the core synthesis engine James created for version 3 of SuperCollider. It was at this point when he formally separated the language from the synth engine.
This split made it possible to combine scsynth's powerful audio synthesis capabilities with any existing - or yet to exist - programming language.
This then led to a suite of powerful new live coding languages using scsynth for audio synthesis.
What if you didn't just bring your language to scsynth? What if you brought scsynth to your environment?
This is SuperSonic. All the synthesis power of scsynth - modified and augmented to run in your web browser.
SuperSonic is SuperCollider's powerful audio synthesis engine scsynth running in the browser as an AudioWorklet.
Highlights:
- AudioWorklet - runs in a dedicated high priority audio thread
- WebAssembly - scsynth's original C++ code compiled for the web
- OSC API - talk to the scsynth server through its native OSC API
- Zero Config via CDN - no installation necessary - works directly from CDNs such as unpkg.
- Optional SAB mode - can use a SharedArrayBuffer (SAB) for lower latency and reduced jitter with internal comms. Requires COOP/COEP headers to enable browsers to use the SAB
Try the live demo: sonic-pi.net/supersonic/demo.html
import { SuperSonic } from "https://unpkg.com/supersonic-scsynth@latest";For installation options see the Installation Guide. Once installed, head to the Quick Start to make your first sound.
- Installation - CDN, npm, self-hosting, browser requirements
- Quick Start - Boot and play your first synth
- API Reference - Methods, callbacks, and configuration
- scsynth Command Reference - OSC commands for controlling scsynth
- Metrics - Performance monitoring and debugging
- Building from Source - Compiling the WASM yourself
SuperSonic is brought to you by Sam Aaron. Please consider joining the community of supporters enabling Sam's work on creative coding projects like this, Sonic Pi and Tau5.
SuperSonic uses a tiered licensing model - see LICENSE for details.
| Package | License | Contains |
|---|---|---|
supersonic-scsynth |
MIT | Client API |
supersonic-scsynth-core |
GPL-3.0-or-later | WASM engine + workers |
supersonic-scsynth-synthdefs |
MIT | Synth definitions |
supersonic-scsynth-samples |
CC0 | Audio samples |
Based on SuperCollider by James McCartney and the SuperCollider community. This AudioWorklet port was inspired by Hanns Holger Rutz who started the first port of scsynth to WASM and Dennis Scheiba who continued this work. Thank you to everyone in the SuperCollider community!