Internet radio browser GUI for music/video streams from various directory services.

⌈⌋ ⎇ branch:  streamtuner2


contrib_features.page at [ecfcee7ed5]

File help/contrib_features.page artifact 5b6f249f73 part of check-in ecfcee7ed5


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

<info>
	<link type="guide" xref="index#extra"/>
        <link type="topic" xref="configuration#plugins"/>
        <desc>Additional feature plugins</desc>
</info>

<title>→ Feature plugins</title>

<p>Extra functionality and behaviour changes are available in
the <key>🔌 Feature</key> <link xref="configuration">configuration</link>
section.</p>


<section>
<title>Filter Bitrate</title>
<p>Some channels provide lower-quality audio streams. In particular
Xiph lists some awful radio stations. And this plugin helps filtering
those out of station lists.</p>
<list>
 <item><p>MP3 streams often start to sound okay at 96kbit/s.</p></item>
 <item><p>Whereas OGG Vorbis or AAC are sometimes acceptable at 64kbit/s already.</p></item>
</list>
<note style="warning"><p>Note that you may end up with empty channel lists
altogether if you set these options too high. Some channels provide all
their streams with 64kbit/s only.</p></note>
</section>

<section>
<title>Channel toolbar link</title>
<p>Adds a toolbar entry which shows the current channel/directory
service title and its homepage link. Such as:</p>
<code><span style="bold">Shoutcast</span>
<link href="http://shoutcast.com/">//shoutcast.com/</link>
</code>
<p>It depends on the "update window title" option being enabled.</p>
</section>

<section>
<title>Export all stations</title>
<p>There's an "Export All" plugin available. It adds an entry under
<guiseq><gui>Main menu</gui> <gui>Extensions</gui> <gui>Export all stations</gui></guiseq>.
Which allows to export all stations from the currently visible channel category.</p>
<list>
 <item><p>This is of course intended primarily for saving your bookmarks.</p></item>
 <item><p>And it allows to import radio lists into any other music player  or playlist collection/management app (such as Rhythmbox).</p></item>
 <item><p>You can set the desired playlist format in the file saving dialog that pops up.</p></item>
</list>
</section>

<section>
<title>RadioTray hook</title>
<p>This plugin enables an extra category in the <key>bookmarks</key> tab.
It shows bookmarked stations from the RadioTray application, if that's
installed. Additionally it adds an context option to save new stations
from Streamtuner2 to RadioTray. The mapping option influences if added
radios are recategorized in RadioTray.</p>
<note><p> Please see the Wiki for further <link href="http://fossil.include-once.org/streamtuner2/wiki/radiotray">setup instructions</link>.</p></note>
</section>

<section>
<title><p>User Agent Switcher</p></title>
<p>This plugin merely masks Streamtuner2 as an ordinary web browser when retrieving station lists.</p>
<list>
 <item><p> It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere. </p></item>
 <item><p>It's only useful as additional privacy feature really, but shouldn't be used habitually. </p></item>
</list>
</section>



<section>
<title>Downloadable contrib/ feature plugins</title>

<p>The <link xref="pluginmanager2">Plugin Manager</link> lists further
feature pluginsand in the <key>📦 Add</key> tab.</p>

<terms>
  <item>
    <title><p>Soundcloud streaming</p></title>
    <p>Enables playback of soundcloud.com links in the Reddit plugin.
    Homepage links are transformed into direct MP3 streaming addresses
    on playback. This plugin registers a "audio/soundcloud" pseudo
    type. Alternatively you could use <link
    href="http://github.com/rekado/soundCLI">soundcli</link> of course.</p>
  </item>
  <item>
    <title><p>dev_faulthandler</p></title>
    <p>This is a pure development plugin, meant to debug ST2 crashes.</p>
  </item>
</terms>
</section>

</page>