openYourRadio

showcase

mpv (Windows, macOS, Linux)
VLC Media Player (Windows, macOS, Linux)
Windows Media Player (Legacy) (Windows)
QuickTime Player (macOS)
web browsers are only used as a fallback method in case none of the following can be opened.

      npm install -g openyourradio
      radio -V
      > 1.0.0

you're good to go!

      git clone https://github.com/Lolo280374/openyourradio.git
      cd openyourradio
      npm install
      npm init
      radio -V
      > 1.0.0

you're good to go! you can now get editing, or anything else you wanted to do from source!

i'm aware this might look overwhelming!! make sure to check the GitHub for more better layed-out information

radio search <query> : search for a specific radio on the API. Returns the 5 most accurate results.
radio play <query/ID/random> [--genre, --country, --player] : play a specific radio, either by query, ID being the # from the search list, or 'random' for a random radio from the API. You may also specify --genre (e.g., "j-pop") and/or --country (e.g., "France") to filter randomized results. You can also force a specific player using --player "x". See compatible players above.
radio stop : stops the current playback and closes the player (useful if using mpv, which is headless).

radio fav add <query/ID> : adds a station to your favorites list. Query = search term (e.g., BBC RADIO 1), ID = # from the last search list.
radio fav delete <name/ID> : deletes a station from your favorites list. Name = exact radio name, ID = # from your favorites list.
radio fav list : lists all your favorited stations.
radio fav play <name/ID/random> [--player vlc] : play a station from your favorites by name, ID, or randomly. Optionally force a specific player using --player.
radio fav export : opens the favorites file JSON in your system default editor (Notepad, TextEdit, or nano).

radio history [n] : display your playback history. n = number of entries to show (default 5).
radio list <genres/countries> : displays the list of genres or countries supported by the Radio Browser API.
radio help : show the help screen with a list of commands.

this tool doesn't collect analytics of any sort. all it does is fetch radio info and URLs from the Radio Browser API. check out their privacy statement for more information.