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