Skip to content

shinokada/tera

main
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 

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

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

start

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).

start

Music player

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

Options

-h | --help
--version

Reference

Author

Shinichi Okada

License

Please see LICENSE.

About

Interactive Bash script terminal music radio player. Play your favorite radio station, CRUD your favorite lists, and explore new radio stations from your terminal.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages