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

<info>
	<link type="guide" xref="index#functions"/>
	<link type="guide" xref="streams#actions"/>
	<desc>Edit or inspect a station entry.</desc>
</info>

	<title>Edit</title>

	<p>You probably won't need this often. But there's an
	<guiseq><gui></gui> <gui>Edit/Details</gui></guiseq> context menu
	which brings up a station editor:
	</p>
	
	<media type="image" src="img/streamedit.png" mime="image/png" />

	<p>You can see the standard title and genre fields here. But also a

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

	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.
	Instead of favicons smaller station logos are displayed (25px
	in contrast to the usual 16px).
	</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>

	<link type="guide" xref="configuration#plugins"/>
        <desc>ICEcast radio directory.</desc>
</info>

	<title>Xiph.org</title>
	<subtitle><link	href="http://dir.xiph.org/">//dir.xiph.org/</link></subtitle>

	<p>Xiph.org is a non-profit organization, which maintains and
	promotes the OGG streaming format, and develops audio compression
	schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
	format.  It also hosts a list of ICEcast streaming stations. ICEcast
	is their non-commercial pendant to the SHOUTcast server.</p>

        <p>There are different ways for streamtuner2 to retrieve the station
        lists available on dir.xiph.org.  That's because this is a primary

        plugin, and fallback solutions therefore important.  Each fetching
        mode has its own advantages and drawbacks though.</p>

        <p>Xiph also uses the .xspf playlist format, instead of just the
        more ancient Shoutcast .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

        slow station list download/unpacking.
        </p>
      </item>
      <p></p>
      <item>
        <title><code>Forbidden fruits</code></title>
        <p>As new alternative, you can let ST2 directly scrape the station
        lists from dir.xiph.org (like it does for other channels).  This is
        something which Xiph doesn't approve of.  But the drawbacks of their
        alternative offerings are too severe and user-unfriendly; which is
        why there's this raw HTML extraction mode now.</p>
        <p>The website listings contain full station homepages and a few
        more extras.  In this mode we can even acceess the XSPF playlist
        formats directly.  Both, the server search function, or browsing by
        audio/video format are supported.  </p>

      </item>
    </terms>
  </item>
  </terms>
</section>

</page>

	
	<steps>
	 <item><p>See the <key>F12</key> config dialog <key>🔌 Feature</key> section.</p></item>
	 <item><p>Enable the <key>⨯</key> Plugin Manager (listed near the end).</p></item>
	 <item><p>Restart streamtuner2 one last time for this change to take effect.</p></item>
	</steps>
	
	<p>Once activated 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