cliradio/README.md

cliradio

A command-line internet radio player script designed to work with mpg123 in Linux and Unix-like systems.

Installation

cliradio depends on the mpg123 utility to work. Install it, then download cliradio with the following command:

wget -o cliradio https://notabug.org/kzimmermann/cliradio/raw/master/cliradio

And run:

./cliradio

Or, alternatively, copy it to somewhere in your executable path:

sudo cp cliradio /usr/local/bin

And run it from any directory:

cliradio

Usage

The script looks for a .radiolist file located in the user's home directory. If you do not have one, a sample one will be created one based on the example file included in this repository. Add your own radios to the list by using the following syntax is:

# You can comment like this.
name>Description or name of the Radio
url>http://urlofradiostation.com/playlist.pls

Do notice that you must link directly to the .pls file.

The script is interactive, and will build a list of radio stations available for you to tune in. To stop streaming a radio, press Ctrl+C.

Radio stations

Pretty much any Radio Station streaming in mp3 will work, although I haven't tried a lot of them. I do know that Shoutcast and SomaFM stations work, though.

If you listen to other independent radio stations, please test cliradio with them and let me know! I would like to support them as much as I can!

Bugs, suggestions, and the like

Get in touch with me! I'd love to see this script ported to other shells and languages!