curseradio-improved is a web radio with an intuitive terminal-based user interface and vi-like key-bindings. Customizations can be done via a configuration file in json format.
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 installation successYou 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 installation successSettings 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"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 LICENSE.md).