Skip to main content

Just listen to the radio.

Project description

radio is a python script to just listen to the radio [*].

[*]Requires mplayer, ffplayer (ffmpeg package) or cvlc (vlc package). Priority or alternative players yet to make customizable in future versions.


Run in terminal (with superuser privilegies):

$ pip install radio



Show some help:

$ radio -h
$ radio --help

List radios

List available radios:

$ radio -l          # List available radios
$ radio --list-all  # List radios and url

Play radios

Listen to the radio:

$ radio <radio_id>

where <radio_id> must be in the radio list as shown above.

Turn off the radio by pressing “q” (if using mplayer) or with Ctrl-<C> (if using ffplay or cvlc).

Add/update radios

Add/update radios (with superuser privileges):

$ radio --add <radio_id> <radio_name> <radio_url>

For example:

$ radio --add madre "Radio Madre AM 530"

Remove radios

Remove radios (with superuser privileges):

$ radio --remove <radio_id>

For example:

$ radio --remove mitre


Show version:

$ radio -v
$ radio --version

To do

  • support multiples lists
  • support searching / filtering lists (something like radio -s Rosario to search radios from Rosario)
  • customize player and priorities or autodetect (something like rifle in the ranger package)
  • what more?
  • help me at




radio is licensed under the do What The Fuck you want to Public License, WTFPL. See the LICENSE file.

Project details

Download files

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

Files for radio, version 0.0.11
Filename, size File type Python version Upload date Hashes
Filename, size radio-0.0.11.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page