StreamTuner-ng

A modern, cross-platform internet-radio browser — a from-scratch port & reimagining of the much-loved StreamTuner2, rebuilt in PySide6 (Qt 6) with embedded libmpv audio.

Pick a directory, browse by genre, or search every source at once — click a station and it plays. Designed so a broken or slow directory can never take the whole app down.

Features

A dozen built-in directories, plus your own Favorites and a Local list of your streams. Everything is free to listen to with no account — except AudioAddict, whose free tier was discontinued, so it needs a paid subscriber listen key. Some services also sell subscriptions worth supporting if you love them:

Listener subscriptions in USD, as of June 2026 — web sign-up; mobile app-store prices run higher.

💛 Love a station? Support it. These services share their streams for free — if one becomes a favorite, subscribe or donate to keep it (and the artists) going. StreamTuner-ng plays the free streams; AudioAddict is subscriber-only — paste your listen key to play its networks ad-free here. For the full premium experience — skip, track rating, on-demand, mobile & car apps — use each service's own app.

• Global search — type to filter the loaded list instantly, press Enter to search a directory's whole catalog, or flip on All Sources to query every directory at once and merge the results.
• Favorites & history — star stations; CSV import/export to back them up or share.
• Twenty built-in themes + your own — Dark, Light, Dracula, Nord, Solarized (light & dark), Gruvbox (dark & light), Tokyo Night, Monokai Pro, Dark Pastels, Cyberpunk Neon, Ubuntu, xterm, plus retro Amber / Green / White phosphor, CGA, CRT, and Synthwave — or import/export a custom theme as JSON (see THEME-HOWTO.md). Options → Themes → Wallpaper offers a picker — a generated Synthwave grid, two Vaporwave backgrounds, or your own image on any theme, with a dim slider.
• Extensible — drop a .py channel into the plugins folder to add your own directory (see PLUGINS.md); a worked _example.py is provided. Plugins can even declare their own right-click options (e.g. a bitrate picker or a login-key field) with no UI code.
• Visualizers — a stereo VU meter or a scrolling spectrum in the player bar.
• Desktop integration — system tray (now-playing, play/pause, close-to-tray), desktop notifications, Discord Rich Presence, loudness normalization, and keyboard + media keys.
• Fast — station and genre lists are cached to disk, so relaunch is instant and it isn't re-downloading on every start.

Install

Release binary

Grab the latest from the Releases page.

• Windows — libmpv is bundled; just run the .exe.
• Linux — install libmpv first (sudo apt install libmpv2), then run the binary. On a plain X11 desktop you may also need sudo apt install libxcb-cursor0.

From source

python -m venv .venv && . .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python run.py

Audio needs libmpv: on Debian/Ubuntu sudo apt install libmpv2; on Windows put libmpv-2.dll next to run.py (or just use the release binary).

python run.py --selftest runs a headless self-check (airlock + live channels, no display required).

Make it yours

Why it's solid

The headline difference from the original is a crash-isolation airlock: every directory call runs behind a timeout and an exception guard, so a source that hangs, errors, or returns garbage is contained while the rest of the app keeps working. Add the disk cache and a headless self-test, and it stays responsive and predictable even when a radio directory is having a bad day.

Heritage & credits

StreamTuner-ng carries forward the idea of StreamTuner2 — browse internet-radio directories as pluggable "channels" — but it is a complete, ground-up rebuild in modern Python/Qt, not a copy of the original (GTK, Public Domain) code. Ported & reimagined by IronWolve. See NOTICE for license and attribution notes.

• Audio — libmpv (LGPL)
• UI — Qt 6 / PySide6 (LGPL)
• Stations — RadioBrowser, SomaFM, Shoutcast, TuneIn, and the other directories listed above — please support the ones you love (subscribe or donate)

Project code is licensed under Apache-2.0 — see LICENSE and NOTICE. Source: https://github.com/IronWolve/StreamTuner-ng