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…

  • AI
  • Media Applications
  • Media Servers
  • Network Services
  • Tools & Utilities
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 AI DJ selecting tracks and speaking station idents, time checks, weather, and song intros for homelabbers who want a shared radio experience rather than personal playlists.

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.

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

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

Collected 27 days ago - public community threads