Home

Awesome

PyRadio

Command line internet radio player.

Pyradio

Table of Contents

<!-- vim-markdown-toc Marked --> <!-- vim-markdown-toc -->

Features

PyRadio provides the following features:

and much more...

Requirements

Linux users will have to install a resource opener package, a utility to open directories, html pages, etc. PyRadio will look for xdg-open, gio, mimeopen, mimeo or handlr, in that order of detection. If a different resource opener is used, one can declare it in the Configuration Window.

<!-- Changelog -->

Installation

The best way to install PyRadio is via a distribution package, if one exists (Arch Linux and derivatives can install any of these packages from the AUR, FreeBSD users will find it in the ports, etc.).

In any other case you will have to build it from source.

Note: Please avoid installing PyRadio via pip. I (user s-n-g @ github) am not the creator of this project, nor do I maintain it on The Python Package Index (PyPI). As a result, the version available there is outdated and I cannot provide any support for it.

Furthermore, please refrain from using any third-party packaging methods, such as Snap or AppImage. I am not affiliated with these services or projects, and I cannot guarantee the functionality or version of PyRadio provided through them. Additionally, I am unable to offer support for any issues related to these packaging methods.

In any of the above cases, if you do ask for help, I will ask you to install your distro package (or build PyRadio from source), before attempting to provide any further help.

Basic usage

After a successful installation, the command to execute is:

pyradio

This will display the program's window with a list of predefined radio stations ready to be played.

In case the list of predefined stations is not enough for you, you can press "O" (capital "o") to access RadioBrowser online directory; you will probably have to read this page to learn how to navigate the interface.

PyRadio comes with a number of themes; press "t" to get a list of themes, and

Finally, when you are ready to dive into the program's numerous features, you can refer to the detailed documentation.

Update notification

PyRadio will periodically (once every 10 days) check whether a new version has been released.

If so, a notification message will be displayed, informing the user about it and asking to proceed with updating the program (provided this is not a distribution package).

Note: Packages coming from a distribution repository will display no notification; it's up to the distro to update / uninstall PyRadio, as stated in Packaging PyRadio.

Reporting bugs

When a bug is found, please do report it by opening an issue at github, as already stated above.

In you report you should, at the very least, state your pyradio version, python version and method of installation (built from source, AUR, snap, whatever).

It would be really useful to include ~/pyradio.log in your report.

To create it, enter the following commands in a terminal:

$ rm ~/pyradio.log
$ pyradio -d

Then try to reproduce the bug and exit pyradio.

Finally, include the file produced in your report.

Packaging PyRadio

If you are a packager and would like to produce a package for your distribution please do follow this mini guide.

TODO

Acknowledgment

PyRadio uses code from the following projects:

  1. CJKwrap by Florent Gallaire - A library for wrapping and filling UTF-8 CJK text.

  2. ranger - A console file manager with VI key bindings.

  3. Vifm - A file manager with curses interface, which provides a Vi[m]-like environment.

Special thanks

  1. edunfelt, for her wonderful work on base16 themes, and ideas regarding theming and such.

  2. amano-kenji, for his valuable suggestions and bug reports.