Technical information Filenames, Directories, Dependencies
Dependencies

Python 2.7 or 3.x

PyGtk or PyGI

Gtk2 or Gtk3

Requests/urllib3

PIL/Pillow

Soft dependencies

Python-LXML

Python-PyQuery

Audacious/VLC or any other player

Streamripper or fIcy

youtube-dl

fonts: Symbola/Unifont for some UI parts

Configuration files <file>/home/$USER/.config/streamtuner2/</file>

Corresponds to the XDG_CONFIG_HOME setting. All ST2 configuration settings are contained within here and are in JSON format.

<file>/home/$USER/.cache/streamtuner2/</file>

Set from XDG_CACHE_HOME environment variable. Contains the channel cache/ and icons/. Symlinks in .config remain for convenience.

<file>~/.config/streamtuner2/settings.json</file>

General runtime options, plugin settings, and configured audio players.

<file>~/.config/streamtuner2/window.json</file>

Saved window sizes, list widths.

<file>~/.config/streamtuner2/state.json</file>

Last category in each channel tab.

<file>~/.config/streamtuner2/bookmarks.json</file>

Is a separate cache file for your bookmarked/favourite radio stations.

<file>~/.cache/streamtuner2/cache/***.json</file>

Channel cache, with station/stream lists in JSON files.

<file>~/.cache/streamtuner2/icons/*.png</file>

Holds downloaded favicons for station homepages.

<file>~/.config/streamtuner2/plugins/*.py</file>

Contain downloaded contrib/ plugins.

On Windows the ~/.config/ directory is called %APPDATA% instead. The paths in there are equally structured. On Linux ~/.cache/ is used to separate temporary from configuration data.

Installation spread <file>/usr/bin/streamtuner2</file>

Associates the main binary.

<file>/usr/share/streamtuner2/</file>

Contains the individual ST2 python modules, and plugins in channels/. Also packages in pyquery/, but which is only used if the according modules aren't installed by the distribution.

<file>/usr/share/doc/streamtuner2/</file>

Contains the README, and Mallard/gnome-help/yelp files under help/.

Public Domain

The majority of code distributed with ST2 is placed into the Public Domain; meaning no licensing requirement and all code can be copied, modified and distributed unrestrictively.

The bundled kronos.py and requests/ library are NOT however.