Skip to main content

An interface for mplayer aimed at listening to streaming radio.

Project description

Command-line frontend for mplayer designed to make listening to online radio easy.



  • Allows you to easily play your favorite online radio stations.

  • Adding new stations to is very simple.

  • Record radio streams.

  • Sleep and Wake-Up features.

  • Search TuneIn for new stations.


To install, use pip:

pip install radiopy

The latest development version is available via git from SourceForge:

pip install git+

See the pip documentation for more details.


usage: [OPTIONS] station_name

positional arguments:
  station_name          Station name

optional arguments:
  -h, --help            show this help message and exit
  -s MIN, --sleep MIN   go to sleep after MIN minutes
  -w MIN, --wake-up MIN
                        wake up and start playing after MIN minutes
  -l, --list            show a list of known radio stations and their homepage
  -c SIZE, --cache SIZE
                        set the size of the cache in KBytes [default: 320]
  -r FILE, --record FILE
                        record the stream as mp3 and save it to FILE
  --random              let select a random station for you
  -v, --verbose         Verbose mode. Multiple -v options increase the
  -q, --quiet           Quiet mode. Multiple -q options decrease the
  --version             show program's version number and exit


To listen to a station just pass it’s name to BBC World Service

The list of supported can be viewed using --list flag. Additionally, will search TuneIn when given an unkown station.

Wakeup and Sleep

You can use the --wake-up and --sleep to make start to play after specified number of minutes and shut itself down after specified number of minutes accordingly: --wake-up 30 BBC World Service --sleep 60 BBC World Service

Recording also supports recording streams to file: --record news BBC World Service

This dumps the raw stream to a file named news. The exact version of the file depends on the exact stream. The dumped stream using can be played using mplayer. You can later use avconv (or ffmpeg) to converted the dumped stream to any format that suits you.

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

Files comes with a builtin list of stations. If you want to add new stations (or override existing ones) you can add them to /etc/radiopy (global configuration) or to ~/.radiopy (per-user). The format is:

[BBC World Service News]


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

radiopy-0.6.tar.gz (18.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page