iradio

A terminal internet radio player built with Rust. Streams stations from radio-browser.info and plays them via mpv.

Requirements

Rust / Cargo
mpv — must be installed and on PATH

Build & Run

cargo build --release
cargo run

Features

Browse stations from Germany, Austria, and the US
Live search (filters by name and tags)
Now-playing display with song history
Favorite stations — persisted to ~/.config/iradio/favorites.json

Keybindings

Normal mode

Key	Action
`j` / `↓`	Move down
`k` / `↑`	Move up
`Ctrl-D`	Scroll down half page
`Ctrl-U`	Scroll up half page
`Enter`	Play selected station
`s`	Stop playback
`f`	Toggle favorite on selection
`Tab`	Toggle All / Favorites view
`/`	Enter search mode
`Esc`	Clear active search filter
`q`	Quit

Search mode

Key	Action
typing	Filter station list live
`Enter`	Confirm filter, return to Normal
`Esc`	Clear filter, return to Normal

Layout

┌─────────────────────┬──────────────────────────────┐
│ Search  [/]         │ Info (now playing)            │
├─────────────────────┼──────────────────────────────┤
│                     │                              │
│  Stations [All]     │  Played Songs                │
│  ★ NDR 2            │  Song title...               │
│    SWR3             │  ...                         │
│    ...              │                              │
└─────────────────────┴──────────────────────────────┘

Favorites are marked with ★ in the station list. Press Tab to show only favorited stations (Stations [★ Fav]).