halpradio
Terminal internet radio streamer with keyboard-driven UI and 30,000+ stations.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- Runtimes:
Go 1.21+ - Needs the network
brew install halpworld/tap/halpradio
brew install halpworld/tap/halpradio
Check that it works
halpradio current 2>&1The output should contain “halpradio is not currently running”.
First thing to try
halpradio current 2>&1Run halpradio in a terminal to open the keyboard-driven radio player.
Linux x86_64
You need first
- Runtimes:
Go 1.21+ - Needs the network
Download install script for reading
curl -fsSL https://raw.githubusercontent.com/halpworld/halpradio/main/install.sh -o /tmp/install.shRun install script to install halpradio
bash /tmp/install.sh
Check that it works
halpradio --versionThe output should contain “halpradio v0.8.1”.
First thing to try
halpradio currentRun halpradio in a terminal to open the keyboard-driven radio player.
What it does
- Stream internet radio in the terminalNot tested
- Search more than 30,000 online stationsNot tested
- Watch animal DJ visualizers that react to the beatNot tested
- See live song info from the station streamNot shown working
How far pickfit got
macOS arm64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Other systems
Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- play and pause selected radio station
- search 30,000+ online stations
- identify playing track via acoustic fingerprinting
- view live synced lyrics in terminal
- query current station from scripts and status bars
An alternative to PyRadio, Curseradio, radio-active and mocp / cmus.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.8.1
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version v0.8.1
Differences the test machine hit
- README: installs it to /usr/local/bin
In the test: script fell back to /home/sbx/.local/bin because /usr/local/bin not writable without sudo - README: halpradio current outputs 'SomaFM Groove Salad: Tycho - A Walk'
In the test: halpradio current, current --json and remote status exit 1 with 'not currently running' message when no daemon is running