📻 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
• 🎤 Identify the playing track with one keypress — Shazam-style, no API key required
• 🎵 Now playing display with station metadata

Search and play

Themes

Favourites

Identify the playing track

Press i while a station is playing. rig taps the audio, fingerprints it locally in pure Go, and asks Shazam to identify it. Press o to open the track on shazam.com.

Installation

rig.fm requires mpv for audio playback. The install methods below pull it in automatically; otherwise install it with your system package manager.

Quick install (Linux and macOS)

curl -fsSL https://rig.fm/install.sh | sh

Detects your OS and architecture, downloads the matching binary from GitHub Releases, verifies the checksum, and installs to /usr/local/bin.

Homebrew (macOS and Linux)

brew install mwhyte/tap/rig

Packages and binaries

Pre-built .deb, .rpm, .apk, and tarballs for Linux and macOS are on the releases page.

Build from source

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

Requires Go 1.25 or later.

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
i	Identify the playing track
o	Open identified track on shazam.com
?	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.