SUB/WAVE icon

SUB/WAVE

SUB/WAVE is a personal internet radio station with an LLM-driven DJ on one shared Icecast stream for live listening via apps, web, and stream links.

SUB/WAVE

What SUB/WAVE is

SUB/WAVE is a personal internet radio station built around one shared Icecast stream. Instead of giving each listener a private queue, it keeps everyone on the same live broadcast while an LLM-driven DJ selects tracks and speaks between them.

The product is aimed at people who want to run a station from their own music library and model/voice stack. The setup page says you can connect a Navidrome library and an LLM provider, then bring the station on air through the CLI or a manual Docker Compose path.

Core capabilities

Shared live stream

SUB/WAVE streams a single Icecast broadcast that every listener hears simultaneously. The interface is built around live radio behavior rather than a private on-demand queue.

LLM-assisted track selection

The DJ reads from a connected music library, then chooses what comes next with help from an LLM. The station uses metadata and acoustic analysis to map tracks by mood, energy, and similar attributes.

Generated on-air talk

The DJ speaks between songs with live intros, time checks, weather reads, station IDs, and other segments. These lines are written in the persona's voice and spoken aloud rather than pre-recorded.

Flexible model and setup options

Operators can choose from local or hosted models, including an OpenAI-compatible route, and can set daily token budgets for hosted usage. The setup page says the station can be connected to Navidrome and an LLM provider in about ten minutes.

Multi-device listening

SUB/WAVE includes native apps, a desktop player, a web player that installs as a PWA, keyboard shortcuts, and support for `.m3u` and `.pls` stream links. That makes it usable across phones, desktops, browsers, VLC, Sonos, and internet radios.

Operator customization tools

The station supports skins and themes, custom skills from `SKILL.md`, scheduled shows, guest co-hosts, and an operator console for status, logs, restarts, and updates.

Common ways to use SUB/WAVE

  • Run a personal radio station

    Connect your own Navidrome library, choose a model and voice engine, and let SUB/WAVE run a station that sounds like a live radio broadcast instead of a playlist app.

  • Program and manage a station format

    Use the operator console, scheduled shows, personas, and guest co-hosts to organize a station with different voices and time slots.

  • Tune in from many clients

    Listen through native mobile apps, a desktop player, the web player, or legacy stream URLs when you want the same broadcast on different devices.

  • Handle shared requests without breaking the stream

    Let listeners request a song, artist, or mood while keeping the current broadcast intact for everyone else.

  • Customize the on-air personality

    Add custom between-track segments with `SKILL.md`, or adjust models and voices to match a preferred tone or local deployment.

Pros and Cons

Pros

  • One shared stream keeps the listening experience synchronized for everyone.
  • The station combines music playback with generated spoken segments, not just automated track switching.
  • Setup can be done through a guided CLI path or a manual Docker Compose installation.
  • The model and voice layers are swappable, so operators can choose local or hosted options depending on their setup.
  • Support for native apps, desktop apps, web/PWA, and legacy stream URLs makes listening flexible.

Cons

  • It is built around a broadcast model, so listeners do not get individual queues or skip control.
  • Operators need external services such as a music library and an LLM provider; SUB/WAVE does not ship those services itself.
  • The source does not show full pricing details on the pages provided.

FAQ

Does SUB/WAVE act like a playlist app or a live radio station?

SUB/WAVE is designed around a single Icecast stream. Listeners tune in to the same broadcast at the same time, and there is no skip control for individual listeners.

How do you get a station running?

The setup guide says the fast path is to install the CLI, run `subwave init`, then `subwave setup`, which connects a Navidrome library and an LLM provider and brings the station on air. Manual install is also available with plain Docker Compose.

Can listeners request music?

According to the manual, listeners can request a song, artist, or mood. Requests do not jump the current track for one listener; they become part of the shared broadcast.

What can listeners use to tune in?

The manual says the player can be used in native iOS and Android apps, a desktop player for macOS, Windows, and Linux, the web player as a PWA, and legacy stream clients through `/listen.m3u` or `/listen.pls`.

How does the AI DJ work?

The manual and home page describe the DJ as an LLM-driven persona with selectable voice engines. The station can use local or hosted models, and voices can come from local engines, cloud services, or a cloned reference clip.

Quick Facts

Category
Internet radio / AI audio
Primary users
People running a personal station and listeners tuning into a live broadcast
Core stream type
Single Icecast stream
Setup path
CLI installer or manual Docker Compose
Connected services
Navidrome and an LLM provider
Website
getsubwave.com