{"id":13587005,"url":"https://github.com/margual56/radio-cli","last_synced_at":"2025-03-01T04:26:20.395Z","repository":{"id":38419132,"uuid":"472036155","full_name":"margual56/radio-cli","owner":"margual56","description":"A simple radio CLI written in rust","archived":false,"fork":false,"pushed_at":"2024-01-14T19:32:17.000Z","size":119,"stargazers_count":114,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-18T06:42:27.116Z","etag":null,"topics":["cli","cli-app","mpv","multimedia","radio","radio-cli","rust","rust-lang"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/margual56.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},"funding":{"github":["margual56"],"ko_fi":"margual56"}},"created_at":"2022-03-20T16:25:35.000Z","updated_at":"2024-05-07T14:05:07.000Z","dependencies_parsed_at":"2024-01-02T15:47:53.103Z","dependency_job_id":"6fd967ed-cc87-40b2-a065-f30f43b0256f","html_url":"https://github.com/margual56/radio-cli","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/margual56%2Fradio-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/margual56%2Fradio-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/margual56%2Fradio-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/margual56%2Fradio-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/margual56","download_url":"https://codeload.github.com/margual56/radio-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241317008,"owners_count":19943192,"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","cli-app","mpv","multimedia","radio","radio-cli","rust","rust-lang"],"created_at":"2024-08-01T15:05:57.657Z","updated_at":"2025-03-01T04:26:20.378Z","avatar_url":"https://github.com/margual56.png","language":"Rust","funding_links":["https://github.com/sponsors/margual56","https://ko-fi.com/margual56"],"categories":["Rust"],"sub_categories":[],"readme":"![GitHub](https://img.shields.io/github/license/margual56/radio-cli) [![Rust](https://github.com/margual56/radio-cli/actions/workflows/rust.yml/badge.svg?branch=main)](https://github.com/margual56/radio-cli/actions/workflows/rust.yml)\n\n\n# radio-cli\nA simple radio CLI written in rust.\n\n**NEW**: Now it can search for any radio station! Just select the \"Other\" option to be prompted for the search.\n\n[![asciicast](https://asciinema.org/a/Kt0CP53YO0IWPyUs1p2S45zO7.svg)](https://asciinema.org/a/Kt0CP53YO0IWPyUs1p2S45zO7)\n\n### Warning! (**DEPENDENCIES**)\n- *Needed*: `mpv` is called to play the audio/video. (See the [How it works](https://github.com/margual56/radio-cli#how-it-works) section).\n- *Optional dependency*: To play youtube music you need to have `yt-dlp` or `youtube-dl` installed! \n\n## Contributing and code of conduct\nPlease, take a look at the [Contributing](https://github.com/margual56/radio-cli/blob/main/CONTRIBUTING.md) and [Code of Conduct](https://github.com/margual56/radio-cli/blob/main/CODE_OF_CONDUCT.md) guidelines\n\n## Usage\nTo use it, just type `radio-cli` after installing it and the program will guide you.\n\nWhen playing music, __you can use the mpv keybindings__ to control it (spacebar to play/pause, etc).\n\nYou can add a country to your config (optional) and search for any radio station!\n\n# Installation\n- On Arch (and derivatives such as Manjaro), you can just install it through [the AUR package](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=radio-cli-bin) called **radio-cli-bin**. If you have an AUR helper:\n```bash\n$ yay -S radio-cli-bin\n```\n_Note: radio-cli-git is now unsupported_\n\n- On other systems you can:\n   - Install it manually, without automatic update capabilities:\n      ```bash\n      git clone https://github.com/margual56/radio-cli.git radio-cli\n      cd radio-cli\n      cargo build --release\n      sudo cp \"./target/release/radio-cli\" \"/usr/bin/radio\"\n      mkdir -p \"${XDG_CONFIG_HOME}/radio-cli/\"\n      cp \"./config.json\" \"${XDG_CONFIG_HOME}/radio-cli/\"\n      ```\n   - Install it through cargo: `cargo install --git https://github.com/margual56/radio-cli`\n\n## How it works...\n...is very simple. The idea is to have a compilation of radio stations in [the config file](https://github.com/margual56/radio-cli/blob/main/config.json) and have a tool to be able to easily select one or the other.\n\nThe rest is thanks to the **wonderful** and **amazing** [mpv player](https://github.com/mpv-player/mpv). mpv is the one that does all the heavy-lifting and plays whatever you throw at it.\n\nLet's say this is just a cli frontend for playing things on mpv 😄, kinda like [ani-cli](https://github.com/pystardust/ani-cli) but without search functionalities and focused on radio stations.\n\nIf the station you want was not defined in the config, you will be able to search for it!\n\n## Configurability\nAs said before, this app is just a compilation of radios + a search prompt for online radios. It can be found in [the config file](https://github.com/margual56/radio-cli/blob/main/config.json) as a JSON, with a list of station names and their URLs.\n\n\nOf course you can add literally WHATEVER you want, even youtube videos (again, all thanks to mpv).\n\u003c/details\u003e\n\nOtherwise, you can just use the online search functionality.\n\n## Fork me!\nIf you (wrongfully xD) think mpv is not the best player, go ahead, fork me and change it :)\n\nThe license is GPLv2\n\n## Planned features \nDon't be surprised if these are not implemented in the end hehe (if there is no interest in the project, certainly not)\n\n- [x] ~Audio (mpv) controls when not in verbose mode~\n- [x] Loop to selection list when pressing `q` while playing\n- [x] ~Some kind of online updating of the list of stations~ _(kind of)_\n- [x] ~Code optimizations/beautification~\n- [x] ~Search international online radios~\n- Languages:\n  - [x] ~English~\n  - [ ] Spanish\n  - [ ] Others(?)\n- [x] ~An AUR installer~\n\n# Honorable mentions\n- A **BIG** thank you to the amazing developer/s of [Radio Browser](https://www.radio-browser.info/) and its wonderful [API](http://api.radio-browser.info/) and [rust library](https://crates.io/crates/radiobrowser). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmargual56%2Fradio-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmargual56%2Fradio-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmargual56%2Fradio-cli/lists"}