Skip to content

shinokada/tera

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


https://tera.codewithshin.com/

To Keep It Going, Please Show Your Love. ❤️

Buy Me a Coffee at ko-fi.com

Terminal Radio (TERA)

Overview

Article

Are you tired of being stuck in a musical rut with the same old songs being recommended to you on Amazon Prime Music or YouTube? Are you sick of the advertisements that come with streaming services like Spotify? If you’re looking for a new and exciting way to discover new music while you work, Tera (TErminal RAdio) is for you!

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

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

By selecting 2) Search radio stations, 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

@shinokada

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

Packages

No packages published

Languages