tsirysndr / tunein-cli

Browse and listen to thousands of radio stations across the globe right from your terminal 🌎 πŸ“» 🎡✨
MIT License
38 stars 2 forks source link
cli-app command-line command-line-tool icecast rust-lang tokio tunein webradio

Cover

TuneIn CLI πŸ“» 🎡 ✨

License: MIT

A command line interface for TuneIn Radio.
You can search for stations, play them, and see what's currently playing.

Made with VHS

🚚 Installation

Compile from source, without Nix:

# Install dependencies
brew install protobuf # macOS
sudo apt-get install -y libasound2-dev protobuf-compiler # Ubuntu/Debian
# Compile and install
git clone https://github.com/tsirysndr/tunein-cli
cd tunein-cli
cargo install --path .

With Nix:

git clone https://github.com/tsirysndr/tunein-cli
cd tunein-cli
nix develop --experimental-features "nix-command flakes"
cargo install --path .

macOS/Linux

Using Bash:

curl -fsSL https://cdn.jsdelivr.net/gh/tsirysndr/tunein-cli@ab6a1ab/install.sh | bash

Using Homebrew:

brew install tsirysndr/tap/tunein

Using Nix:

cachix use tsirysndr
nix profile install --experimental-features "nix-command flakes" github:tsirysndr/tunein-cli

Or download the latest release for your platform here.

πŸ“¦ Downloads

OPTIONS: -h, --help Print help information -V, --version Print version information

SUBCOMMANDS: browse Browse radio stations help Print this message or the help of the given subcommand(s) play Play a radio station search Search for a radio station


Search for a radio station:
```bash
tunein search "BBC Radio 1"

Result:

BBC Radio 1 | The best new music | id: s24939
BBC Radio 1Xtra | Remi Burgz | id: s20277

Play a radio station:

tunein play "alternativeradio.us"
# Or by station ID
tunein play s221580

API Documentation

https://buf.build/tsiry/tuneinserverapis/docs/main:tunein.v1alpha1

You can start the server locally by running:

tunein server

and then use Buf Studio to make requests to the server

πŸ“ License

MIT