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

⌈⌋ ⎇ branch:  streamtuner2


Check-in [fb837c37db]

Overview
Comment:Update manual regarding new favicon plugin and its options.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: fb837c37dbed27fb780a1bfc70a6df6aa4a41a5c
User & Date: mario on 2015-05-15 00:31:45
Other Links: manifest | tags
Context
2015-05-15
00:54
Update 0install descriptor to use command/runner with virtual python package. check-in: ed37ec798a user: mario tags: trunk
00:31
Update manual regarding new favicon plugin and its options. check-in: fb837c37db user: mario tags: trunk
2015-05-14
23:26
Set dest= and main= check-in: 395901fa20 user: mario tags: trunk
Changes

Modified help/configuration.page from [2f8c9f912d] to [2c9bf10605].

105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133







134
135
136
137
138
139
140
141

<section id="gui">

  <title>Display/GUI options</title>
  <terms>
    <title>Display settings</title>
    <item>
      <title>Display favicons</title>
      <p>The options for the favicons define if station entries should show little icons.
      Not all stations have one, so you might as well turn this off to conserve a little memory.</p>
    </item>
    <item>
      <title>Load favicons</title>
      <p>When starting to play a station, its homepage favicon is automatically retrieved in the
      background. It's not going to be displayed right away, but after you reload the category/station list.
      Alternatively use <guiseq><gui>Channel</gui> <gui>Update favicons...</gui></guiseq> to update all
      station icons at once.</p>
    </item>
    <item>
      <title>Show bookmark star</title>
      <p>Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p>
    </item>
    <item>
      <title>Save window states</title>
      <p>Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <guiseq><gui>Edit</gui> <gui>Save States</gui></guiseq>.</p>
    </item>







 </terms>

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







<
<
<
<
<
<
<
<
<
<
<
<










>
>
>
>
>
>
>
|







105
106
107
108
109
110
111












112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

<section id="gui">

  <title>Display/GUI options</title>
  <terms>
    <title>Display settings</title>
    <item>












      <title>Show bookmark star</title>
      <p>Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p>
    </item>
    <item>
      <title>Save window states</title>
      <p>Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <guiseq><gui>Edit</gui> <gui>Save States</gui></guiseq>.</p>
    </item>
    <item>
      <title>Update window title</title>
      <p>When switching channel tabs, the Streamtuner2 window title usually gets the current
      channel name appended (such as "- Shoutcast" or "- Xiph"). You can disable this if it
      looks confusing. (Requires a restart to fully take effect.)</p>
    </item>
    <item><title><link type="guide" xref="favicon">→ Favicon plugin options</link></title></item>
  </terms>

  <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.
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
      at the end of the list).</p>
    </item>
    <item>
      <title>Update favouries 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>google station homepages</title>
      <p>When playing a station that doesn't have a homepage entry, streamtuner2 tries to google
      the station title. The found URL is then used/kept as station homepage. (Btw, station titles
      like www.mymusicstation.com are automatically mapped to homepage URLs already.)</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







<
<
<
<
<
<







153
154
155
156
157
158
159






160
161
162
163
164
165
166
      at the end of the list).</p>
    </item>
    <item>
      <title>Update favouries 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>






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

Added help/favicon.page version [affccaf001].



















































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="favicon">

<info>
	<link type="guide" xref="index#extra"/>
        <desc>Favicons</desc>
</info>

<title>Station favicons</title>

<p>Per default you'll get a small logo / icon for any station
with a homepage link. They're automatically fetched and displayed
as soon as you play a radio entry.</p>

<p>This functionality meanwhile resides in a plugin. It's available in the
<key>🔌 Features</key> <link xref="configuration">configuration</link> tab. 
You can disable it as whole if unneeded.  Most configuration options are now
collected there.</p>

<p>Some channels (Jamendo or Radionomy) provide small album previews
or banners (Punkcast) even. Whereas normal favicons are just 16x16
pixel images.</p>

<p>Downloaded image files are meanwhile all sanitized (internally
converted to ensure they're really image files).
Albeit that's not strictly necessary for modern Gtk versions. (But
better safe than sorry).
Images are kept in the <file>~/.config/streamtuner2/icons</file> directory.
</p>


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

<terms>
  <item>
    <title>Load favicons on playing</title>
    <p>When starting to play a station, its homepage favicon is automatically downloaded
    in the background. It's even displayed right away as soon as it's there. You can
    also have a whole category/genre list updated right away per menu command
    <guiseq><gui>Channel</gui> <gui>Update favicons...</gui></guiseq>.</p>
  </item>
  <item>
    <title>Homepage googling</title>
    <p>When playing a station that doesn't have a homepage entry, streamtuner2 tries
    to google the station title. The found URL is then used/kept as station homepage.
    This isn't super exact however, so you might end up with homepages and icons
    from Wikipedia, Twitter, Facebook or something for generic radio station names.
    (Btw, station titles like www.mymusicstation.com are automatically mapped to
    homepage URLs already.)</p>
  </item>
  <item>
    <title>Use Google favicon service</title>
    <p>Downloading favicons directly from station homepages can sometimes be
    a little slow. Which is because it requires to inspect the homepage
    itself first, and then uncovering an image resource. The Google method
    instead uses <cmd>http://www.google.com/s2/favicons?domain=www.example.com</cmd>
    to fetch a PNG icon right away. Which is often faster. You might want to
    disable this for privacy reasons though.</p>
  </item>
  <item>
    <title>Omit placeholders</title>
    <p>Oftentimes the Google favicon service sends back a placeholder icon
    (a blue mini globe), which doesn't look very interesting. So you might
    want to disable those. (They're still downloaded, but just not saved in
    the cache directory.)</p>
  </item>
</terms>

</section>

</page>

Modified help/html/bookmarks.html from [c69a388fc3] to [50bc096509].

15
16
17
18
19
20
21
22
23
24
25


26
27
28
29
30
31
32
33
34
35
36
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Bookmarks</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Streamtuner2 allows to bookmark favoured streams/stations.
	Which is what the <span class="gui">bookmarks</span> tab is for, of course.</p>
<p class="p">Use right click for a stations <span class="guiseq"><span class="gui">context menu</span> ▸ <span class="gui">bookmark</span></span>
        or just press <span class="key"><kbd>F8</kbd></span>.</p>


<p class="p">Once bookmarked the station is listed under
        <span class="guiseq"><span class="gui">bookmarks</span> ▸ <span class="gui">favourite</span></span>.
        Additionally every appearance of the station in channel tabs gets a ★
        star icon.</p>
</div>
<div id="editing" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Editing</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Entries can be removed from the bookmark list again. Use
        <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Delete</span></span> or the <span class="key"><kbd>DEL</kbd></span>
	key for that.</p>







|
|
|
|
>
>
|
<
|
|







15
16
17
18
19
20
21
22
23
24
25
26
27
28

29
30
31
32
33
34
35
36
37
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#channels" title="Channel tabs">Channel tabs</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Bookmarks</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Streamtuner2 allows to bookmark favourite streams/stations.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Use right click for a stations <span class="guiseq"><span class="gui">context menu</span> ▸ <span class="gui">bookmark</span></span></p></li>
<li class="list"><p class="p">Or just press <span class="key"><kbd>F8</kbd></span> on a selected radio.</p></li>
<li class="list"><p class="p">Else use the main menu <span class="guiseq"><span class="gui">Station</span> ▸ <span class="gui">bookmark</span></span></p></li>
</ul></div></div></div>
<p class="p">Once bookmarked the station is listed under <span class="guiseq"><span class="gui"><span class="key"><kbd>bookmarks</kbd></span></span> ▸ <span class="gui"><span class="key"><kbd>favourite</kbd></span></span></span>.</p>

<p class="p">Additionally every appearance of the station in other channel
        tabs gets a ★ star icon.</p>
</div>
<div id="editing" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Editing</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Entries can be removed from the bookmark list again. Use
        <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Delete</span></span> or the <span class="key"><kbd>DEL</kbd></span>
	key for that.</p>

Modified help/html/configuration.html from [4d19e29f05] to [1a042d5b7d].

111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132






133
134
135
136
137
138
139
</div></div>
<div id="gui" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Display/GUI options</span></h2></div>
<div class="region"><div class="contents">
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Display settings</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">Display favicons</dt>
<dd class="terms"><p class="p">The options for the favicons define if station entries should show little icons.
      Not all stations have one, so you might as well turn this off to conserve a little memory.</p></dd>
<dt class="terms">Load favicons</dt>
<dd class="terms"><p class="p">When starting to play a station, its homepage favicon is automatically retrieved in the
      background. It's not going to be displayed right away, but after you reload the category/station list.
      Alternatively use <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update favicons...</span></span> to update all
      station icons at once.</p></dd>
<dt class="terms">Show bookmark star</dt>
<dd class="terms"><p class="p">Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p></dd>
<dt class="terms">Save window states</dt>
<dd class="terms"><p class="p">Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Save States</span></span>.</p></dd>






</dl></div>
</div></div>
<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







<
<
<
<
<
<
<
<







>
>
>
>
>
>







111
112
113
114
115
116
117








118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
</div></div>
<div id="gui" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Display/GUI options</span></h2></div>
<div class="region"><div class="contents">
<div class="terms"><div class="inner">
<div class="title title-terms"><h3><span class="title">Display settings</span></h3></div>
<div class="region"><dl class="terms">








<dt class="terms">Show bookmark star</dt>
<dd class="terms"><p class="p">Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p></dd>
<dt class="terms">Save window states</dt>
<dd class="terms"><p class="p">Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <span class="guiseq"><span class="gui">Edit</span> ▸ <span class="gui">Save States</span></span>.</p></dd>
<dt class="terms">Update window title</dt>
<dd class="terms"><p class="p">When switching channel tabs, the Streamtuner2 window title usually gets the current
      channel name appended (such as "- Shoutcast" or "- Xiph"). You can disable this if it
      looks confusing. (Requires a restart to fully take effect.)</p></dd>
<dt class="terms"><span class="link"><a href="favicon.html" title="Station favicons">→ Favicon plugin options</a></span></dt>
<dd class="terms"></dd>
</dl></div>
</div></div>
<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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throws 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 favouries 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">google station homepages</dt>
<dd class="terms"><p class="p">When playing a station that doesn't have a homepage entry, streamtuner2 tries to google
      the station title. The found URL is then used/kept as station homepage. (Btw, station titles
      like www.mymusicstation.com are automatically mapped to homepage URLs already.)</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,







<
<
<
<







149
150
151
152
153
154
155




156
157
158
159
160
161
162
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throws 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 favouries 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>




</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,

Modified help/html/edit.html from [b8d781a778] to [123577a9a3].

13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> » <a class="trail" href="index.html#functions" title="Functions">Functions</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Edit</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">You probably don't often need this. But there's an
	<span class="guiseq"><span class="gui"></span> ▸ <span class="gui">Edit/Details</span></span> context menu
	which brings up a station editor:
	</p>
<div class="media media-image"><div class="inner"><img src="img/streamedit.png" class="media media-block" alt=""></div></div>
<p class="p">You can see the standard title and genre fields here. But also a
	few internally kept infos. For example the "url" field contains the
	actual pls/m3u/server address. While the "format" can list a







|







13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<div class="trail">
<a class="trail" href="index.html" title="♪ Streamtuner2"><span class="media"><span class="media media-image"><img src="img/logo.png" class="media media-inline" alt="♪"></span></span> Streamtuner2 </a> › <a class="trail" href="index.html#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a> » <a class="trail" href="streams.html" title="Streams / Stations">Streams / Stations</a> » <a class="trail" href="index.html#functions" title="Functions">Functions</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Edit</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">You probably won't need this often. But there's an
	<span class="guiseq"><span class="gui"></span> ▸ <span class="gui">Edit/Details</span></span> context menu
	which brings up a station editor:
	</p>
<div class="media media-image"><div class="inner"><img src="img/streamedit.png" class="media media-block" alt=""></div></div>
<p class="p">You can see the standard title and genre fields here. But also a
	few internally kept infos. For example the "url" field contains the
	actual pls/m3u/server address. While the "format" can list a

Added help/html/favicon.html version [f280a45035].





























































































































































>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>Station favicons</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="jquery.syntax.js"></script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><div class="page" role="main">
<div class="header"><div class="trails" role="navigation">
<div class="trail">
<a class="trail" href="glossary.html" title="Glossary">Glossary</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
<div class="trail">
<a class="trail" href="technical.html" title="Technical information">Technical information</a> » <a class="trail" href="index.html#extra" title="Additional features">Additional features</a> » </div>
</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Station favicons</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Per default you'll get a small logo / icon for any station
with a homepage link. They're automatically fetched and displayed
as soon as you play a radio entry.</p>
<p class="p">This functionality meanwhile resides in a plugin. It's available in the
<span class="key"><kbd>🔌 Features</kbd></span> <span class="link"><a href="configuration.html" title="Settings dialog">configuration</a></span> tab. 
You can disable it as whole if unneeded.  Most configuration options are now
collected there.</p>
<p class="p">Some channels (Jamendo or Radionomy) provide small album previews
or banners (Punkcast) even. Whereas normal favicons are just 16x16
pixel images.</p>
<p class="p">Downloaded image files are meanwhile all sanitized (internally
converted to ensure they're really image files).
Albeit that's not strictly necessary for modern Gtk versions. (But
better safe than sorry).
Images are kept in the <span class="file">~/.config/streamtuner2/icons</span> directory.
</p>
</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration options</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">Load favicons on playing</dt>
<dd class="terms"><p class="p">When starting to play a station, its homepage favicon is automatically downloaded
    in the background. It's even displayed right away as soon as it's there. You can
    also have a whole category/genre list updated right away per menu command
    <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Update favicons...</span></span>.</p></dd>
<dt class="terms">Homepage googling</dt>
<dd class="terms"><p class="p">When playing a station that doesn't have a homepage entry, streamtuner2 tries
    to google the station title. The found URL is then used/kept as station homepage.
    This isn't super exact however, so you might end up with homepages and icons
    from Wikipedia, Twitter, Facebook or something for generic radio station names.
    (Btw, station titles like www.mymusicstation.com are automatically mapped to
    homepage URLs already.)</p></dd>
<dt class="terms">Use Google favicon service</dt>
<dd class="terms"><p class="p">Downloading favicons directly from station homepages can sometimes be
    a little slow. Which is because it requires to inspect the homepage
    itself first, and then uncovering an image resource. The Google method
    instead uses <span class="cmd">http://www.google.com/s2/favicons?domain=www.example.com</span>
    to fetch a PNG icon right away. Which is often faster. You might want to
    disable this for privacy reasons though.</p></dd>
<dt class="terms">Omit placeholders</dt>
<dd class="terms"><p class="p">Oftentimes the Google favicon service sends back a placeholder icon
    (a blue mini globe), which doesn't look very interesting. So you might
    want to disable those. (They're still downloaded, but just not saved in
    the cache directory.)</p></dd>
</dl></div></div></div></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><li class="links "><a href="index.html#extra" title="Additional features">Additional features</a></li></ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>

Modified help/html/index.html from [8dff2fe16e] to [fdcf65fb91].

100
101
102
103
104
105
106

107
108
109
110

111
112
113
114
115
116
117
<div class="hgroup"><h2 class="title"><span class="title">Additional features</span></h2></div>
<div class="region">
<div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="cli.html" title="CLI (command line interface)"><span class="title">CLI (command line interface)</span><span class="linkdiv-dash"> — </span><span class="desc">Console interface, exporting data.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="dragndrop.html" title="Drag'n'drop"><span class="title">Drag'n'drop</span><span class="linkdiv-dash"> — </span><span class="desc">Drag and drop support.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="exportcat.html" title="Export all stations"><span class="title">Export all stations</span><span class="linkdiv-dash"> — </span><span class="desc">Exporting a whole category as .pls.</span></a></div>

</div>
<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="global_key.html" title="Global_key"><span class="title">Global_key</span><span class="linkdiv-dash"> — </span><span class="desc">Global keyboard shortcut for radio switching.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="pluginmanager2.html" title="Plugin Manager 2"><span class="title">Plugin Manager 2</span><span class="linkdiv-dash"> — </span><span class="desc">User plugin installation</span></a></div>

<div class="linkdiv "><a class="linkdiv" href="timer.html" title="Timer"><span class="title">Timer</span><span class="linkdiv-dash"> — </span><span class="desc">Programming recurring play and recording events.</span></a></div>
</div>
</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"><h3><span class="title">More Information</span></h3></div>







>


<

>







100
101
102
103
104
105
106
107
108
109

110
111
112
113
114
115
116
117
118
<div class="hgroup"><h2 class="title"><span class="title">Additional features</span></h2></div>
<div class="region">
<div class="contents"><div class="links topiclinks"><div class="inner"><div class="region">
<div class="links-twocolumn">
<div class="linkdiv "><a class="linkdiv" href="cli.html" title="CLI (command line interface)"><span class="title">CLI (command line interface)</span><span class="linkdiv-dash"> — </span><span class="desc">Console interface, exporting data.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="dragndrop.html" title="Drag'n'drop"><span class="title">Drag'n'drop</span><span class="linkdiv-dash"> — </span><span class="desc">Drag and drop support.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="exportcat.html" title="Export all stations"><span class="title">Export all stations</span><span class="linkdiv-dash"> — </span><span class="desc">Exporting a whole category as .pls.</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="global_key.html" title="Global_key"><span class="title">Global_key</span><span class="linkdiv-dash"> — </span><span class="desc">Global keyboard shortcut for radio switching.</span></a></div>
</div>
<div class="links-twocolumn">

<div class="linkdiv "><a class="linkdiv" href="pluginmanager2.html" title="Plugin Manager 2"><span class="title">Plugin Manager 2</span><span class="linkdiv-dash"> — </span><span class="desc">User plugin installation</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="favicon.html" title="Station favicons"><span class="title">Station favicons</span><span class="linkdiv-dash"> — </span><span class="desc">Favicons</span></a></div>
<div class="linkdiv "><a class="linkdiv" href="timer.html" title="Timer"><span class="title">Timer</span><span class="linkdiv-dash"> — </span><span class="desc">Programming recurring play and recording events.</span></a></div>
</div>
</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"><h3><span class="title">More Information</span></h3></div>

Modified help/html/internet_radio_org_uk.html from [7f2212e65a] to [b5a4e507ec].

24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
</div>
<div class="region">
<div class="contents">
<p class="p">Internet-Radio.com is a broad alternative to Shoutcast.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">It has regained station homepages for most entries again.</p></li>
<li class="list"><p class="p">Genres are similiar to Shoutcast.</p></li>
<li class="list"><p class="p">Updating station list is comperatively fast.</p></li>
</ul></div></div></div>
</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"><p class="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></div></div>







|







24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
</div>
<div class="region">
<div class="contents">
<p class="p">Internet-Radio.com is a broad alternative to Shoutcast.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">It has regained station homepages for most entries again.</p></li>
<li class="list"><p class="p">Genres are similiar to Shoutcast.</p></li>
<li class="list"><p class="p">Updating station lists is comperatively fast.</p></li>
</ul></div></div></div>
</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"><p class="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></div></div>

Modified help/html/pluginmanager2.html from [8e973d6b44] to [ef7eb180e0].

21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">See the <span class="key"><kbd>F12</kbd></span> config dialog <span class="key"><kbd>🔌 Feature</kbd></span> section.</p></li>
<li class="steps"><p class="p">Enable the <span class="key"><kbd>⨯</kbd></span> Plugin Manager (listed near the end).</p></li>
<li class="steps"><p class="p">Restart streamtuner2 one last time for this change to take effect.</p></li>
</ol></div></div></div>
<p class="p">Once acticated it brings up a new <span class="key"><kbd>📦 Add</kbd></span> tab
	in the configuration window.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/pluginmanager2.png" class="media media-inline" alt="Install dialog for user plugins"></span></span></p>
<p class="p">You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <span class="key"><kbd>📻 Channels</kbd></span> or <span class="key"><kbd>🔌 Feature</kbd></span> tabs, and
	then enable them.</p>







|







21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
	features), there's a user plugin manager. It's available as
	feature extension itself.</p>
<div class="steps"><div class="inner"><div class="region"><ol class="steps">
<li class="steps"><p class="p">See the <span class="key"><kbd>F12</kbd></span> config dialog <span class="key"><kbd>🔌 Feature</kbd></span> section.</p></li>
<li class="steps"><p class="p">Enable the <span class="key"><kbd>⨯</kbd></span> Plugin Manager (listed near the end).</p></li>
<li class="steps"><p class="p">Restart streamtuner2 one last time for this change to take effect.</p></li>
</ol></div></div></div>
<p class="p">Once activated it brings up a new <span class="key"><kbd>📦 Add</kbd></span> tab
	in the configuration window.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/pluginmanager2.png" class="media media-inline" alt="Install dialog for user plugins"></span></span></p>
<p class="p">You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not
	implictly enabled. Reopen the config dialog to see them in the
	regular <span class="key"><kbd>📻 Channels</kbd></span> or <span class="key"><kbd>🔌 Feature</kbd></span> tabs, and
	then enable them.</p>

Modified help/html/radionomy.html from [95ff47f743] to [b0a7bbb300].

31
32
33
34
35
36
37
38


39
40
41
42
43
44
45
<p class="p">Their primary directory on Radionomy.com only lists stations
	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 class="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.)


	</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">
<p class="p"> You can configure the number of pages it'll try (<span class="key"><kbd>3</kbd></span> by
  	 default) to influence the length of station lists.</p>







|
>
>







31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
<p class="p">Their primary directory on Radionomy.com only lists stations
	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 class="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>
</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">
<p class="p"> You can configure the number of pages it'll try (<span class="key"><kbd>3</kbd></span> by
  	 default) to influence the length of station lists.</p>

Modified help/html/xiph.html from [9154159e18] to [7ba00185db].

20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

37
38
39
40
41
42
43
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Xiph.org</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://dir.xiph.org/" title="http://dir.xiph.org/">//dir.xiph.org/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">Xiph.org is a non-profit organization, which develops and
	promotes the OGG streaming format, and develops audio compression
	schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
	enve.  It also hosts a list of ICEcast streaming stations. ICEcast
	is their non-commercial pendant to the SHOUTcast server.</p>
<p class="p">This channel is somehwat easy to read for Streamtuner2, because the source data is already
        provided as &lt;XML&gt; file. (Internally we're using a caching service, which pre-converts
        that into JSON lists. The Xiph-org JSON API isn't really working yet).</p>
<p class="p">However, it lacks some essential informations like station homepages and listener numbers.</p>
<p class="p">Xiph also uses the .xspf format, instead of .pls stream links</p>

</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Filter by minimum bitrate</span></dt>
<dd class="terms"><p class="p">The bitrate of an audio stream determines the music quality. Many Xiph streams have simple
    and low quality microphone sources. To filter these out, and only leave high quality music







|


|

|
|
|
|
|
>







20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">Xiph.org</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://dir.xiph.org/" title="http://dir.xiph.org/">//dir.xiph.org/</a></span></span></h2>
</div>
<div class="region">
<div class="contents">
<p class="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 class="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 class="p">Xiph also uses the .xspf playlist format, instead of just the
        more ancient Shoutcast .pls stream links.</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel options.</span></h2></div>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Filter by minimum bitrate</span></dt>
<dd class="terms"><p class="p">The bitrate of an audio stream determines the music quality. Many Xiph streams have simple
    and low quality microphone sources. To filter these out, and only leave high quality music
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
        to keep the whole YP.XML in memory. Which avoids the
        slow station list download/unpacking.
        </p>
</dd>
<dt class="terms"><span class="code">Forbidden fruits</span></dt>
<dd class="terms">
<p class="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 like/encourage. 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 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.
        And the server search function, or browsing by audio/video format is
        supported.
        </p>
</dd>
</dl></div></div></div>
</dd>
</dl></div></div></div></div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>







|
|
|
|
|
<
|
|
|
<







70
71
72
73
74
75
76
77
78
79
80
81

82
83
84

85
86
87
88
89
90
91
        to keep the whole YP.XML in memory. Which avoids the
        slow station list download/unpacking.
        </p>
</dd>
<dt class="terms"><span class="code">Forbidden fruits</span></dt>
<dd class="terms">
<p class="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 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>

</dd>
</dl></div></div></div>
</dd>
</dl></div></div></div></div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>