What is it

A simple dialog-based internet radio tuner.


Listening to music shouldn't require a complex graphical user interface. Also, it is nice to be able to control what's beeing played from wherever on the house network. Finally, the members of my family are not inclined to tecnology, so a simple interface enables them to use it.


Uses mplayer for playing, alsamixer for setting volume, dialog for the interface. Reads station urls from files in a PATH (/etc/radio, $HOME/.radio).

Obtaining station files

To extract a station url you usually read the source of the html page serving the stream and seek for the EMBED tag. That tag would have a parameter looking like a filename. Append the filename to the baseurl and you should get a datafile containing the url of the stream. You can just drop that datafile under /etc/radio giving it a meaningful name for you.

Some collections you can find in the Download section, another one (probably mostly obsoleted by now) is in the packages themselves.


Copy the 'radio' script somewhere in your PATH. The 'stations' directory contains some station files you can copy to /etc/radio or $HOME/.radio. Note that lines starting with the hash char (#) are comments, and I use them to remember where did I get the stream url from, and how (in case stream stops working).

Limitations (TODO)