<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="internet_radio_org_uk">

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="configuration#plugins"/>
        <desc>Large radio directory from the UK.</desc>
</info>

	<title>Internet-Radio.org.uk</title>

	<p>I-R.org.uk is a good alternative to Shoutcast. It also lacks a channel homepage in most
	cases, but is a likewise encyclopedical directory. Genres are similiar to Shoutcast.</p>

	<note><p>Note that this plugin uses its own setting for how many links to retrieve. Instead
	of stream numbers, it only counts pages. This is a lazyness related bug.</p></note>

</page>

        <list>
		<item><p>Station entries usually provide current playing information.</p></item>
		<item><p>Stream links are plain PLS files.</p></item>
		<item><p>Genres are subcategorized, so the main groups in the category
		list must often be expanded to see the interesting entries.</p></item>
        </list>

        <p>Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
        entries for currently played songs, and homepage links are largely gone. Hencewhy the
        Shoutcast channel is no longer considered a primary feature.</p>

<terms>
  <title>There are a few plugin options for this channel.</title>
  <item>
    <title><code>PyQuery parsing</code></title>
    <p>Uses an XML parser to extract station data from within HTML &lt;tags&gt; of the shoutcast.com site. This is
    slower, but often more reliable than regular expressions, which look for plain text markers.</p>
  </item>
  <item>
    <title><code>debug output</code></title>
    <p>Prints verbose messages to the console. This option is used while developing extensions for Streamtuner2.
    And it actually ought to be a global option by now.</p>
  </item>
</terms>

</page>

	<title>Xiph.org</title>

	<p>Xiph.org is a non-profit organization, which develops and promotes the OGG audio format.
        It also hosts a list of ICEcast streaming stations (ICEcast is the non-commercial pendant
        to the SHOUTcast server.)</p>

        <p>This channel is especially easy to read by Streamtuner2, because the source data is already
        provided as &lt;XML&gt; file. However, it lacks some essential informations like station
        homepages and listener numbers.</p>

        <p>Xiph also uses the .xspf format, instead of .pls stream links</p>


<terms>
  <title>Channel options.</title>
  <item>
    <title><code>Filter by minimum bitrate</code></title>
    <p>The bitrate of an audio stream determines the music quality. Many Xiph streams have simple
    and low quality microphone sources. To filter these out, and only leave high quality music
    stations, you can therefore set this option. OGG starts to sound good with 128 kbit/s (whereas
    MP3 often requires 192 at least).</p>
  </item>
</terms>

</page>

<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="json">

<info>
	<link type="guide" xref="glossary#filetypes"/>
        <desc>JavaScript Object Notation is a common data exchange format.</desc>
</info>

	<title>JSON files</title>

	<p>JSON is a data representation format derived from Javascript (the browser embedded
        programming language for websites). Streamtuner2 uses it to store its configuration
        and radio station data files.</p>
	<p>The MIME type of these files is application/json and they often look like: </p>

<p><code>
[
  {
    "title": "Station title..",

          </item>
          <item>
            <title>~/.config/streamtuner2/state.json</title>
            <p>Last category in each channel tab.</p>
          </item>
          <item>
            <title>~/.config/streamtuner2/bookmarks.json</title>
            <p>Is a separate cache file for your bookmarked/favourite radio stations.</p>
          </item>
          <item>
            <title>~/.config/streamtuner2/cache/***.json</title>
            <p>JSON files for stream lists in each channel.</p>
          </item>
          <item>
            <title>~/.config/streamtuner2/icons/*.png</title>

          </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>