{"id":21658431,"url":"https://github.com/tsirysndr/tunein-cli","last_synced_at":"2026-04-04T11:11:55.153Z","repository":{"id":78085717,"uuid":"604498992","full_name":"tsirysndr/tunein-cli","owner":"tsirysndr","description":"Browse and listen to thousands of radio stations across the globe right from your terminal 🌎 📻 🎵✨","archived":false,"fork":false,"pushed_at":"2024-03-28T15:37:37.000Z","size":3399,"stargazers_count":32,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-29T12:02:26.887Z","etag":null,"topics":["cli-app","command-line","command-line-tool","icecast","rust-lang","tokio","tunein","webradio"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tsirysndr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["tsirysndr"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":[]}},"created_at":"2023-02-21T07:27:16.000Z","updated_at":"2024-04-15T19:58:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"f16d4aff-1669-4e95-8264-e01cb38fe937","html_url":"https://github.com/tsirysndr/tunein-cli","commit_stats":{"total_commits":31,"total_committers":1,"mean_commits":31.0,"dds":0.0,"last_synced_commit":"3de2c1dcf312f8a2a9b65b6f1f4771f83a2baae5"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsirysndr%2Ftunein-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsirysndr%2Ftunein-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsirysndr%2Ftunein-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsirysndr%2Ftunein-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsirysndr","download_url":"https://codeload.github.com/tsirysndr/tunein-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248490289,"owners_count":21112721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli-app","command-line","command-line-tool","icecast","rust-lang","tokio","tunein","webradio"],"created_at":"2024-11-25T09:29:15.284Z","updated_at":"2026-04-04T11:11:55.105Z","avatar_url":"https://github.com/tsirysndr.png","language":"TypeScript","funding_links":["https://github.com/sponsors/tsirysndr"],"categories":["Applications","Rust"],"sub_categories":["Audio and Music"],"readme":"\n![Cover](./.github/assets/preview.png)\n\n# TuneIn CLI 📻 🎵 ✨\n\n\u003cp\u003e\n  \u003ca href=\"https://flakehub.com/flake/tsirysndr/tunein-cli\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https://flakehub.com/f/tsirysndr/tunein-cli/badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://crates.io/crates/tunein-cli\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/crates/v/tunein-cli.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://flakestry.dev/flake/github/tsirysndr/tunein-cli\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://flakestry.dev/api/badge/flake/github/tsirysndr/tunein-cli\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://crates.io/crates/tunein-cli\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/crates/dr/tunein-cli\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"#\"\u003e\n    \u003cimg alt=\"GitHub Downloads (all assets, all releases)\" src=\"https://img.shields.io/github/downloads/tsirysndr/tunein-cli/total\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"LICENSE\" target=\"./LICENSE\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-blue.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/tsirysndr/tunein-cli/actions/workflows/ci.yml\"\u003e\n    \u003cimg src=\"https://github.com/tsirysndr/tunein-cli/actions/workflows/ci.yml/badge.svg\"\n  \u003c/a\u003e\n\u003c/p\u003e\n\nA command line interface for [TuneIn Radio](https://tunein.com) / [Radio Browser](https://www.radio-browser.info/).\u003cbr /\u003e\nYou can search for stations, play them, and see what's currently playing.\n\n![Made with VHS](https://vhs.charm.sh/vhs-4UhZFFRvVAuaZnapZUlp6R.gif)\n\n## 🚚 Installation\n\nCompile from source, without Nix:\n\n```bash\n# Install dependencies\nbrew install protobuf # macOS\nsudo apt-get install -y libasound2-dev protobuf-compiler # Ubuntu/Debian\n# Compile and install\ngit clone https://github.com/tsirysndr/tunein-cli\ncd tunein-cli\ncargo install --path .\n```\n\nWith Nix:\n\n```bash\ngit clone https://github.com/tsirysndr/tunein-cli\ncd tunein-cli\nnix develop --experimental-features \"nix-command flakes\"\ncargo install --path .\n```\n\n### macOS/Linux\n\nUsing Bash:\n\n```bash\ncurl -fsSL https://cdn.jsdelivr.net/gh/tsirysndr/tunein-cli@ab6a1ab/install.sh | bash\n```\n\nUsing [Homebrew](https://brew.sh):\n\n```bash\nbrew install tsirysndr/tap/tunein\n```\n\nUsing [Nix](https://nixos.org/nix/):\n\n```bash\ncachix use tsirysndr\nnix profile install --experimental-features \"nix-command flakes\" github:tsirysndr/tunein-cli\n```\n\n### Ubuntu/Debian\n\n```bash\necho \"deb [trusted=yes] https://apt.fury.io/tsiry/ /\" | sudo tee /etc/apt/sources.list.d/fury.list\nsudo apt-get update\nsudo apt-get install tunein-cli\n```\n\n### Fedora\n\nAdd the following to `/etc/yum.repos.d/fury.repo`:\n\n```\n[fury]\nname=Gemfury Private Repo\nbaseurl=https://yum.fury.io/tsiry/\nenabled=1\ngpgcheck=0\n```\n\nThen run:\n```bash\ndnf install tunein-cli\n```\n\n### Arch Linux\nUsing [paru](https://github.com/Morganamilo/paru):\n\n```bash\nparu -S tunein-cli-bin\n```\n\nOr download the latest release for your platform [here](https://github.com/tsirysndr/tunein-cli/releases).\n\n## 📦 Downloads\n- `Mac`: arm64: [tunein_v0.3.1_aarch64-apple-darwin.tar.gz](https://github.com/tsirysndr/tunein-cli/releases/download/v0.3.1/tunein_v0.3.1_aarch64-apple-darwin.tar.gz) intel: [tunein_v0.3.1_x86_64-apple-darwin.tar.gz](https://github.com/tsirysndr/tunein-cli/releases/download/v0.3.1/tunein_v0.3.1_x86_64-apple-darwin.tar.gz)\n- `Linux`: [tunein_v0.3.1_x86_64-unknown-linux-gnu.tar.gz](https://github.com/tsirysndr/tunein-cli/releases/download/v0.3.1/tunein_v0.3.1_x86_64-unknown-linux-gnu.tar.gz)\n\n## 🚀 Usage\n```\nUSAGE:\n    tunein \u003cSUBCOMMAND\u003e\n\nOPTIONS:\n    -h, --help                   Print help information\n    -p, --provider \u003cprovider\u003e    The radio provider to use, can be 'tunein' or 'radiobrowser'.\n                                 Default is 'tunein' [default: tunein]\n    -V, --version                Print version information\n\nSUBCOMMANDS:\n    browse    Browse radio stations\n    help      Print this message or the help of the given subcommand(s)\n    play      Play a radio station\n    search    Search for a radio station\n    server    Start the server\n    service   Manage systemd service for tunein-cli server\n```\n\nSearch for a radio station:\n```bash\ntunein search \"BBC Radio 1\"\n```\nResult:\n```\nBBC Radio 1 | The best new music | id: s24939\nBBC Radio 1Xtra | Remi Burgz | id: s20277\n```\n\nPlay a radio station:\n```bash\ntunein play \"alternativeradio.us\"\n# Or by station ID\ntunein play s221580\n```\n\n## 🧙 Systemd Service\n\nTunein daemon can be started as a systemd service. To enable and start the service, run the following command:\n\n```bash\ntunein service install\n```\n\nTo disable and stop the service, run the following command:\n\n```bash\ntunein service uninstall\n```\n\nTo check the status of the service, run the following command:\n\n```bash\ntunein service status\n```\n\n\n## API Documentation\n[https://buf.build/tsiry/tuneinserverapis/docs/main:tunein.v1alpha1](https://buf.build/tsiry/tuneinserverapis/docs/main:tunein.v1alpha1)\n\nYou can start the server locally by running:\n```bash\ntunein server\n```\n\nand then use [Buf Studio](https://studio.buf.build/tsiry/tuneinserverapis?selectedProtocol=grpc-web\u0026target=http%3A%2F%2Flocalhost%3A8090) to make requests to the server\n\n\u003cimg src=\"./api.png\" /\u003e\n\n\n## 📝 License\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsirysndr%2Ftunein-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsirysndr%2Ftunein-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsirysndr%2Ftunein-cli/lists"}