<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. (Only on U*ix/X11 systems)</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>

	<p>Filtermusic summarizes all the common genres, but is primarily
	focused on electro/dance/pop stations.</p>

        <list>
         <item><p>There's around a dozen categories with 20-30 radios each.</p></item>
         <item><p>Prioritizes stations on listener popularity and freshness or something.</p></item>
         <item><p>The plugin fetches an XML list of stations, or extracts from the homepage.</p></item>
        </list>

	<p>Most useful if you don't like to browse around, and want to
	listen to most popular stations.</p>

        <section id="options">	
        <title>Configuration</title>

        <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 <link
	xref="reloading">Reload</link> the station list to update them. 
	Otherwise refreshing has no effect.</p> </section>

</page>

    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>
    <note><p>A miximum of 100 entries get fetched in this mode however
    (which is 5 pages à 20 entries).</p></note>
  </item>
  </terms>
  <p>The filter-by-bitrate option is now a generic plugin.</p>
</section>

</page>

        <terms>
          <title>Examples</title>
          <item>
            <title><code>streamtuner2 play "station"</code></title>
            <p>This command looks through all channel plugins, and finds a station containing the
	    mentioned title. You must put the station title in quotes in shell calls, if it contains
	    e.g. spaces. You can optionally specify a channel name before the station title.</p>
          </item>
          <item>
            <title><code>streamtuner2 url [channel] "station"</code></title>
            <p>Just looks up the streaming URL for a given station. If no channel name is given,
		ST2 searches through all available channel plugins again.</p>
          </item>
          <item>

	</section>

	<section id="row_placeholders">
	<title>Other placeholders</title>

	<p>In addition to stream URL + type placeholders (<var>%r</var>, <var>%x</var>, 
	<var>%pls</var>, <var>%m3u</var>, etc),	you can also pass station
	info placeholders. These contain the stream information like title or
	bitrate, or any other internal field:</p>

	<table shade="rows" rules="rows cols">
	<thead>	<tr><td><p>Placeholder</p></td><td><p>As variable</p></td><td><p>Field content</p></td></tr> </thead>
		<tr><td><p>%title</p></td><td><p>$title</p></td><td><p>Station title</p></td></tr>
		<tr><td><p>%genre</p></td><td><p>$genre</p></td><td><p>Stream category or genre list</p></td></tr>
		<tr><td><p>%playing</p></td><td><p>$playing</p></td><td><p>Currently playing song, or geographic location</p></td></tr>

  <terms>
    <title>Station loading</title>
    <item>
      <title>☑ Prefer HTML traversing (PyQuery) over regex</title>
      <p>Some channels provide proper APIs to fetch station lists. Others are just websites that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p>
    </item>
    <item>
      <title>🔟 Limit stream number</title>
      <p> Constraints the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p>
    </item>
    <item>
      <title>☑ Retain deleted stations</title> <p>When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often
      at the end of the list).</p>
    </item>
    <item>
      <title>☑ Update favourites from freshened URLs</title>
      <p>Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't
      very reliable, as often station titles change together with the streaming URLs.</p>
    </item>
    <item>
      <title>☑ Save station lists after updates</title>
      <p>After reloading (<key>F5</key>) the updated station lists are
      automatically saved. For favicon updates or drag and drop events this
      only happens automatically when this option is set.</p>
    </item>
 </terms>

  <terms>
    <title>Playlist</title>
    <item>
      <title>☑ Reuse .m3u/.pls files</title> <p>When converting online station playlists,
      streamtuner2 creates temporary files like <var>shoutcast.11539398391891.m3u</var> for
      your audio player.  It'll keep those files around in /tmp/streamtuner2 until you quit. 
      That speeds up switching between and reconnecting to a previous station.  It's in
      particular necessary when you use <key>⏭</key> or <key>⏪</key> directly in your player. 
      For <var>%pls</var> references your player typically uses the online-only playlist
      files anyway.  If you disable this option, then converted pls/m3u/xspf files get
      recreated repeatedly.</p>
    </item>
    <item>
      <title>☑ Forgo any playlist conversion</title>
      <p>Per default most server playlists (be they .pls or .m3u, .xpsf) are converted.
      All player/recording apps receive a default <var>%pls</var> file normally.
      Set this option to disable any such placeholders from the Player tab, and avoid
      streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio  player gets passed
      the literal server/playlist streaming URL then.</p> <note><p>Note that this is only
      a minor speedup, but may trip up some applications. A few channel sources don't
      even provide standard stream addresses and playlists. (Jamendo albums for example really
      need pre-conversion; no audio player can deal with such custom JSON playlists).
      In short: you don't normally want to enable this flag - unless you run into problems
      with streamtuner2 taking too long, or when it hangs by accidentially downloading streams
      itself.</p></note>
    </item>
 </terms>

  <terms>
    <title>System</title>
    <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 a 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>🔌 User Agent Switcher</title>

	stream entry, then drag it out to the desktop, file manager or
	directly into VLC or any running music player.  That'll usually
	copy a stream/station address directly.</p>

	<p>Now it's not guaranteed to work with all applications or file
	managers, as X11/Gtk DND support is somewhat arcane and wonky.
	You may specifically have to adapt the default export format for
	this. Generally an XSPF or PLS file gets created for file managers.
	While VLC is one of the few applications that understands direct
	playlist URLs or literal M3U/PLS payloads even.</p>
	

        <section id="import">
	<title>Importing</title>

	  <item>
	    <title>Stream</title>
	    <p>"stream" is a technical term which means continuosly flowing
	    data.  MP3 radio music for example is streamed, because it's not
	    just a time-limited audio file, but unending (unless you stop
	    the player or paying your ISP).</p>
	    <p>In streamtuner2 the terms "stream" and radio "station" are used
	    interchangeably.</p>
	  </item>

	  <item>
	    <title>Genre</title>
	    <p>Music genres are represented as "categories" in the left
	    pane.  Every channel groups its music stations into some
	    structure.</p>

	    <title>Radio</title>
	    <p>Plays music. Sometimes interrupted by advertisements.
   	    </p>
	  </item>

	  <item>
	    <title>Favicons</title> <p>Favicons are small symbols for
	    websites.  Most websites should have one.  (ST2 downloads
	    favicons either per menu command or automatically for the
	    current station once you hit play.) </p>
	  </item>

	  <item>
	    <title>Cache</title>
	    <p>Radio lists are kept in "cache" files for efficiency reasons.

	available commands.</p>
<div class="terms"><div class="inner">
<div class="title title-terms"><h2><span class="title">Examples</span></h2></div>
<div class="region"><dl class="terms">
<dt class="terms"><span class="code">streamtuner2 play "station"</span></dt>
<dd class="terms"><p class="p">This command looks through all channel plugins, and finds a station containing the
	    mentioned title. You must put the station title in quotes in shell calls, if it contains
	    e.g. spaces. You can optionally specify a channel name before the station title.</p></dd>
<dt class="terms"><span class="code">streamtuner2 url [channel] "station"</span></dt>
<dd class="terms"><p class="p">Just looks up the streaming URL for a given station. If no channel name is given,
		ST2 searches through all available channel plugins again.</p></dd>
<dt class="terms"><span class="code">streamtuner2 stream shoutcast "station"</span></dt>
<dd class="terms"><p class="p">Prints available station data as JSON</p></dd>
<dt class="terms"><span class="code">streamtuner2 category internet_radio_org_uk "Pop"</span></dt>
<dd class="terms"><p class="p">Loads fresh data from the specified channel service, and prints out JSON data for

</div></div></div></div>
</div></div>
</div></div>
<div id="row_placeholders" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Other placeholders</span></h2></div>
<div class="region"><div class="contents">
<p class="p">In addition to stream URL + type placeholders (<span class="var">%r</span>, <span class="var">%x</span>, 
	<span class="var">%pls</span>, <span class="var">%m3u</span>, etc),	you can also pass station
	info placeholders. These contain the stream information like title or
	bitrate, or any other internal field:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>
<td><p class="p">Placeholder</p></td>
<td style="border-left-style: solid;"><p class="p">As variable</p></td>
<td style="border-left-style: solid;"><p class="p">Field content</p></td>
</tr></thead>

<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Station loading</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">☑ Prefer HTML traversing (PyQuery) over regex</dt>
<dd class="terms"><p class="p">Some channels provide proper APIs to fetch station lists. Others are just websites that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p></dd>
<dt class="terms">🔟 Limit stream number</dt>
<dd class="terms"><p class="p"> Constraints the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p></dd>
<dt class="terms">☑ Retain deleted stations</dt>
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often
      at the end of the list).</p></dd>
<dt class="terms">☑ Update favourites from freshened URLs</dt>
<dd class="terms"><p class="p">Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't
      very reliable, as often station titles change together with the streaming URLs.</p></dd>
<dt class="terms">☑ Save station lists after updates</dt>
<dd class="terms"><p class="p">After reloading (<span class="key"><kbd>F5</kbd></span>) the updated station lists are
      automatically saved. For favicon updates or drag and drop events this
      only happens automatically when this option is set.</p></dd>
</dl></div>
</div></div>
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Playlist</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">☑ Reuse .m3u/.pls files</dt>
<dd class="terms"><p class="p">When converting online station playlists,
      streamtuner2 creates temporary files like <span class="var">shoutcast.11539398391891.m3u</span> for
      your audio player.  It'll keep those files around in /tmp/streamtuner2 until you quit. 
      That speeds up switching between and reconnecting to a previous station.  It's in
      particular necessary when you use <span class="key"><kbd>⏭</kbd></span> or <span class="key"><kbd>⏪</kbd></span> directly in your player. 
      For <span class="var">%pls</span> references your player typically uses the online-only playlist
      files anyway.  If you disable this option, then converted pls/m3u/xspf files get
      recreated repeatedly.</p></dd>
<dt class="terms">☑ Forgo any playlist conversion</dt>
<dd class="terms">
<p class="p">Per default most server playlists (be they .pls or .m3u, .xpsf) are converted.
      All player/recording apps receive a default <span class="var">%pls</span> file normally.
      Set this option to disable any such placeholders from the Player tab, and avoid
      streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio  player gets passed
      the literal server/playlist streaming URL then.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Note that this is only
      a minor speedup, but may trip up some applications. A few channel sources don't
      even provide standard stream addresses and playlists. (Jamendo albums for example really
      need pre-conversion; no audio player can deal with such custom JSON playlists).
      In short: you don't normally want to enable this flag - unless you run into problems
      with streamtuner2 taking too long, or when it hangs by accidentially downloading streams
      itself.</p></div></div></div></div>
</dd>
</dl></div>
</div></div>
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">System</span></h3></div>
<div class="region"><dl class="terms">

</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h3 class="title"><span class="title">🔌 RadioTray hook</span></h3></div>
<div class="region"><div class="contents">
<p class="p">This plugin enables an extra category in the <span class="key"><kbd>bookmarks</kbd></span> tab.
  It shows bookmarked stations from the RadioTray application, if that's
  installed. Additionally it adds a context option to save new stations
  from Streamtuner2 to RadioTray. The mapping option influences if added
  radios are recategorized in RadioTray.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p"> Please see the Wiki for further <span class="link"><a href="http://fossil.include-once.org/streamtuner2/wiki/radiotray" title="http://fossil.include-once.org/streamtuner2/wiki/radiotray">setup instructions</a></span>.</p></div></div></div></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h3 class="title"><span class="title">🔌 User Agent Switcher</span></h3></div>

	method now to export stations.  Simply click and hold the mouse on a
	stream entry, then drag it out to the desktop, file manager or
	directly into VLC or any running music player.  That'll usually
	copy a stream/station address directly.</p>
<p class="p">Now it's not guaranteed to work with all applications or file
	managers, as X11/Gtk DND support is somewhat arcane and wonky.
	You may specifically have to adapt the default export format for
	this. Generally an XSPF or PLS file gets created for file managers.
	While VLC is one of the few applications that understands direct
	playlist URLs or literal M3U/PLS payloads even.</p>
</div>
<div id="import" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Importing</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Playlist importing also works mostly. Here the action module

<div class="region">
<div class="contents">
<p class="p">Filtermusic summarizes all the common genres, but is primarily
	focused on electro/dance/pop stations.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">There's around a dozen categories with 20-30 radios each.</p></li>
<li class="list"><p class="p">Prioritizes stations on listener popularity and freshness or something.</p></li>
<li class="list"><p class="p">The plugin fetches an XML list of stations, or extracts from the homepage.</p></li>
</ul></div></div></div>
<p class="p">Most useful if you don't like to browse around, and want to
	listen to most popular stations.</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">

   	    music directory service.</p></dd>
<dt class="terms">Stream</dt>
<dd class="terms">
<p class="p">"stream" is a technical term which means continuosly flowing
	    data.  MP3 radio music for example is streamed, because it's not
	    just a time-limited audio file, but unending (unless you stop
	    the player or paying your ISP).</p>
<p class="p">In streamtuner2 the terms "stream" and radio "station" are used
	    interchangeably.</p>
</dd>
<dt class="terms">Genre</dt>
<dd class="terms"><p class="p">Music genres are represented as "categories" in the left
	    pane.  Every channel groups its music stations into some
	    structure.</p></dd>
<dt class="terms">URL</dt>
<dd class="terms"><p class="p">URL stands for "Uniform Resource Locator"
	    and simply refers to something retrievable hyperlinks or web addresses like
	    http://www.example.org/.  Radio stations/streams are stored as URLs internally.
            The more generic hipster term "URI" (long superseded by "IRI" anyway)
            makes less sense in this context, because ISBN: or MailTo: references aren't
            overly useful for such purposes.</p></dd>
<dt class="terms">Radio</dt>
<dd class="terms"><p class="p">Plays music. Sometimes interrupted by advertisements.
   	    </p></dd>
<dt class="terms">Favicons</dt>
<dd class="terms"><p class="p">Favicons are small symbols for
	    websites.  Most websites should have one.  (ST2 downloads
	    favicons either per menu command or automatically for the
	    current station once you hit play.) </p></dd>
<dt class="terms">Cache</dt>
<dd class="terms"><p class="p">Radio lists are kept in "cache" files for efficiency reasons.
	    To not redownload stream information on every category or channel
	    flip, streamtuner2 saves this data. This avoids time consuming
	    server requests.

<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. (Only on U*ix/X11 systems)</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="Configuration / 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 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 <span class="link"><a href="reloading.html" title="Reloading">Reload</a></span> 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>

<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Timer</span></h1></div>
<div class="region">
<div class="contents"></div>
<div id="intro" class="sect"><div class="inner">
<div class="hgroup"></div>
<div class="region"><div class="contents">
<p class="p">You can program play/recording events with the timer plugin. Simply select a station
	and choose <span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">Add timer...</span></span>.
	A small popup will ask for a date/time string. If you press <span class="key"><kbd>OK</kbd></span> the station
	and the programmed time will be stored in the bookmarks channel in the "timer" category.
	<span class="em">Please take note of the required text format</span>.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/timer.png" class="media media-inline" alt="Timer"></span></span></p>
<div class="note note-tip" title="Tip"><div class="inner"><div class="region"><div class="contents"><p class="p">Note that streamtuner2 must be running for the programmed timer events to work.
	(In a future version there might be the option to have it handled by the system cron
	daemon.)</p></div></div></div></div>
</div></div>
</div></div>
<div id="timestring" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Time specification strings</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The time and date specificators follow a simple scheme. It's always one or more day names
	followed by a clock range, and finally the action.</p>
<p class="p">For example "<span class="code">Mon,Tue,Wed</span>" will make the event occur on the first
	three days of each week, while just "Fri" would limit it to Fridays.</p>
<p class="p">A clock range of "<span class="code">18:00-20:00</span>"
	would start the event at 18 o'clock and last it two hours. Note that for "play" events, the end
	time is irrelevant, since streamtuner2 can't kill your audio player anyway.</p>
<p class="p">The end time is only important if you replace "play" with the word "<span class="code">record</span>"
        in the timer event string. This runs streamripper instead and limits the recording time.</p>
</div></div>

    alternative offerings are too severe and user-unfriendly; which is
    why there's this raw HTML extraction mode now.</p>
<p class="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>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">A miximum of 100 entries get fetched in this mode however
    (which is 5 pages à 20 entries).</p></div></div></div></div>
</dd>
</dl></div></div></div>
<p class="p">The filter-by-bitrate option is now a generic plugin.</p>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>

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

	<link type="guide" xref="bookmarks#other"/>
	<link type="guide" xref="index#extra"/>
        <desc>Programming recurring play and recording events.</desc>
</info>

<section id="intro">

	<p>You can program play/recording events with the timer plugin. Simply select a station
	and choose <guiseq><gui>Station</gui> <gui>Add timer...</gui></guiseq>.
	A small popup will ask for a date/time string. If you press <key>OK</key> the station
	and the programmed time will be stored in the bookmarks channel in the "timer" category.
	<em>Please take note of the required text format</em>.</p>
	
	<p><media type="image" src="img/timer.png" mime="image/png">Timer</media></p>

        <note style="tip"><p>Note that streamtuner2 must be running for the programmed timer events to work.
	(In a future version there might be the option to have it handled by the system cron
	daemon.)</p></note>
</section>

	<section id="timestring">
	<title>Time specification strings</title>
	<p>The time and date specificators follow a simple scheme. It's always one or more day names
	followed by a clock range, and finally the action.</p>
	<p>For example "<code>Mon,Tue,Wed</code>" will make the event occur on the first
	three days of each week, while just "Fri" would limit it to Fridays.</p>
	<p>A clock range of "<code>18:00-20:00</code>"
	would start the event at 18 o'clock and last it two hours. Note that for "play" events, the end
	time is irrelevant, since streamtuner2 can't kill your audio player anyway.</p>
        <p>The end time is only important if you replace "play" with the word "<code>record</code>"
        in the timer event string. This runs streamripper instead and limits the recording time.</p>
	</section>