TuneIn CLI 📻 🎵 ✨

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

🚚 Installation

Compile from source, without Nix:

# Install dependencies
brew install protobuf # macOS
sudo apt-get install -y libasound2-dev protobuf-compiler libdbus-1-dev # 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

Ubuntu/Debian

echo "deb [trusted=yes] https://apt.fury.io/tsiry/ /" | sudo tee /etc/apt/sources.list.d/fury.list
sudo apt-get update
sudo apt-get install tunein-cli

Fedora

Add the following to /etc/yum.repos.d/fury.repo:

[fury]
name=Gemfury Private Repo
baseurl=https://yum.fury.io/tsiry/
enabled=1
gpgcheck=0

Then run:

dnf install tunein-cli

Arch Linux

Using paru:

paru -S tunein-cli-bin

Or download the latest release for your platform here.

📦 Downloads

• Mac: arm64: tunein_v0.4.1_aarch64-apple-darwin.tar.gz intel: tunein_v0.4.1_x86_64-apple-darwin.tar.gz
• Linux: tunein_v0.4.1_x86_64-unknown-linux-gnu.tar.gz

🚀 Usage

USAGE:
    tunein <SUBCOMMAND>
OPTIONS:
-h, --help                   Print help information
-p, --provider <provider>    The radio provider to use, can be 'tunein' or 'radiobrowser'.
Default is 'tunein' [default: tunein]
-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
server    Start the server
service   Manage systemd service for tunein-cli server

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

🧙 Systemd Service

Tunein daemon can be started as a systemd service. To enable and start the service, run the following command:

tunein service install

To disable and stop the service, run the following command:

tunein service uninstall

To check the status of the service, run the following command:

tunein service status

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