Guy Rutenberg

radio.py is a command-line frontend for mplayer designed to make listening to online radio easy.

Features

• Allows you to easily play your favorite online radio stations.
• Adding new stations to radio.py is very simple.
• Record radio streams as mp3.
• Sleep and Wake-Up features.

Download

radio.py-0.5.tar.bz2 is the latest stable version (Release Announcement).

To install it, just copy the radio.py file to anywhere in your $PATH.

Using radio.py

Invoking radio.py is just as easy as specifing the station name.

radio.py Classic FM

You can view the list of supported stations by adding the --list flag.

radio.py --list

This will show a nicely formatted list of the station along with their homepage, so you can easily learn what type of music (or shows) each broadcasts.

Other Options

When invoking radio.py you can use the --wake-up and --sleep to make radio.py start to play after specified number of minutes and shut itself down after specified number of minutes accordingly.

radio.py --wake-up 30 Radio Paradise
radio.py --sleep 60 Radio Tel Aviv

These options can also be used together and make radio.py some kind of radio alarm clock.

radio.py --wake-up 480 --sleep 10 Galgalatz

will play cause radio.py to start play for 10 minutes in 8 hours from now.

radio.py also supports recording streams to mp3 (via lame).

radio.py --record news.mp3 BBC World Service

This option can also be combined with the --sleep and --wake-up flags to time the recording.