📻 rig.fm

Internet radio in your terminal. Beautiful, fast, and keyboard-driven.

Website | Install | Features | Usage | Contributing | License

What is rig.fm?

rig.fm is a terminal radio player that lets you browse, search, and listen to thousands of internet radio stations without leaving the command line. Powered by the Radio Browser directory, it gives you access to stations from around the world, all wrapped in a beautiful TUI built with Bubble Tea.

No accounts. No ads. Just radio.

Features

• 🌍 Browse thousands of radio stations worldwide
• 🔍 Search by genre, country, language, or station name
• 🎨 Beautiful terminal UI with multiple themes
• ⌨️ Keyboard-driven interface for fast navigation
• ⭐ Save your favourite stations
• 🎵 Now playing display with station metadata

Search and play

Themes

Favourites

Installation

rig.fm requires mpv for audio playback. Homebrew installs it automatically. For other install methods, make sure mpv is available on your system.

Homebrew (macOS and Linux)

brew install mwhyte/tap/rig

Download binary

Grab the latest release for your platform from the releases page.

Go install

go install github.com/mrwhyte/rig/cmd/rig@latest

Requires Go 1.25 or later.

Build from source

git clone https://github.com/MWhyte/rig.git
cd rig
go build -o rig ./cmd/rig
./rig

Usage

rig

Keyboard controls

Key	Action
Tab	Switch between panels
Up/Down	Navigate station list
Enter	Play selected station
Space	Pause/Resume
+ / -	Volume up/down
s	Search stations
?	Help
q	Quit

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines on how to get started.

Sponsors

If you find rig.fm useful, consider sponsoring its development: github.com/sponsors/MWhyte

License

GNU Affero General Public License v3.0. See LICENSE for details.