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
curseradio-improved # tests the success installation

You can also install curseradio-improved from source by cloning (or downloading the code from) this repository. Then type:

make # might prompt for `sudo' password
curseradio-improved # tests the success installation


Settings are parsed from a configs.json. Currently, colors and key bindings can be change to your liking. Additional settings like status bar display text, section separators and more will be configurable in the future. To find the location of the settings file of your installation, type:

echo "$(pip3 show curseradio-improved | grep -i 'location' | awk '{ print $2 }')/curseradio_improved/configs.json"

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 inbetween sections
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.

Source Distribution

curseradio-improved-0.3.8.tar.gz (7.8 kB view hashes)

Uploaded Source

Built Distribution

curseradio_improved-0.3.8-py3-none-any.whl (9.7 kB view hashes)

Uploaded Python 3

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