to view the project showcases, please click on one of the two video avalaible (Windows/Linux), to view the video itself.

table of contents

• compatible players
• commands
• installation
  • with npm: Linux, macOS, Windows
  • install from source
• uninstall
• reporting issues
• privacy information
• license

compatible players

as of now, the following desktop players are supported: - mpv (Windows, macOS, Linux) - short: mpv - VLC media player (Windows, macOS, Linux) - short: vlc - Windows Media Player (Legacy) (Windows) - short: wmp - QuickTime Player (macOS) - short: quicktime => web browsers are also supported as a fallback method if no players are found/avalaible...

commands

here's a list of commands, organized by category:

playback

• radio search : 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 # when you're searching, or random being a random radio from the API. you may also specify --genre "e.g: j-pop", and/or --country "e.g: France" to better filter randomized results. you may also force a certain player using --player "x", see compatible players.
• radio stop : stops the current playback, and closes the player. (useful if you use mpv, for example, since it's headless).

favorites

• radio fav add <query/ID> : adds a station to your favorites list. query here equals a search (e.g: BBC RADIO 1), ID equals the # on the search list (e.g #4).
• radio fav delete <name/ID> : deletes a station from your favorites list. name here equals the name of the radio (e.g: BBC RADIO 1), ID equals to the # on your favorites list.
• radio fav list : lists all your favorited stations.
• radio fav play <name/ID/random> [--player vlc] : play stations from your favorites. you can either input the name of the favorite, the ID on the fav list, or random to get a random pick from your favorites list. you can also specify --player "x" to force a certain player, see compatible players.
• radio fav export : opens the favorites file's JSON in your system default editor (Notepad, TextEdit, or nano).

quality of life

• radio history [n] : display your playback history, [n] equals to the amount of favorites to show in the list.
• radio list <genres/countries> : displays the lists of genres and countries supported by the RadioBrowser API.
• radio help : show the help screen with the list of commands.

installation

npm: Linux, macOS, Windows

you can install this program by simply getting it from npm:

npm install -g openyourradio
radio -V

install from source

to install from source, you must start by making sure you have git, nodeJS, and npm installed. then, start by cloning the repository:

git clone https://github.com/Lolo280374/openyourradio.git
cd openyourradio

you may then install the dependencies, and link the package to your system:

npm install
npm link

once complete, you can run the following to make sure installation suceeded, and you can start editing 'index.js' to make modifs!

radio -V
1.0.0

uninstall

to uninstall, you can simply run the following:

npm uninstall openyourradio

reporting issues

this is a community project, and your help is very much appreciated! if you notice anything wrong during your usage of this software, please report it to the GitHub issues page!

privacy disclaimer

this tool dosen't collect analytics of any sort, nor makes outside connections to the Internet, apart from the Radio Browser API which is used to gather radio information, and stream URLs to redirect your player of choice. to visit their privacy statement, please visit their FAQ.

license

this project is licensed under the MIT License, which you may check here. if you have any questions about this project, please reach me at [email protected].