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

	<info>
	<link type="guide" xref="index#browsing"/>
	<desc>Double click a station to start it in your audio player.</desc>
	<link type="guide" xref="streams#actions"/>
	</info>

	<title>Playing</title>

	<p>To start playing a station, you can:</p>
	
	<list>

	  <item><p>Just <em>double click</em> an entry.</p></item>

	  <item><p>Use the <key>▶ play</key> toolbar button.</p></item>

	  <item><p>Right click for the context menu and the <key>play</key> action.</p></item>

	  <item><p>Drag and drop it directly into your audio player.</p></item>

	  <item><p>Save it (<key>F2</key>) to a playlist file, then start your player with that.</p></item>

	</list>

        <p>In streamtuner2 you can configure different audio players for different audio
        formats (MP3 or OGG). In the <link xref="config_apps">Apps</link> section of the
        <link xref="configuration">settings dialog</link>, you can associate one player
        with each audio file (MIME) type. Nowadays you can often configure the same player

        for all audio (and even video) types.</p>










</page>

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="configuration#plugins"/>
        <desc>Selection of the best radio stations</desc>
</info>

	<title>filtermusic</title>
        <subtitle><link href="http://filtermusic.net/">//filtermusic.net/</link></subtitle>


	<p>Filtermusic summarizes all the common genres, but is primarily
	focused on electro/dance/pop stations.  It elects on listener
	popularity and freshness or something.</p>

	<p>Which is why there are just a dozen categories with around 20-30
	stations each. Still useful if you don't like to browse around
	a lot.</p>

        <section id="options">	
        <title>Configuration</title>
	<p>Like the Xiph plugin this channel provides two/three fetch modes.</p>
	<note><p>
	There's no speed or feature differences this time. You might prefer
	the buffered mode, as it reduces update requests, but still allows
	refreshing lists.</p></note>
	</section>

</page>

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

	<title>Internet-Radio</title>
        <subtitle><link href="http://internet-radio.com/">//internet-radio.com/</link></subtitle>
        
	<p>Internet-Radio.com is a broad alternative to Shoutcast.</p>
	<list>
 	 <item><p>It has regained station homepages for most entries again.</p></item>
 	 <item><p>Genres are similiar to Shoutcast.</p></item>
 	 <item><p>Updating station list is comperatively fast.</p></item>
 	</list>

        <section id="options">
        <title>Configuration</title>
	<p>Note that this plugin has its own setting on how many
	links to retrieve.  Instead of stream numbers, it only counts pages
	(which however speeds up processing now).</p>
	</section>

</page>

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="configuration#plugins"/>
        <desc>Creative Commons music and artist hub.</desc>
</info>

<title>Jamendo</title>
<subtitle><link href="http://jamendo.com/">//jamendo.com/</link></subtitle>

<p>Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio

             <item><p>XMP/libxmp</p></item>
             <item><p>MikMod</p></item>
             <item><p>MODPlug for XMMS</p></item>
             <item><p>GModplay</p></item>
             <item><p>VLC (built-in support)</p></item>
        </list>

        <section id="options">
        <title>Configuration</title>
        
	<p>See <link xref="recording">recording configuration</link> if you
	want to enable the download mode.</p>

	<note><p>Audio files are packaged up in ZIP files on MODArchive. 
	While they are different formats (IT, S3M, XM, etc) they'll all
	carry a generic <var>audio/mod+zip</var> type specifier in
	streamtuner2.</p></note>
	
	</section>

</page>

  in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
  Shared entries aren't automatically in the <gui style="button">personal</gui> list.</p>

  <note style="tip"><p>MyOggRadio also has a neat cross-platform player:
  <link href="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</link>.</p></note>
</section>

<section id="options">
  <title>Channel options.</title>
  <terms>
  <item>
    <title><code>Login settings</code></title>
    <p>If you want to upload station infos to MyOggRadio, you need an account there.
    Registration is free and doesn't require personal information nor email address.
    Specify it as <input>username:password</input> separated with a : colon in this field.</p>

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="configuration#plugins"/>
        <desc>Large internet streaming provider</desc>
</info>

	<title>Radionomy</title>
	<subtitle><link href="http://radionomy.com/">//radionomy.com/</link></subtitle>

	<p>Radionomy is an internet radio streaming provider, orginally
	founded in Belgium.  It commands a pretty big slice of the worldwide
	internet radio stuff these days. - It took over Shoutcast.com for
	instance.</p>

	<p>Their primary directory on Radionomy.com only lists stations
	which radionomy itself hosts streaming servers for.  It's over 6000
	already.  Both listening and station hosting are free (given agreement
	to autoplay advertisements, and a minimum quota of daily listeners). 
	Radionomy is therefore pretty popular and growing.</p>
	
	<p>The extraction method in streamtuner2 uses a mix of RegExp,
	DOM traversal, and JSON extraction, with some AJAX updating spiced
	in. (It closely follows the website scheme to fetch station lists.)
	</p>
	
	<section id="options">
	 <title>Configuration</title>
	 
         <p> You can configure the number of pages it'll try (<key>3</key> by
  	 default) to influence the length of station lists.</p>
	
	 <p> And the song title updating ("<key>OnAir Updates</key>") can be disabled.
	 Future versions of this channel plugin might poll it automatically,
	 and keep the station list auto-updated.</p>
	
	 </section>

</page>

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>

        <desc>Probably still the largest radio station list.</desc>
</info>

	<title>Shoutcast</title>
	<subtitle><link	href="http://shoutcast.com/">//shoutcast.com/</link></subtitle>

	<p>SHOUTcast is the name of a MP3 streaming server software. It automatically collects all

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
        <link type="guide" xref="configuration#channels"/>
        <desc>Set of radio stations</desc>
</info>

	<title>SomaFM</title>
	<subtitle><link	href="http://somafm.com/">//somafm.com/</link></subtitle>

	<p>SomaFM is a small radio station network. It provides its own
	unique channels. Which streamtuner2 shows in a static list.</p>

        <note><p>SomaFM is a non-commercial and ad-free provider. It
        strongly depends on listener donations.</p></note>

        <section id="configuration">	
        <title>Bitrate configuration</title>

	<p>It provides streaming links in different audio formats. Only
	AAC64 is guaranteed to be available for all. Other bitrates depend
	on the station.</p>

	<p>After reconfiguring the bitrate/format, you can Reload the
	station list to update them. Otherwise refreshing has no effect.</p>
	</section>


</page>

	<p><link href="http://surfmusic.de/">SurfMusic</link> is a user-collection of
        internet radios. It's grouped by genres, or locations / countries.</p>

        <p>It's both pretty large and rather quick to extract listings from. And it mostly
        includes station homepage links.</p>


        <note style="bug"><p>The MusicTV and NewsTV sections also return results, but those are mostly
        web-based video stations. Some of them are outdated links even.</p></note>

<section id="options">

  <title>Channel options.</title>
  <terms>
  <item>
    <title><code>Language</code></title>
    <p>There's an English and a German variant of this radio directory. Genres are
    also localized. Restart streamtuner2 after switching the Language option. Then
    use <guiseq><gui>Channel</gui> <gui>Reload category tree</gui></guiseq>.</p>
  </item>
  </terms>
</section>

</page>

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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="configuration#plugins"/>
        <desc>Radio and Podcast directory.</desc>
</info>

	<title>TuneIn</title>
	<subtitle><link	href="http://tunein.com/">//tunein.com/</link></subtitle>

	<p>TuneIn hosts a major radio, show and podcast directory. It also provides the
        RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML
        lists only for radio stations currently.</p>
        
        <section id="options">
        <title>Configuration</title>
        <p>You can switch between "music" and "genres" list. The genres
        list is basically a longer and expanded variant of "music".
        Use <guiseq><gui>Channel</gui> <gui>Reload category tree</gui></guiseq>
        to update them thereafter.</p>
        </section>

</page>

        provided as <XML> file. (Internally we're using a caching service, which pre-converts
        that into JSON lists. The Xiph-org JSON API isn't really working yet).</p>

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

<section id="options">

  <title>Channel options.</title>
  <terms>
  <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 change this option. OGG starts to sound well with 96 kbit/s (whereas
    MP3 often requires 128 or 160 kbit/s at least).</p>
  </item>

        this mode we can even acceess the XSPF playlist formats directly.
        And the server search function, or browsing by audio/video format is
        supported.
        </p>
      </item>
    </terms>
  </item>
  </terms>
</section>

</page>

        tab.</p>

        <p>Of course you could also just invoke a specific YT video by
        opening it in your web browser - click the station <key>home</key>
        button simply.</p>


        <section id="options">
          <title>Channel options.</title>
          <terms>
          <item>
            <title><code>Region</code></title>
            <p>With the country dropdown you can predefine which mostPopular listings are returned.</p>
          </item>
          <item>
            <title><code>My Channels</code></title>
            <p>You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
            To apply this setting, and have new categories show up in the genre pane, use
            <guiseq><gui>Channel</gui> <gui>Update category tree</gui></guiseq> first.</p>
            <p>It's not an exact map, but utilizes the search function to find channels.</p>
          </item>
          <item>
            <title><code>Wadsworth constant</code></title>
            <p>Only influences the video homepage link.</p>
          </item>
          </terms>
        </section>

</page>

	<p>The tabs in the main window represent the music directory
        channels/services.  Each lists categories/genres and their associated radios/streams.</p>

	<media type="image" mime="image/png" src="img/channels-left.png">Tabs</media>

        <p>The notebook tabs can also be repositioned with
        <guiseq><gui>Edit</gui> <gui>Channel tab position</gui> <gui>Top</gui></guiseq>.
        And you can directly rearrange the channel tabs themselves,
        by dragging them within the list.</p>

        <p>If you first select a channel tab, the categories should appear or be loading.
        Otherwise:</p>

	<steps>
		<item><p>Select a channel tab</p></item>
		<item><p>Choose <guiseq><gui>Channel</gui> <gui>Reload categories...</gui></guiseq></p></item>
		<item><p>Pick a category/genre from the overview, left.</p></item>
	</steps>

	<p>Individual channels provide different music/radio information. The table
        views are however mostly identical for each tab. Some views may rename columns,
        or remove them alltogether.</p>

	<section id="list">
		<title>Available channels</title>
	</section>


	<section id="homepage">

    
    
    <p><media type="image" src="img/configplugins.png" mime="image/png" /></p>

    <p>Each plugin can have its own little list of extra options. They'll be
    applied right away for already active channel/feature plugins.</p>

</section>

<section id="note">
    <note style="note"><p>If you want to find out more about the short option descriptions (most settings are checkboxes),
    please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
    *.py files. These are somewhat readable even to non-programmers, and sometimes contain more information.</p></note>
</section>



</page>

<div class="hgroup"><h1 class="title"><span class="title">Channels</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">The tabs in the main window represent the music directory
        channels/services.  Each lists categories/genres and their associated radios/streams.</p>
<div class="media media-image"><div class="inner"><img src="img/channels-left.png" class="media media-block" alt=""></div></div>
<p class="p">The notebook tabs can also be repositioned with
        <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Channel tab position</span> ▸ <span class="gui">Top</span></span>.
        And you can directly rearrange the channel tabs themselves,
        by dragging them within the list.</p>
<p class="p">If you first select a channel tab, the categories should appear or be loading.
        Otherwise:</p>
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">Select a channel tab</p></li>
<li class="steps"><p class="p">Choose <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload categories...</span></span></p></li>
<li class="steps"><p class="p">Pick a category/genre from the overview, left.</p></li>
</ol></div></div></div>
<p class="p">Individual channels provide different music/radio information. The table
        views are however mostly identical for each tab. Some views may rename columns,
        or remove them alltogether.</p>
</div>
<div id="list" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Available channels</span></h2></div>
<div class="region"><div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="bookmarks.html" title="Bookmarks"><span class="title">Bookmarks</span><span class="linkdiv-dash"> — </span><span class="desc">Collect favourites via bookmark function, entry editing and deleting.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="dirble.html" title="Dirble"><span class="title">Dirble</span><span class="linkdiv-dash"> — </span><span class="desc">Dirble.com</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio"><span class="title">Internet-Radio</span><span class="linkdiv-dash"> — </span><span class="desc">Large radio directory from the UK.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="jamendo.html" title="Jamendo"><span class="title">Jamendo</span><span class="linkdiv-dash"> — </span><span class="desc">Creative Commons music and artist hub.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="live365.html" title="Live365"><span class="title">Live365</span><span class="linkdiv-dash"> — </span><span class="desc">Live365 radio network</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="myoggradio.html" title="MyOggRadio"><span class="title">MyOggRadio</span><span class="linkdiv-dash"> — </span><span class="desc">Open source stream directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="radionomy.html" title="Radionomy"><span class="title">Radionomy</span><span class="linkdiv-dash"> — </span><span class="desc">Large internet streaming provider</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="shoutcast.html" title="Shoutcast"><span class="title">Shoutcast</span><span class="linkdiv-dash"> — </span><span class="desc">Probably still the largest radio station list.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="somafm.html" title="SomaFM"><span class="title">SomaFM</span><span class="linkdiv-dash"> — </span><span class="desc">Set of radio stations</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="surfmusik.html" title="SurfMusic"><span class="title">SurfMusic</span><span class="linkdiv-dash"> — </span><span class="desc">International radio listings.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="modarchive.html" title="The MOD Archive"><span class="title">The MOD Archive</span><span class="linkdiv-dash"> — </span><span class="desc">Tracker audio file collection.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="tunein.html" title="TuneIn"><span class="title">TuneIn</span><span class="linkdiv-dash"> — </span><span class="desc">Radio and Podcast directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="ubuntuusersm.html" title="UbuntuUsers"><span class="title">UbuntuUsers</span><span class="linkdiv-dash"> — </span><span class="desc">Wiki list of radio stations</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="xiph.html" title="Xiph.org"><span class="title">Xiph.org</span><span class="linkdiv-dash"> — </span><span class="desc">ICEcast radio directory.</span></a></div>

      upside.  There's also a command line flag <span class="cmd">--nt</span> to enable this workaround.</p></dd>
</dl></div>
</div></div>
</div></div>
</div></div>
<div id="plugins" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel and feature plugins and settings</span></h2></div>
<div class="region">
<div class="contents">
<p class="p">The tabs <span class="key"><kbd>📻 Channels</kbd></span> lists all available directory services.
    While the <span class="key"><kbd>🔌 Features</kbd></span> group provides internal or menu enhancements.
    Disabling or enabling a plugin however requires a restart of Streamtuner2
    to take effect. (Unless the <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a></span>
    is enabled, with its <span class="key"><kbd>📦 Add</kbd></span> tab visible.)</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/configplugins.png" class="media media-inline" alt=""></span></span></p>
<p class="p">Each plugin can have its own little list of extra options. They'll be
    applied right away for already active channel/feature plugins.</p>



<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio"><span class="title">Internet-Radio</span><span class="linkdiv-dash"> — </span><span class="desc">Large radio directory from the UK.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="jamendo.html" title="Jamendo"><span class="title">Jamendo</span><span class="linkdiv-dash"> — </span><span class="desc">Creative Commons music and artist hub.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="myoggradio.html" title="MyOggRadio"><span class="title">MyOggRadio</span><span class="linkdiv-dash"> — </span><span class="desc">Open source stream directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="radionomy.html" title="Radionomy"><span class="title">Radionomy</span><span class="linkdiv-dash"> — </span><span class="desc">Large internet streaming provider</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="surfmusik.html" title="SurfMusic"><span class="title">SurfMusic</span><span class="linkdiv-dash"> — </span><span class="desc">International radio listings.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="tunein.html" title="TuneIn"><span class="title">TuneIn</span><span class="linkdiv-dash"> — </span><span class="desc">Radio and Podcast directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="xiph.html" title="Xiph.org"><span class="title">Xiph.org</span><span class="linkdiv-dash"> — </span><span class="desc">ICEcast radio directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="youtube.html" title="Youtube"><span class="title">Youtube</span><span class="linkdiv-dash"> — </span><span class="desc">Youtube music/video listings.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="filtermusic.html" title="filtermusic"><span class="title">filtermusic</span><span class="linkdiv-dash"> — </span><span class="desc">Selection of the best radio stations</span></a></div>
</div></div></div>
</div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h3><span class="title">More Information</span></h3></div>
<div class="region"><ul><li class="links ">
<a href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a><span class="desc"> — User plugin installation</span>
</li></ul></div>
</div></div></div>
</div>
</div>
</div></div>
<div id="note" class="sect"><div class="inner">
<div class="hgroup"></div>
<div class="region"><div class="contents"><div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">If you want to find out more about the short option descriptions (most settings are checkboxes),
    please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
    *.py files. These are somewhat readable even to non-programmers, and sometimes contain more information.</p></div></div></div></div></div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="index.html#configuration" title="Configuration">Configuration</a></li></ul></div>
</div></div></div>

</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">filtermusic</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://filtermusic.net/" title="http://filtermusic.net/">//filtermusic.net/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Filtermusic summarizes all the common genres, but is primarily
	focused on electro/dance/pop stations.  It elects on listener
	popularity and freshness or something.</p>
<p class="p">Which is why there are just a dozen categories with around 20-30
	stations each. Still useful if you don't like to browse around
	a lot.</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Like the Xiph plugin this channel provides two/three fetch modes.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">
	There's no speed or feature differences this time. You might prefer
	the buffered mode, as it reduces update requests, but still allows
	refreshing lists.</p></div></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="bookmarks.html" title="Bookmarks"><span class="title">Bookmarks</span><span class="linkdiv-dash"> — </span><span class="desc">Collect favourites via bookmark function, entry editing and deleting.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="dirble.html" title="Dirble"><span class="title">Dirble</span><span class="linkdiv-dash"> — </span><span class="desc">Dirble.com</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio"><span class="title">Internet-Radio</span><span class="linkdiv-dash"> — </span><span class="desc">Large radio directory from the UK.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="jamendo.html" title="Jamendo"><span class="title">Jamendo</span><span class="linkdiv-dash"> — </span><span class="desc">Creative Commons music and artist hub.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="live365.html" title="Live365"><span class="title">Live365</span><span class="linkdiv-dash"> — </span><span class="desc">Live365 radio network</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="myoggradio.html" title="MyOggRadio"><span class="title">MyOggRadio</span><span class="linkdiv-dash"> — </span><span class="desc">Open source stream directory.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="radionomy.html" title="Radionomy"><span class="title">Radionomy</span><span class="linkdiv-dash"> — </span><span class="desc">Large internet streaming provider</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="shoutcast.html" title="Shoutcast"><span class="title">Shoutcast</span><span class="linkdiv-dash"> — </span><span class="desc">Probably still the largest radio station list.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="somafm.html" title="SomaFM"><span class="title">SomaFM</span><span class="linkdiv-dash"> — </span><span class="desc">Set of radio stations</span></a></div>
</div>
<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="surfmusik.html" title="SurfMusic"><span class="title">SurfMusic</span><span class="linkdiv-dash"> — </span><span class="desc">International radio listings.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="modarchive.html" title="The MOD Archive"><span class="title">The MOD Archive</span><span class="linkdiv-dash"> — </span><span class="desc">Tracker audio file collection.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="tunein.html" title="TuneIn"><span class="title">TuneIn</span><span class="linkdiv-dash"> — </span><span class="desc">Radio and Podcast directory.</span></a></div>

<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Internet-Radio</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://internet-radio.com/" title="http://internet-radio.com/">//internet-radio.com/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Internet-Radio.com is a broad alternative to Shoutcast.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">It has regained station homepages for most entries again.</p></li>
<li class="list"><p class="p">Genres are similiar to Shoutcast.</p></li>
<li class="list"><p class="p">Updating station list is comperatively fast.</p></li>
</ul></div></div></div>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents"><p class="p">Note that this plugin has its own setting on how many
	links to retrieve.  Instead of stream numbers, it only counts pages
	(which however speeds up processing now).</p></div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>

<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> » </div></div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Introduction</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Streamtuner2 is a simple browser for internet radios. It aquires its radio lists
	from various directory services. These are represented as "channel" tabs in the main
	window. The category/genre lists are in the left pane, and associated stations right
	to them.</p>
<div class="media media-image"><div class="inner"><img src="img/mainwindow.png" class="media media-block" alt=""></div></div>
</div>
<div id="play" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">How to select and play a radio.</span></h2></div>
<div class="region"><div class="contents">
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">Select a channel tab, like <span class="code">Shoutcast</span>.</p></li>
<li class="steps"><p class="p">Click one of the genres in the left pane. For example <span class="code">Classic</span>.</p></li>
<li class="steps"><p class="p">Now the right pane loads a radio list.</p></li>
<li class="steps"><p class="p">Double click one of the radio streams or use the <span class="key"><kbd>▶ play</kbd></span> toolbar button.</p></li>
</ol></div></div></div>
<p class="p">Note that some categories are expandable. In a few plugins (modarchive),
	the grouping genre/categories are empty, while in other channels they're
	filled genre lists themselves.</p>
</div></div>
</div></div>
<div id="actions" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">What else can you do?</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Double clicking an entry row in the radio list starts your audio player. But there are
	other functions available. Either go to the <span class="guiseq"><span class="gui"></span> ▸ <span class="gui">Station</span></span> menu,

<td style="border-top-style: solid;border-left-style: solid;"><p class="p">You can get a radio list according to search criteria.</p></td>
</tr>
</table></div></div></div>
<p class="p"> Play, Record and Homepage also have buttons in the toolbar.</p>
</div></div>
</div></div>
<div id="none" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Refresh radio lists</span></h2></div>
<div class="region"><div class="contents"><p class="p">After some time, stream informations become obsolete. Therefore you should regularily
	refresh the lists. The <span class="gui">Reload</span> button in the toolbar (or <span class="key"><kbd>F5</kbd></span>) is your friend. You can
	also update the category lists with <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload Category Tree</span></span>
	and load favicons using <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update favicons..</span></span>.</p></div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"></div>

</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Jamendo</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://jamendo.com/" title="http://jamendo.com/">//jamendo.com/</a></span></span></h2>
</div>
<div class="region">

</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">XMP/libxmp</p></li>
<li class="list"><p class="p">MikMod</p></li>
<li class="list"><p class="p">MODPlug for XMMS</p></li>
<li class="list"><p class="p">GModplay</p></li>
<li class="list"><p class="p">VLC (built-in support)</p></li>
</ul></div></div></div>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents">
<p class="p">See <span class="link"><a href="recording.html" title="Recording">recording configuration</a></span> if you
	want to enable the download mode.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Audio files are packaged up in ZIP files on MODArchive. 
	While they are different formats (IT, S3M, XM, etc) they'll all
	carry a generic <span class="var">audio/mod+zip</span> type specifier in
	streamtuner2.</p></div></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>

<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">MyOggRadio</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://myoggradio.org/" title="http://myoggradio.org/">//myoggradio.org/</a></span></span></h2>
</div>
<div class="region">

<p class="p">The personal section is empty per default. You need to specify an user account
  in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
  Shared entries aren't automatically in the <span class="gui">personal</span> list.</p>
<div class="note note-tip" title="Tip"><div class="inner"><div class="region"><div class="contents"><p class="p">MyOggRadio also has a neat cross-platform player:
  <span class="link"><a href="http://freshcode.club/projects/jmorp" title="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</a></span>.</p></div></div></div></div>
</div></div>
</div></div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Login settings</span></dt>
<dd class="terms">
<p class="p">If you want to upload station infos to MyOggRadio, you need an account there.
    Registration is free and doesn't require personal information nor email address.
    Specify it as <span class="input">username:password</span> separated with a : colon in this field.</p>

<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> › <a class="trail" href="streams.html#actions" title="Actions">Actions</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Playing</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">To start playing a station, you can:</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Just <span class="em">double click</span> an entry.</p></li>
<li class="list"><p class="p">Use the <span class="key"><kbd>▶ play</kbd></span> toolbar button.</p></li>
<li class="list"><p class="p">Right click for the context menu and the <span class="key"><kbd>play</kbd></span> action.</p></li>
<li class="list"><p class="p">Drag and drop it directly into your audio player.</p></li>
<li class="list"><p class="p">Save it (<span class="key"><kbd>F2</kbd></span>) to a playlist file, then start your player with that.</p></li>
</ul></div></div></div>
<p class="p">In streamtuner2 you can configure different audio players for different audio
        formats (MP3 or OGG). In the <span class="link"><a href="config_apps.html" title="Audio players">Apps</a></span> section of the
        <span class="link"><a href="configuration.html" title="Settings dialog">settings dialog</a></span>, you can associate one player
        with each audio file (MIME) type. Nowadays you can often configure the same player







        for all audio (and even video) types.</p>
</div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="streams.html#actions" title="Actions">Actions</a></li>

<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Plugin Manager 2</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">For updating or installing new plugins (extra channels or
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
<p class="p">Once acticated (after a restart) it brings up a new <span class="key"><kbd>📦
	Add</kbd></span> tab in the configuration window.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/pluginmanager2.png" class="media media-inline" alt="Install dialog for user plugins"></span></span></p>
<p class="p">You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <span class="key"><kbd>📻 Channels</kbd></span> or <span class="key"><kbd>🔌 Feature</kbd></span> tabs, and
	then enable them.</p>
<div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="configuration.html#plugins" title="Channel and feature plugins and settings"><span class="title">Channel and feature plugins and settings</span></a></div></div></div></div>
</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents"><div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></li>
<li class="list">
<p class="p">And you can let the plugin manager handle autoactivation
	of changed plugin states.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">After reconfiguring existing channel plugins, they get
   	  automatically instantiated or disabled in the user interface.
   	  (Which avoids the usual restart).</p></li>
<li class="list"><p class="p">This currently doesn't work with feature/core
   	  plugins. Plugin deactivation is mostly visual, but does not undo
   	  menu extensions or undefine callback hooks.</p></li>
</ul></div></div></div>
</li>
</ul></div></div></div></div></div>
</div></div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">User plugins</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Downloaded plugins are stored in <span class="file">~/.config/streamtuner2/plugins</span>.
	To remove them, delete the individual *.py files there manually.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents">
<p class="p">Currently system-installed core plugins take
	precedence over downloaded updates.</p>
<p class="p">And you'll have to take care to eventually refresh/delete outdated user plugins,
	whenever you install a newer Streamtuner2 version.</p>
</div></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul><li class="links "><a href="index.html#extra" title="Additional features">Additional features</a></li></ul></div>

</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Radionomy</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://radionomy.com/" title="http://radionomy.com/">//radionomy.com/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Radionomy is an internet radio streaming provider, orginally
	founded in Belgium.  It commands a pretty big slice of the worldwide
	internet radio stuff these days. - It took over Shoutcast.com for
	instance.</p>
<p class="p">Their primary directory on Radionomy.com only lists stations
	which radionomy itself hosts streaming servers for.  It's over 6000
	already.  Both listening and station hosting are free (given agreement
	to autoplay advertisements, and a minimum quota of daily listeners). 
	Radionomy is therefore pretty popular and growing.</p>
<p class="p">The extraction method in streamtuner2 uses a mix of RegExp,
	DOM traversal, and JSON extraction, with some AJAX updating spiced
	in. (It closely follows the website scheme to fetch station lists.)
	</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents">
<p class="p"> You can configure the number of pages it'll try (<span class="key"><kbd>3</kbd></span> by
  	 default) to influence the length of station lists.</p>
<p class="p"> And the song title updating ("<span class="key"><kbd>OnAir Updates</kbd></span>") can be disabled.
	 Future versions of this channel plugin might poll it automatically,
	 and keep the station list auto-updated.</p>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>


</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Shoutcast</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://shoutcast.com/" title="http://shoutcast.com/">//shoutcast.com/</a></span></span></h2>
</div>
<div class="region">

</div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>

<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<h1 class="title"><span class="title">SomaFM</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://somafm.com/" title="http://somafm.com/">//somafm.com/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">SomaFM is a small radio station network. It provides its own
	unique channels. Which streamtuner2 shows in a static list.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">SomaFM is a non-commercial and ad-free provider. It
        strongly depends on listener donations.</p></div></div></div></div>
</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Bitrate configuration</span></h2></div>
<div class="region"><div class="contents">
<p class="p">It provides streaming links in different audio formats. Only
	AAC64 is guaranteed to be available for all. Other bitrates depend
	on the station.</p>
<p class="p">After reconfiguring the bitrate/format, you can Reload the
	station list to update them. Otherwise refreshing has no effect.</p>

</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>

<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">SurfMusic</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://surfmusic.de/" title="http://surfmusic.de/">//surfmusic.de/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p"><span class="link"><a href="http://surfmusic.de/" title="http://surfmusic.de/">SurfMusic</a></span> is a user-collection of
        internet radios. It's grouped by genres, or locations / countries.</p>
<p class="p">It's both pretty large and rather quick to extract listings from. And it mostly
        includes station homepage links.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">The MusicTV and NewsTV sections also return results, but those are mostly
        web-based video stations. Some of them are outdated links even.</p></div></div></div></div>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Language</span></dt>
<dd class="terms"><p class="p">There's an English and a German variant of this radio directory. Genres are
    also localized. Restart streamtuner2 after switching the Language option. Then
    use <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload category tree</span></span>.</p></dd>
</dl></div></div></div></div></div>
</div></div>

<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>

</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">TuneIn</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://tunein.com/" title="http://tunein.com/">//tunein.com/</a></span></span></h2>
</div>
<div class="region">
<div class="contents"><p class="p">TuneIn hosts a major radio, show and podcast directory. It also provides the
        RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML
        lists only for radio stations currently.</p></div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents"><p class="p">You can switch between "music" and "genres" list. The genres
        list is basically a longer and expanded variant of "music".
        Use <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload category tree</span></span>
        to update them thereafter.</p></div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Xiph.org</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://dir.xiph.org/" title="http://dir.xiph.org/">//dir.xiph.org/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Xiph.org is a non-profit organization, which develops and
	promotes the OGG streaming format, and develops audio compression
	schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
	enve.  It also hosts a list of ICEcast streaming stations. ICEcast
	is their non-commercial pendant to the SHOUTcast server.</p>
<p class="p">This channel is somehwat easy to read for Streamtuner2, because the source data is already
        provided as &lt;XML&gt; file. (Internally we're using a caching service, which pre-converts
        that into JSON lists. The Xiph-org JSON API isn't really working yet).</p>
<p class="p">However, it lacks some essential informations like station homepages and listener numbers.</p>
<p class="p">Xiph also uses the .xspf format, instead of .pls stream links</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Filter by minimum bitrate</span></dt>
<dd class="terms"><p class="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 change this option. OGG starts to sound well with 96 kbit/s (whereas
    MP3 often requires 128 or 160 kbit/s at least).</p></dd>
<dt class="terms"><span class="code">Fetch mode</span></dt>
<dd class="terms">

        this mode we can even acceess the XSPF playlist formats directly.
        And the server search function, or browsing by audio/video format is
        supported.
        </p>
</dd>
</dl></div></div></div>
</dd>
</dl></div></div></div></div></div>
</div></div>

<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>

<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="channels.html" title="Channels">Channels</a> › <a class="trail" href="channels.html#list" title="Available channels">Available channels</a> » </div>
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » <a class="trail" href="pluginmanager2.html" title="Plugin Manager 2">Plugin Manager 2</a> » <a class="trail" href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a> » </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Youtube</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://youtube.com/" title="http://youtube.com/">//youtube.com/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Googles Youtube provides a quirky JSON API that makes browsing
        channels and genres feasible.  This beta plugin provides a little
        overview, and usually retrieves recent video uploads.</p>
<p class="p">VLC can directly play Youtube URLs. For other players one can use
        <span class="link"><a href="http://youtube-dl.org/" title="http://youtube-dl.org/">youtube-dl</a></span> as wrapper.
        For example <span class="cmd">totem $(youtube-dl %srv)</span> as configured player
        command.</p>
<p class="p">Youtube-dl is preconfigued as "recording"/download tool for this channel
        tab.</p>
<p class="p">Of course you could also just invoke a specific YT video by
        opening it in your web browser - click the station <span class="key"><kbd>home</kbd></span>
        button simply.</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Region</span></dt>
<dd class="terms"><p class="p">With the country dropdown you can predefine which mostPopular listings are returned.</p></dd>
<dt class="terms"><span class="code">My Channels</span></dt>
<dd class="terms">
<p class="p">You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
            To apply this setting, and have new categories show up in the genre pane, use
            <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update category tree</span></span> first.</p>
<p class="p">It's not an exact map, but utilizes the search function to find channels.</p>
</dd>
<dt class="terms"><span class="code">Wadsworth constant</span></dt>
<dd class="terms"><p class="p">Only influences the video homepage link.</p></dd>
</dl></div></div></div></div></div>
</div></div>

<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="configuration.html#plugins" title="Channel and feature plugins and settings">Channel and feature plugins and settings</a></li>

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

<info>
	<link type="guide" xref="index"/>
        <desc>Basic usage instructions. Selecting a channel, category, and playing a radio.</desc>
</info>

	<title>Introduction</title>

	<p>Streamtuner2 is a simple browser for internet radios. It aquires its radio lists
	from various directory services. These are represented as "channel" tabs in the main
	window. The category/genre lists are in the left pane, and associated stations right
	to them.</p>

	<media src="img/mainwindow.png" type="image" mime="image/png" />

        <section id="play">
	<title>How to select and play a radio.</title>
	<steps>
		<item><p>Select a channel tab, like <code>Shoutcast</code>.</p></item>
		<item><p>Click one of the genres in the left pane. For example <code>Classic</code>.</p></item>
		<item><p>Now the right pane loads a radio list.</p></item>
		<item><p>Double click one of the radio streams or use the <key>▶ play</key> toolbar button.</p></item>
	</steps>
	<p>Note that some categories are expandable. In a few plugins (modarchive),
	the grouping genre/categories are empty, while in other channels they're
	filled genre lists themselves.</p>
	</section>

	<section id="actions">
	<title>What else can you do?</title>
	<p>Double clicking an entry row in the radio list starts your audio player. But there are
	other functions available. Either go to the <guiseq><gui/><gui>Station</gui></guiseq> menu,
	or access the context menu with a right click.</p>

		<tr><td><p>Editing</p></td><td><p>This command is in the <gui>Edit</gui> and context menu, allows to inspect and modify radio descriptions.</p></td></tr>
		<tr><td><p>Searching</p></td><td><p>You can get a radio list according to search criteria.</p></td></tr>
	</table>
	<p> Play, Record and Homepage also have buttons in the toolbar.</p>
	</section>

	<section id="none">
	<title>Refresh radio lists</title>
	<p>After some time, stream informations become obsolete. Therefore you should regularily
	refresh the lists. The <gui>Reload</gui> button in the toolbar (or <key>F5</key>) is your friend. You can
	also update the category lists with <guiseq><gui>Channel</gui> <gui>Reload Category Tree</gui></guiseq>
	and load favicons using <guiseq><gui>Channel</gui> <gui>Update favicons..</gui></guiseq>.</p>
	</section>

	<section>
	<note style="tip"><p>You should only select radio stations and genres that you like.</p></note>
	</section>

</page>

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

<info>
	<link type="guide" xref="index#extra"/>
	<link type="topic" xref="configuration#plugins"/>
        <desc>User plugin installation</desc>
</info>

	<title>Plugin Manager 2</title>

	<p>For updating or installing new plugins (extra channels or
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
	
	<p>Once acticated (after a restart) it brings up a new <key>📦
	Add</key> tab in the configuration window.</p>
	
	<p><media type="image" src="img/pluginmanager2.png"
	mime="image/png">Install dialog for user plugins</media></p>
	
	<p>You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <key>📻 Channels</key> or <key>🔌 Feature</key> tabs, and
	then enable them.</p>
	
	<section id="configuration">
	<title>Configuration</title>
	<list>
	<item><p>Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></item>
	<item><p>And you can let the plugin manager handle autoactivation
	of changed plugin states.</p>
	  <list>
	  <item><p>After reconfiguring existing channel plugins, they get
   	  automatically instantiated or disabled in the user interface.
   	  (Which avoids the usual restart).</p></item>
	  <item><p>This currently doesn't work with feature/core
   	  plugins. Plugin deactivation is mostly visual, but does not undo
   	  menu extensions or undefine callback hooks.</p></item>
     	  </list>
     	</item>
   	</list>
	</section>

	<section id="configuration">
	<title>User plugins</title>
	<p>Downloaded plugins are stored in <file>~/.config/streamtuner2/plugins</file>.
	To remove them, delete the individual *.py files there manually.</p>
	<note style="bug"><p>Currently system-installed core plugins take
	precedence over downloaded updates.</p>
	<p>And you'll have to take care to eventually refresh/delete outdated user plugins,
	whenever you install a newer Streamtuner2 version.</p></note>
	</section>

</page>