Skip to main content

A little radio player

Project description


A simple radio player implemented in Python3.

The currently supported radio stations are:

  • ByteFM
  • Deutschlandfunk Nova
  • DeltaRadio
  • FIP
  • FIP Autour du Groove
  • FIP Autour du Jazz
  • FIP Autour du Monde
  • FIP Autour du Rock
  • FIP Electro
  • FIP Reggae
  • FIP Tout Nouveau
  • France Musique
  • France Musique B.O
  • France Musique Classique Easy
  • France Musique Classique Plus
  • France Musique Concerts
  • France Musique Contemporaine
  • France Musique Jazz
  • France Musique du Monde
  • FranceInter
  • KCSM
  • LeMouv
  • Radio Helsinki
  • RockFM
  • TripleJ


  • python3
  • python3-gbulb
  • python-aiohttp
  • python-gi
  • gstreamer
  • gst-plugins-base
  • gst-plugins-good
  • python-bs4 (BeautifulSoup4)
  • python-chardet

Optional dependencies:

  • python-lirc
  • python-gntp
  • pygtk (for the graphical user interface)
  • aiohttp_jinja2 and jinja2 for the web remote templates
  • pyobjc (for macOS desktop notifications support)


  • notifications of song with libnotify or via python-gntp over the network to a Growl daemon
  • scrobbling to lastfm (and/or librefm)
  • optionally dump the stream to local files
  • multimedia keys support (stop, playpause)
  • headless mode, when dbus and/or X11 is not available
  • limited support for Denon AVR amps, power off/on from remote control
  • optional Web remote running on HTTP port 5000.
  • optional GTK+ user interface

Dependencies installation

On Linux

# apt install gstreamer1.0-plugins-{base,good,bad} libsoup2.4-1 python3-pip gir1.2-gst-plugins-base-1.0 gir1.2-gtk-3.0
# apt install liblirc-dev
$ pip3 install --user .
$ pip3 install --user requirements_linux.txt
$ xdg-user-dirs-update

On macOS

Some of the dependencies can be installed with Homebrew:

$ brew install python3 gobject-introspection libsoup gtk+3 gstreamer gst-plugins-{base,good,bad} gst-python

And the remaining Python packages using pip, optionally inside a dedicated virtualenv:

$ pip3 install -r .
$ pip3 install -r requirements_macOS.txt

Running the app

To run without installing, from the project root directory:

$ python3 -m cocoricofm [options]

To install:

  • Use to get your password hashes for

  • Copy cocoricofm.cfg.sample to ~/.config/cocoricofm.cfg and edit accordingly

  • Run either one of these commands:

    $ sudo python3 develop
    $ sudo python3 install
  • A cocoricofm executable script should now be available in your $PATH.

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 cocoricofm, version 1.4
Filename, size & hash File type Python version Upload date
cocoricofm-1.4.tar.gz (940.7 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page