radiosh

A minimalist, lightning-fast terminal radio player written in pure Bash.

Features a searchable station database, favorite management, and Vim-style navigation.

Features

• Online Search — Instantly search thousands of stations via the Radio-Browser API
• Favorites — Save your favorite stations to a local M3U playlist
• Vim-Style Navigation — Use h, j, k, l to navigate menus (powered by fzf)
• Popularity Sorting — Online search results are automatically sorted by votes/popularity
• Easy Installation — Comes with a built-in installer for quick setup

Prerequisites

• fzf — Fuzzy finder for the interface
• mpv — The engine that plays the audio stream
• jq — To process API search results
• curl — To fetch station data

Installation

Clone the repository:

git clone https://github.com/woodz-dot/sh-radio.git
cd sh-radio

Make the script executable:

chmod +x radiosh

Run the built-in installer:

./radiosh --install

This will copy the script to ~/.local/bin/radiosh.

Update your PATH (if not already done):

Bash/Zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # or ~/.zshrc

Fish:

fish_add_path ~/.local/bin

Usage

Simply type radiosh in your terminal to start:

radiosh

• Select a saved favorite to play immediately
• Select __ONLINE_SEARCH__ to find new stations
• Press y after playing an online station to add it to your favorites

Configuration

Favorites are stored as a standard M3U playlist at:

~/.config/mpv/radio.m3u

License

MIT License — see LICENSE for details.