Skip to content

Browse and listen to thousands of radio stations across the globe right from your terminal 🌎 📻 🎵✨

License

Notifications You must be signed in to change notification settings

tsirysndr/tunein-cli

Repository files navigation

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

🚀 Usage

USAGE:
    tunein <SUBCOMMAND>

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:

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