perminder-klair

Personal internet radio: Icecast + Liquidsoap + AI DJ

41
1
89% credibility
Found May 23, 2026 at 41 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

SUB/WAVE is an open-source personal internet radio station that creates a shared broadcast experience. Unlike playlists where everyone hears different things, SUB/WAVE streams one unified audio feed to all listeners simultaneously—just like traditional radio. The system uses an AI DJ that automatically selects tracks from your music library, writes natural introductions between songs, and responds to listener requests typed in plain language. The AI can mention the time, weather, and news headlines between tracks, creating a realistic radio feel. Listeners access the station through a web player that works on phones and computers, with the AI introducing requested songs before they play. The project is self-hosted and works with various AI providers, from local options to cloud services.

How It Works

1
📻 You dream of your own radio station

You've always wanted a place where friends gather around the same music at the same time, like tuning into a real broadcast.

2
You run the setup wizard

A friendly installer walks you through connecting your music library and choosing your AI DJ voice. Everything happens automatically.

3
🎵 Your station comes to life

The AI DJ starts playing music from your collection, introducing tracks in a natural radio voice between songs.

4
Listeners tune in from anywhere
🎤
They request a song

A listener types 'play something cozy' and the AI finds a matching track, introduces it naturally, and queues it up.

📱
They listen on the go

The player works like a real radio app—showing what's playing, with lock-screen controls and album art.

5
🤖 The AI DJ keeps things interesting

Between tracks, your AI host mentions the time, reads headlines, tells random facts, and adjusts the mood based on weather and time of day.

🌟 Your station has its own personality

You have a living broadcast that reflects your taste, talks like a real DJ, and brings people together around music.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 41 to 41 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is subwave?

Subwave is a personal internet radio station that runs entirely on your own hardware. It combines Icecast for streaming, Liquidsoap for audio mixing, and an AI DJ that picks tracks, writes spoken links, and reads station idents between songs. The system is built in TypeScript with a Node.js controller, a Next.js web interface for listeners and admins, and a terminal player for command-line operation. Listeners request songs in plain language, and the AI matches and queues them.

Why is it gaining traction?

The hook is the "radio, not a playlist" model. Everyone hears the same thing at the same time, with no skip button or per-listener shuffle. The AI DJ handles track selection, pacing, and spoken segments using text-to-speech, with multiple voice engines available including local options that need no API key. The LLM provider is swappable at runtime through the admin interface, supporting local Ollama setups or cloud providers like Anthropic and OpenAI.

Who should use this?

Homelab enthusiasts who want a self-hosted radio station with AI curation. Developers comfortable running Docker on a Linux box and configuring a Navidrome music library. Anyone who wants the shared-moment quality of live radio but with algorithmic DJing and listener requests. Not suitable for non-technical users or anyone unwilling to maintain their own infrastructure.

Verdict

Subwave is a well-architected personal project with solid documentation and a clear vision, but with only 41 stars it is early and unproven at scale. The 0.9% credibility score reflects its status as a single-maintainer personal project rather than a production-grade service. If you are technically capable and want a genuinely unique radio experience, it is worth exploring; just expect to do some hands-on maintenance.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.