#radio #tokio #command-line-interface #api #web #tunein

bin+lib tunein-cli

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

10 releases

0.2.6 Mar 19, 2024
0.2.5 Mar 1, 2024
0.2.1 Feb 29, 2024
0.1.3 Mar 14, 2023
0.1.1 Feb 24, 2023

#1967 in Command line utilities

Download history 1/week @ 2024-02-20 591/week @ 2024-02-27 46/week @ 2024-03-05 8/week @ 2024-03-12 169/week @ 2024-03-19 1/week @ 2024-03-26 44/week @ 2024-04-02 62/week @ 2024-04-16

495 downloads per month

MIT license

2MB
9K SLoC

TypeScript 6K SLoC // 0.3% comments Rust 3K SLoC // 0.0% comments Shell 57 SLoC // 0.2% comments

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:

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

Dependencies

~39–75MB
~1.5M SLoC