Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Curses based internet radio player
Python Makefile
branch: master

Merge pull request #24 from signalpillar/patch-1

Issue in `add station` functionality
latest commit e615f51792
@coderholic authored


Command line internet radio player.

Ben Dowling -


  • python 2.6+/3.2+
  • mplayer or vlc installed and in your path


The first thing is to make sure MPlayer and VLC are installed and are in the PATH. To check this, go in your favorite terminal and make sure thiese programs are launched when you type "mplayer" or "cvlc".

MacOSX tip: MPlayer is one of the available packages provided by Homebrew. But it is not the case of VLC. Nevertheless, pyradio will also work with the binary of the application VLC. You simply can add a symbolic link to the executable as follows (this link must of course be in your PATH):

ln -s /Applications/ cvlc

The second step is to install the python package:

pip install pyradio


$ pyradio -h

usage: [-h] [--stations STATIONS] [--random] [--add] [--list]

Console radio player

optional arguments:
-h, --help            show this help message and exit
--stations STATIONS, -s STATIONS
                        Path on stations csv file.
--random, -r          Start and play random station.
--add, -a             Add station to list.
--list, -l            List of added stations.
--debug, -d           Debug mode (pyradio.log created)
                      To be attached with any bug report.


Up/Down/PgUp/PgDown     Change station selection
Enter                   Play selected station
-/+                     Change volume
m                       Mute
r                       Select and play a random station
Space                   Stop/start playing selected station
Esc/q                   Quit
Something went wrong with that request. Please try again.