Terminal Radio (TERA)

Overview

Article

Tera is an interactive music radio player. Play your favorite radio station, CRUD your favorite lists, and explore new radio stations from your terminal. Tera stores favorite list in the ~/.config/tera/favorite directory and uses ~/.cache/tera directory to keep search related results.

Requirement

Unix-like environment.

• mpv is a free, open source, and cross-platform media player.
• jq is a lightweight and flexible command-line JSON processor.
• fzf is a general-purpose command-line fuzzy finder.
• gh is the GitHub CLI.
• wget: Most UNIX-like OS should have it. macOS can install with brew install wget.

Features

• 27780+ radio stations powered by Radio Browser API.
• MPV, a free, open source, and cross-platform media player.
• CRUD favorite lists.
• Play from a list
• Search radio station by tag, name, language, country code, state.
• Save a station to a list after playing.
• Delete a radio station from a list.
• I feel lucky menu.
• Gist upload.

Installation

Using Awesome package manager:

awesome install shinokada/tera

HomeBrew/LinuxBrew

brew tap shinokada/tera
brew install tera

Debian/Ubuntu

Download a Debian package from the releases page.

sudo apt install ./tera_0.4.1_all.deb
rm -rf ./tera_0.4.1_all.deb

After installation please run the following to check mpv is installed correctly.

mpv https://live.musopen.org:8085/streamvbr0

If it plays music you're ready to go.

Uninstallation

You can uninstall by using the uninstallation script or manually.

Uninstallation script

curl -s https://raw.githubusercontent.com/shinokada/tera/main/uninstall.sh > tmp1 && bash tmp1 && rm tmp1

Manual

Remove following directories.

• tera directory.
• ~/.config/tera/ directory
• ~/.cache/tera directory

Usage

Commands

Main Menu

tera

Player control

Keyboard	Description
p and SPACE	Toggle pause/unpause.
[ and ]	Descrease/increase speed by 10%.
{ and }	Halve/double current playback speed.
q	Stop playing and quit.
/ and *	Descrease/increase volume.
9 and 0	Descrease/increase volume.
m	Mute sound.

Search Menu

You can search by tag, name, language, country code, state, and advanced(todo).

Music player

• Pause: q or space.
• Forward: Right arrow.
• Backward: Left arrow.
• More MPV control

Options

-h | --help
--version

Reference

• Bash menu

Author

Shinichi Okada

License

Please see LICENSE.