<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="technical">
<info>
<link type="guide" xref="index#extra"/>
<desc>Filenames, Directories, Dependencies</desc>
</info>
<title>Technical information</title>
<section id="dependecies">
<terms>
<title>Dependencies</title>
<item><p>Python 2.7 or 3.x</p></item>
<item><p>PyGtk or PyGI</p></item>
<item><p>Gtk2 or Gtk3</p></item>
<item><p>Requests/urllib3</p></item>
</terms>
<terms>
<title>Soft dependencies</title>
<item><p>Python-LXML</p></item>
<item><p>Python-PyQuery</p></item>
<item><p>Python-Kronos</p></item>
<item><p>Audacious</p></item>
</terms>
</section>
<section id="config_files">
<title>Configuration files</title>
<terms>
<item>
<title><file>/home/$USER/.config/streamtuner2/</file></title>
<p>Corresponds to the XDG_CONFIG_HOME setting. All ST2 configuration settings
are contained within here and are in JSON format.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/settings.json</file></title>
<p>General runtime options, plugin settings, and configured audio players.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/window.json</file></title>
<p>Saved window sizes, list widths.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/state.json</file></title>
<p>Last category in each channel tab.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/bookmarks.json</file></title>
<p>Is a separate cache file for your bookmarked/favourite radio stations.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/cache/***.json</file></title>
<p>JSON files for stream lists in each channel.</p>
</item>
<item>
<title><file>~/.config/streamtuner2/icons/*.png</file></title>
<p>Holds downloaded favicons for station homepages.</p>
</item>
</terms>
</section>
<section id="install_dirs">
<title>Installation spread</title>
<terms>
<item>
<title><file>/usr/bin/streamtuner2</file></title>
<p>Is the main binary.</p>
</item>
<item>
<title><file>/usr/share/streamtuner2/</file></title>
<p>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.</p>
</item>
<item>
<title><file>/usr/share/doc/streamtuner2/</file></title>
<p>Contains the README, and Mallard/gnome-help/yelp files under help/.</p>
</item>
</terms>
</section>
<section id="license">
<title>Public Domain</title>
<p>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.</p>
<p>The bundled kronos.py and requests/ library are NOT however.</p>
</section>
</page>