terminal receiver for public radio

RadioCLI_

Explore live public stations around the world, tune real streams through local playback backends, and keep your radio library close to the command line.

$brew install ciphore/tap/radiocli && radiocli

RadioCLI full-screen Now Playing receiver
ProvidersRadio Browser primary, Radio Garden optional, playlist imports treated as first-class stations.
Playbackmpv first for IPC controls, ffplay fallback for playback-only recovery.
ControlsAdaptive footer, command palette, learned media keys, previous/next source-list queues.
PrivacyNo account, no proxy, no secrets. Nearby discovery is opt-in and approximate.

~/radiocli · one site for the product and the manual

Tune the whole world from a prompt.

The public surface is organized around what a listener or contributor actually needs: quick setup, command usage, TUI controls, architecture, reliability, privacy, release notes, and release scope.

World radio, no browser

Explore countries, search stations, tune nearby streams, and keep the whole loop inside a fast Ink terminal UI.

Built for flaky streams

Mirror fallback, stale-cache fallback, tune timeouts, backend readiness checks, and skip-broken-stream behavior are first-class paths.

A receiver, not a wrapper

Now Playing has 50 signal-gated receiver styles, stream diagnostics, ICY metadata cleanup, mpv-backed controls, favorites, and a sleep timer.

Local-first library

Recents, favorites, imports, provider cache, settings, learned media keys, and listening sessions stay on your machine.

CLI and TUI parity

Use the full-screen receiver or command mode for search, country lists, playlist import/export, checks, and direct stream adds.

Docs beside the product

Install, controls, architecture, reliability, privacy, release notes, and release scope all live in this one site.

Ready to start tuning?

Install mpv, grab the CLI, and run the doctor check.

Get started →