Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shinokada/tera
Interactive Bash script terminal music radio player. Play your favorite radio station, CRUD your favorite lists, and explore new radio stations from your terminal.
https://github.com/shinokada/tera
bash-script cli github-cli radio shell-scripts
Last synced: 20 days ago
JSON representation
Interactive Bash script terminal music radio player. Play your favorite radio station, CRUD your favorite lists, and explore new radio stations from your terminal.
- Host: GitHub
- URL: https://github.com/shinokada/tera
- Owner: shinokada
- License: mit
- Created: 2021-07-02T23:11:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-19T05:23:14.000Z (7 months ago)
- Last Synced: 2024-10-17T12:23:46.581Z (about 1 month ago)
- Topics: bash-script, cli, github-cli, radio, shell-scripts
- Language: Shell
- Homepage: https://tera.codewithshin.com/
- Size: 4.85 MB
- Stars: 109
- Watchers: 8
- Forks: 5
- Open Issues: 7
-
Metadata Files:
- Readme: docs/README.md
- License: LICENSE
Awesome Lists containing this project
README
https://tera.codewithshin.com/
To Keep It Going, Please Show Your Love. ❤️
Terminal Radio (TERA)
## Overview
[Article](https://levelup.gitconnected.com/discover-rejuvenate-your-music-library-with-command-line-f3268db67bba)
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](https://mpv.io/) is a free, open source, and cross-platform media player.
- [jq](https://stedolan.github.io/jq/) is a lightweight and flexible command-line JSON processor.
- [fzf](https://github.com/junegunn/fzf) is a general-purpose command-line fuzzy finder.
- [gh](https://cli.github.com/) is the GitHub CLI.
- wget: Most UNIX-like OS should have it. macOS can install with `brew install wget`.
## Features
- 35000+ radio stations powered by [Radio Browser API](https://de1.api.radio-browser.info/).
- [MPV, a free, open source, and cross-platform media player](https://mpv.io/).
- 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](https://github.com/shinokada/awesome):
```sh
awesome install shinokada/tera
```
### HomeBrew/LinuxBrew
```sh
brew tap shinokada/tera
brew install tera
```
### Debian/Ubuntu
Download a Debian package from the [releases page](https://github.com/shinokada/tera/releases).
```sh
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.
```sh
mpv https://live.musopen.org:8085/streamvbr0
```
If it plays music you're ready to go.
### ArchLinux
Please see [aur.archlinux.org](https://aur.archlinux.org/packages/tera)
## Uninstallation
You can uninstall by using the uninstallation script or manually.
### Uninstallation script
```sh
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
```sh
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
By selecting 2) Search radio stations, 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](https://mpv.io/manual/master/)
### Options
```sh
-h | --help
--version
```
## Reference
- [Bash menu](https://devdojo.com/bobbyiliev/how-to-create-an-interactive-menu-in-bash)
## Author
@shinokada
## License
Please see LICENSE.