SELF-HOSTED · OPEN SOURCE
Run your own SUB/WAVE.
SUB/WAVE points at your Navidrome library and your LLM — a local Ollama box by default, or any hosted provider you prefer. Once it's running, the AI DJ broadcasts from your homelab, plays from your music collection, and answers requests from anyone with the URL.
WHAT'S INSIDE
Two ways to install, one way to hack.
Start at Prerequisites — SUB/WAVE talks to your existing services, so a couple of things need to be running first. Then pick whichever install path suits you. They land at the same place.
- Quick Start — The interactive wizard, or one sentence to your AI coding agent. Pick this if you just want it running.
- Manual Install — The same outcome, command by command. Pick this if you script your installs or want a non-standard layout.
- Development — Hacking on SUB/WAVE itself — the two compose files, hot reload, and the one rebuild gotcha.
HOW LONG IT TAKES
About ten minutes.
If you already have Navidrome and an LLM running, the wizard gets you on the air in roughly ten minutes — most of it spent answering a handful of prompts and waiting on the first Docker build. The bulk of the work is the things SUB/WAVE depends on but doesn't ship, which is exactly what the next page covers.
Just want to listen to a station, not run one? The manual covers tuning in and making requests.