Updated comment, more correct regex (albeit it's too strict in comparison to
the real date/time extraction method now)
check-in: 6b99231fbe user: mario tags: trunk
<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>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 <linkxref="config_apps">Apps</link> section of the
<linkxref="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 a XML list of stations, or extracts from the homepage.</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><sectionid="options"><title>Configuration</title>
<sectionid="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><p>After reconfiguring the bitrate/format, you can <linkxref="reloading">Reload</link> the station list to update them.
Otherwiserefreshinghas 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>
(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 channelname before the station title.</p> e.g. spaces. You can optionally specify a channelname 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><sectionid="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 row
placeholders. These contain the stream information like title or
<var>%pls</var>, <var>%m3u</var>, etc), you can also pass stationinfo placeholders. These contain the stream information like title or
bitrate, or any other internal field:</p><tableshade="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. Occassionally the regex method is surprisingly more exact,
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 throws them out when inavailable.
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 favouries from freshened URLs</title><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
autoamtically saved. For favicon updates or drag and drop events this
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 usues the online-only playlist
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 hang by accidentially downloading streams
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 an context option to save new stations
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 <linkhref="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 defaultexport format forthis.Generally a XSPF or PLS file gets created for file managers.this.Generally an XSPF or PLS file gets created for file managers.While VLC is one of the few applications that understands direct
playlist URLsor 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 interchangably.</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>
484950515253545556575859606162
495051525354555657585960616263
-+
<title>Radio</title><p>Plays music. Sometimes interrupted by advertisements.
</p></item><item><title>Favicons</title><p>Favicons are small symbols for
websites. Most website should have one. (ST2 downloads
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 channelname before the station title.</p></dd> e.g. spaces.You can optionally specify a channelname 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.Ifno 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><divid="row_placeholders"class="sect"><divclass="inner"><divclass="hgroup"><h2class="title"><spanclass="title">Other placeholders</span></h2></div><divclass="region"><divclass="contents"><pclass="p">In addition to stream URL + type placeholders (<spanclass="var">%r</span>, <spanclass="var">%x</span>,
<spanclass="var">%pls</span>, <spanclass="var">%m3u</span>, etc), you can also pass row
placeholders. These contain the stream information like title or
<spanclass="var">%pls</span>, <spanclass="var">%m3u</span>, etc), you can also pass stationinfo placeholders. These contain the stream information like title or
bitrate, or any other internal field:</p><divclass="table"><divclass="inner"><divclass="region"><tableclass="table"><thead><tr><td><pclass="p">Placeholder</p></td><tdstyle="border-left-style: solid;"><pclass="p">As variable</p></td><tdstyle="border-left-style: solid;"><pclass="p">Field content</p></td></tr></thead>
<divclass="terms"><divclass="inner"><divclass="title title-terms"><h3><spanclass="title">Station loading</span></h3></div><divclass="region"><dlclass="terms"><dtclass="terms">☑ Prefer HTML traversing (PyQuery) over regex</dt><ddclass="terms"><pclass="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. Occassionally the regex method is surprisingly more exact,
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><dtclass="terms">🔟 Limit stream number</dt><ddclass="terms"><pclass="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><dtclass="terms">☑ Retain deleted stations</dt><ddclass="terms"><pclass="p">When enabled, keeps old station entries when
updating/reloading a category/genre. Services often forget stations or throws them out when inavailable.
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><dtclass="terms">☑ Update favouries from freshened URLs</dt><dtclass="terms">☑ Update favourites from freshened URLs</dt><ddclass="terms"><pclass="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><dtclass="terms">☑ Save station lists after updates</dt><ddclass="terms"><pclass="p">After reloading (<spanclass="key"><kbd>F5</kbd></span>) the updated station lists are
autoamtically saved. For favicon updates or drag and drop events this
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><divclass="terms"><divclass="inner"><divclass="title title-terms"><h3><spanclass="title">Playlist</span></h3></div><divclass="region"><dlclass="terms"><dtclass="terms">☑ Reuse .m3u/.pls files</dt><ddclass="terms"><pclass="p">When converting online station playlists,
streamtuner2 creates temporary files like <spanclass="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 <spanclass="key"><kbd>⏭</kbd></span> or <spanclass="key"><kbd>⏪</kbd></span> directly in your player.
For <spanclass="var">%pls</span> references your player typically usues the online-only playlist
For <spanclass="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><dtclass="terms">☑ Forgo any playlist conversion</dt><ddclass="terms"><pclass="p">Per default most server playlists (be they .pls or .m3u, .xpsf) are converted.
All player/recording apps receive a default <spanclass="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><divclass="note"title="Note"><divclass="inner"><divclass="region"><divclass="contents"><pclass="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 hang by accidentially downloading streams
with streamtuner2 taking too long, or when it hangs by accidentially downloading streams
itself.</p></div></div></div></div></dd></dl></div></div></div><divclass="terms"><divclass="inner"><divclass="title title-terms"><h3><spanclass="title">System</span></h3></div><divclass="region"><dlclass="terms">
</div></div></div></div><divid=""class="sect"><divclass="inner"><divclass="hgroup"><h3class="title"><spanclass="title">🔌 RadioTray hook</span></h3></div><divclass="region"><divclass="contents"><pclass="p">This plugin enables an extra category in the <spanclass="key"><kbd>bookmarks</kbd></span> tab.
It shows bookmarked stations from the RadioTray application, if that's
installed. Additionally it adds an context option to save new stations
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><divclass="note"title="Note"><divclass="inner"><divclass="region"><divclass="contents"><pclass="p"> Please see the Wiki for further <spanclass="link"><ahref="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><divid=""class="sect"><divclass="inner"><divclass="hgroup"><h3class="title"><spanclass="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 defaultexport format forthis.Generally a XSPF or PLS file gets created for file managers.this.Generally an XSPF or PLS file gets created for file managers.While VLC is one of the few applications that understands direct
playlist URLsor 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
<divclass="region"><divclass="contents"><pclass="p">Filtermusic summarizes all the common genres, but is primarily
focused on electro/dance/pop stations.</p><divclass="list"><divclass="inner"><divclass="region"><ulclass="list"><liclass="list"><pclass="p">There's around a dozen categories with 20-30 radios each.</p></li><liclass="list"><pclass="p">Prioritizes stations on listener popularity and freshness or something.</p></li><liclass="list"><pclass="p">The plugin fetches a XML list of stations, or extracts from the homepage.</p></li><liclass="list"><pclass="p">The plugin fetches an XML list of stations, or extracts from the homepage.</p></li></ul></div></div></div><pclass="p">Most useful if you don't like to browse around, and want to
listen to most popular stations.</p></div><divid="options"class="sect"><divclass="inner"><divclass="hgroup"><h2class="title"><spanclass="title">Configuration</span></h2></div><divclass="region"><divclass="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 interchangably.</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 website should have one.(ST2 downloads
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.Tonot redownload stream information on every category or channel
flip, streamtuner2 saves this data.This avoids time consuming
server requests.
<divclass="region"><divclass="contents"><pclass="p">To start playing a station, you can:</p><divclass="list"><divclass="inner"><divclass="region"><ulclass="list"><liclass="list"><pclass="p">Just <spanclass="em">double click</span> an entry.</p></li><liclass="list"><pclass="p">Use the <spanclass="key"><kbd>▶ play</kbd></span> toolbar button.</p></li><liclass="list"><pclass="p">Right click for the context menu and the <spanclass="key"><kbd>play</kbd></span> action.</p></li><liclass="list"><pclass="p">Drag and drop it directly into your audio player.</p></li><liclass="list"><pclass="p">Drag and drop it directly into your audio player. (Only on U*ix/X11 systems)</p></li><liclass="list"><pclass="p">Save it (<spanclass="key"><kbd>F2</kbd></span>) to a playlist file, then start your player with that.</p></li></ul></div></div></div><pclass="p">In streamtuner2 you can configure different audio players for different audio
formats (MP3 or OGG). In the <spanclass="link"><ahref="config_apps.html"title="Audio players">Apps</a></span> section of the
<spanclass="link"><ahref="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><divid="configuration"class="sect"><divclass="inner"><divclass="hgroup"><h2class="title"><spanclass="title">Bitrate configuration</span></h2></div><divclass="region"><divclass="contents"><pclass="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><pclass="p">After reconfiguring the bitrate/format, you can Reload thestation list to update them. Otherwise refreshing has no effect.</p><pclass="p">After reconfiguring the bitrate/format, you can <spanclass="link"><ahref="reloading.html"title="Reloading">Reload</a></span> the station list to update them.
Otherwise refreshing has no effect.</p></div></div></div></div><divclass="sect sect-links"role="navigation"><divclass="hgroup"></div><divclass="contents"><divclass="links guidelinks"><divclass="inner"><divclass="title"><h2><spanclass="title">More Information</span></h2></div><divclass="region"><ul>
<divclass="body"><divclass="hgroup"><h1class="title"><spanclass="title">Timer</span></h1></div><divclass="region"><divclass="contents"></div><divid="intro"class="sect"><divclass="inner"><divclass="hgroup"></div><divclass="region"><divclass="contents"><pclass="p">You can programm play/recording events with the timer plugin. Simply select a station
<pclass="p">You can program play/recording events with the timer plugin. Simply select a station
and choose <spanclass="guiseq"><spanclass="gui">Station</span> ▸ <spanclass="gui">Add timer...</span></span>.
A small popup will ask for a data/time string. If you press <spanclass="key"><kbd>OK</kbd></span> the station
A small popup will ask for a date/time string. If you press <spanclass="key"><kbd>OK</kbd></span> the station
and the programmed time will be stored in the bookmarks channel in the "timer" category.
<spanclass="em">Please take note of the required text format</span>.</p><pclass="p"><spanclass="media"><spanclass="media media-image"><imgsrc="img/timer.png"class="media media-inline"alt="Timer"></span></span></p><divclass="note note-tip"title="Tip"><divclass="inner"><divclass="region"><divclass="contents"><pclass="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><divid="timestring"class="sect"><divclass="inner"><divclass="hgroup"><h2class="title"><spanclass="title">Time specification strings</span></h2></div><divclass="region"><divclass="contents"><pclass="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><pclass="p">For example "<spanclass="code">Mon,Tue,Wed</span>" will make the event occour on the first
<pclass="p">For example "<spanclass="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><pclass="p">A clock range of "<spanclass="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><pclass="p">The end time is only important if you replace "play" with the word "<spanclass="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>
(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>
<pclass="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><pclass="p">VLC can directly play Youtube URLs. For other players one can use
<spanclass="link"><ahref="http://youtube-dl.org/"title="http://youtube-dl.org/">youtube-dl</a></span> as wrapper.
For example <spanclass="cmd">totem $(youtube-dl %srv)</span> as configured player
command.</p><pclass="p">Youtube-dl is preconfigued as "recording"/download tool for this channel
<pclass="p">Youtube-dl is preconfigured as "recording"/download tool for this channel
tab.</p><pclass="p">Of course you could also just invoke a specific YT video by
opening it in your web browser - click the station <spanclass="key"><kbd>home</kbd></span>
button simply.</p></div><divid="options"class="sect"><divclass="inner"><divclass="hgroup"><h2class="title"><spanclass="title">Channel options.</span></h2></div>
<linktype="guide"xref="bookmarks#other"/><linktype="guide"xref="index#extra"/><desc>Programming recurring play and recording events.</desc></info><sectionid="intro"><p>You can programm play/recording events with the timer plugin. Simply select a station
<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 data/time string. If you press <key>OK</key> the station
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><mediatype="image"src="img/timer.png"mime="image/png">Timer</media></p><notestyle="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><sectionid="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 occour on the first
<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>
' d='M14,14H2V2h12v12z'/%3E%3Cpath style='fill:rgb(64,64,64)' d='M13,13H3V3h10v10z'/%3E%3Cpath style='fill:rgb(248,248,248)' d='M12,12H4V4h8v8z'/%3E%3Cpath style='fill:rgb(80,128,208)' d='M11,9H5V7h6v6z'/%3E%3C/svg%3E)
' d='M14,14H2V2h12v12z'/%3E%3Cpath style='fill:rgb(64,64,64)' d='M13,13H3V3h10v10z'/%3E%3Cpath style='fill:rgb(248,248,248)' d='M12,12H4V4h8v8z'/%3E%3Cpath style='fill:rgb(80,128,208)' d='M5,7h2v-2h2v2h2v2h-2v2h-2v-2h-2z'/%3E%3C/svg%3E)
Overview