// the find
deep5050/radio-active
Play any radios around the globe right from the terminal :zap:
A terminal radio player that pulls from the radio-browser.info API to let you search and stream 40K+ stations, record them via FFmpeg, and manage favorites. It's a polished single-user CLI tool, not a library — the target is anyone who wants background music without leaving the terminal.
The Vim-style command bar with tab completion and fuzzy search against favorites/history is genuinely well thought out — most CLI players make you restart to switch stations. Scheduled recording with countdown is a nice touch that few comparable tools bother with. The filter syntax (`--filter "country!=CA&votes>500"`) is expressive for a CLI flag. Feature flags in a flat config file make it easy to strip out the parts you don't want without touching code.
587 stars after what looks like several years of active development suggests it never broke out of a niche — PyRadio has more mindshare and is in distro repos; this isn't. FFmpeg is listed as a dependency for recording but the README buries the fact that ffplay (part of FFmpeg) is also required just to play anything, so 'pip install' alone gets you a broken install on a fresh machine. The test suite is thin — four test files covering a handful of edge cases, nothing touching the player backends or the radio-browser API layer. Windows support is mentioned but clearly an afterthought: the README points users to a third-party wikihow article for FFmpeg setup.