curseradio-improved 0.3.8

An improved Curses interface for listening to internet radio.

Curseradio-Improved

Overview

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.

Installation

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

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

License

curseradio-improved is MIT-licensed (see LICENSE.md).