This project has been moved to https://gitlab.com/notrtdsx/clio

clio v0.1.1.1 - The Page Update

Command line radio for browsing and playing internet stations from your terminal. Powered by the Radio Browser API.

Tested on: Debian Testing, Arch Linux, EndeavourOS, Ubuntu 24.04.4 LTS and Termux

Features

• Lightweight Node.js CLI
• Interactive usage (no arguments)
• Stream playback via mpv

Requirements

• Windows, Linux (recommended), or macOS
• Node.js v25.8.1
• mpv installed and in your PATH

Install

npm install -g .

Run

clio

Usage

• Type a station name (example: soma fm)
• Or use tag:ambient to search by tag
• Enter a result number to play
• Type q to quit

Radio Browser API

Clio discovers a working API server at startup using all.api.radio-browser.info. The project uses the official endpoints and registers clicks when you play a station.

For legal reasons, Clio only fetches and uses stream URLs provided by radio-browser.info and does not host or redistribute any streams itself.