Skip to main content

An improved Curses interface for listening to internet radio.

Project description


PyPI PyPI - Wheel


An internet radio in the terminal.

Curseradio-improved is an improved version of curseradio, a curses interface for browsing and playing an OPML directory of internet radio streams. It is designed to use the tunein directory found here, but could be adapted to others.

Audio playback uses mpv. Curseradio-improved requires python3 and the libraries requests, xdg and lxml.


Install the module from PyPI:

pip3 install curseradio-improved

You can also install curseradio-improved by downloading the source code (or cloning this repository) and typing:

make # might prompt for `sudo' password
make test # tests the success installation

Key Bindings

You can use the keys below to navigate and select things in the tui. vi-like keys should work intuitively.

Key(s) Command
or k, or j navigate
PgUp or p, PgDn or n navigate quickly
Home or g, End or G to top/bottom
Enter open/close folders, play stream
s stop playing stream
q quit
f toggle favourite


Curseradio-improved is MIT-licensed (see

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 curseradio-improved, version 0.3.2
Filename, size File type Python version Upload date Hashes
Filename, size curseradio_improved-0.3.2-py3-none-any.whl (8.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size curseradio-improved-0.3.2.tar.gz (6.7 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