Subwave
Subwave is a self-hosted, AI-powered personal internet radio station that streams one shared live broadcast from your Navidrome or Subsonic library, with an…
Platform availability
Available on 2 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Other devices
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
68/100 Good
- Maintained
- 100last commit 5 days ago
- Popular
- 641,665 GitHub stars
- Easy to install
- 553 install platforms, install notes, Docker image
- Light to run
- No data
- Security check
- 201 serious finding, 19 minor, CI, tests
Based on 4 of 5 factors.
Security check: 1 serious finding
- Uses dompurify 3.4.16, which has a known critical vulnerability (npm)
Automated checks on commit 3eddf63, 25 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 18 days ago
- GitHub stars
- 1,665
- Open issues
- 87
- Last commit
- 2026-11-16
- Latest release
- v1.32.0
- License
- MIT
- Activity
- steady
Checked 4 days ago - source: GitHub (perminder-klair/subwave)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Onboarding After deploying, open the WebUI and navigate to /onboarding. Sign in with your admin credentials, point the app at your Navidrome (Subsonic) server, select an LLM provider and a voice, and set the DJ's personality. A built-in Piper voice is included for immediate use. On CPU-only hosts, install the official Ollama container, run 'ollama signin' in its console, and select a model. source
- Deployment The all-in-one container bundles Icecast, Liquidsoap, the DJ controller, a web player, and a Caddy reverse proxy on one port, storing settings, library cache, and recordings under the Appdata path. Use the built-in Piper voice immediately, or pair with Ollama for richer CPU-only language models. source
- DJ Brain If you prefer not to run your own language model, the official DJ Brain service provides a metered hosted model and optional cloud voice for your station. source
Fetched 5 days ago - each note links to its source
Variants
Alternatives (1)
Checked 27 days ago - source: AlternativeTo
Common questions
Do I need to run a separate reverse proxy in front of the web player?
The all-in-one build includes a Caddy front-end. Icecast, Liquidsoap, the DJ controller, and the web player run in one container on one port.
Where should I point backups for settings and recorded audio?
Your settings, library cache, and recordings live under the Appdata path.
Does the AI DJ require a hosted language model?
It uses a language model, with a local Ollama box as the default. You can also use any hosted provider you choose.
Do I need to install a separate TTS voice before the DJ can talk?
No, the built-in Piper voice can talk straight away with nothing else to install.
Answers sourced from github.com, www.getsubwave.com
Community
- Personal internet radio: Agentic AI DJ (forum)
- SUB/WAVE community on discord.gg (discord)
- SUB/WAVE community on reddit.com (reddit)
- Subwave - High Hopes : r/DnB - Reddit (reddit)
- Trying Out Subwave for the First Time (forum)
- Reddit (reddit)
Collected 27 days ago - public community threads