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

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
        <desc>Dirble.com</desc>
</info>

	<title><media type="image" src="img/channel_dirble.png" /> Dirble</title>
        <subtitle><link href="http://dirble.com/">//dirble.com/</link></subtitle>

	<p>Dirble.com is another radio station directory, based on
	user-contributed entries and automatic streaming server polling.</p>

        <list>
         <item><p>Provides a JSON API, which in v2 is easy to extract from.</p></item>
         <item><p>Station lists contain even station homepages mostly.</p></item>
         <item><p>And the channel plugin selects among the available
         streaming URLs based on format (Ogg, AAC, preferred over MP3) and
         maximum bitrate.</p></item>
        </list>
        
        <section>
        <subtitle>Station status indicators</subtitle>
        <p>For the dirble plugin each station entry may contain a stream
        status icon. They often just represent a heuristic check or general
        reachability statistic. You can usually start playback without
        paying attention to the status icons: </p>
        <terms>
          <item>
            <title>▮▮</title>
            <p>Maybe currently inactive.</p>
          </item>
          <item>
            <title>▶▶▮</title>
            <p>Available stream, no recent outage.</p>
          </item>
          <item>
            <title>◀◀</title>
            <p>Unclear Status 2</p>
          </item>
        </terms>
        </section>

        <section>	
        <note><p>There's a hidden config option for a custom API key.
        It's perhaps redundant. Should streamtuner2 -D however reveal an error,
        you can configure your own account in <file>settings.json</file>.
        </p></note>
        </section>
</page>
