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

โŒˆโŒ‹ โŽ‡ branch:  streamtuner2


Check-in [85483dd69b]

Overview
Comment:Added more icons for plugins and config options in manual.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 85483dd69bc626142bd0bbe7fa9d64869f23b54a
User & Date: mario on 2016-11-29 14:25:19
Other Links: manifest | tags
Context
2016-11-29
14:25
Introduce some application presets for Windows. check-in: c19b8437e6 user: mario tags: trunk
14:25
Added more icons for plugins and config options in manual. check-in: 85483dd69b user: mario tags: trunk
2016-11-28
15:03
Shortened installer scripts. check-in: 3e9c42bcec user: mario tags: trunk
Changes

Modified help/action_recording.page from [ee64709a1b] to [091dc7fc96].

12
13
14
15
16
17
18
19



20
21
22
23
24
25
26
12
13
14
15
16
17
18

19
20
21
22
23
24
25
26
27
28







-
+
+
+







<title>Recording</title>

<p>Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool <app>streamripper</app>.  If you
select a station and press <gui style="button">โ— record</gui>, a console
window should appear, where streamripper shows its progress.</p>

<p>You can <link xref="configuration">configure the recording tool</link> according to audio types again.</p>
<p>You can <link xref="configuration">configure the recording tool</link>
according to audio types again. Usually you want to use the <link
xref="config_apps#placeholders"><cmd>%srv</cmd> placeholder</link>.</p>

<section>
<title>Streamripper</title>

<p>There's already a default entry for recording radio stations:</p>

<table shade="rows" rules="rows cols">

Modified help/channel_filtermusic.page from [4c8bd69a04] to [c3121e9cf5].

22
23
24
25
26
27
28

29









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

30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45







+
-
+
+
+
+
+
+
+
+
+







        </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>
	<p>Like the <link xref="channel_xiph">๐Ÿ“ป Xiph plugin</link> this channel provides
	<p>Like the Xiph plugin this channel provides two/three fetch modes.</p>
	three fetch modes:</p>
        <list>
         <item><title>Website</title><p>Extract all streams from the web page
         directly.</p></item>
         <item><title>XML Data</title><p>Use <file>๐Ÿ’พ list.2.0.xml</file> which
         the channel service provides directly.</p></item>
         <item><title>Buffered</title><p>Keeps the XML file in memory. (It
         rarely changes.)</p></item>
        </list>
	<note><p>
	There's no speed or feature differences this time. You might prefer
	the buffered mode, as it reduces update requests, but still allows
	refreshing lists.</p></note>
	</section>

</page>

Modified help/channel_internetradioorguk.page from [fbdf425f4d] to [f47df4c392].

19
20
21
22
23
24
25



26
27
28





29
30
31
19
20
21
22
23
24
25
26
27
28



29
30
31
32
33
34
35
36







+
+
+
-
-
-
+
+
+
+
+



 	 <item><p>Genres are similiar to Shoutcast.</p></item>
 	 <item><p>Updating station lists is comperatively fast.</p></item>
 	 <item><p>Uses HTML extraction (regex or pyquery) internally.</p></item>
 	</list>

        <section id="options">
        <title>Configuration</title>
	<list>
 	 <item>
 	 <title>๐Ÿ”Ÿ pages to fetch</title>
	<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>
         <p>Note that this plugin has its own setting on how many
         links to retrieve.  Instead of stream numbers, it only counts pages.
         Which is because this directly influences the stream loading time.</p>
 	 </item>
 	</list>
	</section>

</page>

Modified help/channel_jamendo.page from [91c750617b] to [a3cb7a760f].

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







-
+





-
+




-
+









<p>Tracks and albums can be downloaded free of charge (Creative Commons). Yeah, imagine that.</p>

<section id="options">
<title><link xref="configuration">Config</link> options</title>
<terms>
   <title>System</title>
   <item>
     <title>Streaming format</title>
     <title>๐Ÿ”  Streaming format</title>
     <p>You can switch between MP3 and Ogg Vorbis audio streams for Jamendo.
     It's not honored by the radio section, but albums and tracks should be
     received as Ogg when configured so.</p>
   </item>
   <item>
     <title>Preview image sizes</title>
     <title>๐Ÿ”  Preview image sizes</title>
     <p>Album covers are downloaded in lieu of favicons. They're available
     in different sizes. Use 25px if you want just favicon-sized icons.</p>
   </item>
   <item>
     <title>Result length</title>
     <title>๐Ÿ”Ÿ Result length</title>
     <p>Currently only 1 page (of 200 entries each) of album/track lists are
     fetched.</p>
     <note style="bug"><p>Setting a higher value may not work.</p></note>
   </item>
</terms>
</section>


</page>

Modified help/channel_modarchive.page from [822e78a708] to [b8c3f209ac].

20
21
22
23
24
25
26
27

28
29
30
31

32
33
34











35
36
37
38
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







-
+
-
-
-
-
+


-
+
+
+
+
+
+
+
+
+
+
+




             <item><p>MODPlug for XMMS</p></item>
             <item><p>GModplay</p></item>
             <item><p>VLC (built-in support)</p></item>
        </list>
        
        <section id="options">
        <title>Configuration</title>
        

	<p>See <link xref="recording">recording configuration</link> if you
	want to enable the download mode.</p>

	<note><p>Audio files are packaged up in ZIP files on MODArchive. 
	<p>Audio files are packaged up in ZIP files on MODArchive. 
	While they are different formats (IT, S3M, XM, etc) they'll all
	carry a generic <var>audio/mod+zip</var> type specifier in
	streamtuner2.</p></note>
	streamtuner2 for configuration:</p>
	
        <table shade="rows" rules="rows cols">
            <tr><td rowspan="2">Recording apps</td></tr>
            <tr><td><p><var>audio/mod+zip</var></p></td>   <td><p><cmd>cd ~/Music ; wget %srv</cmd></p></td></tr>
        </table>
        
	<p>You can use <cmd>curl</cmd>, or wrap the command with <cmd>xterm</cmd>
	(though files are too quick to download).
	A few file managers might be able to open the URLs directly even.
	See <link xref="recording">recording configuration</link> for more examples.</p>
	
	</section>

</page>

Modified help/channel_radionomy.page from [4d449eebb2] to [9665e5d575].

27
28
29
30
31
32
33



34
35
36
37
38
39










40
41
42
43
27
28
29
30
31
32
33
34
35
36






37
38
39
40
41
42
43
44
45
46
47
48
49
50







+
+
+
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+




to autoplay advertisements, and a minimum quota of daily listeners). 
Radionomy is therefore pretty popular and growing.</p>


<section id="options">
 <title>Configuration</title>
 
 <list>
 <item>
  <title>๐Ÿ”Ÿ Number of pages</title>
 <p> You can configure the number of pages it'll try (<key>3</key> by
 default) to influence the length of station lists.</p>

 <p> And the song title updating ("<key>OnAir Updates</key>") can be disabled.
 Future versions of this channel plugin might poll it automatically,
 and keep the station list auto-updated.</p>
  <p> You can configure the number of pages it'll try (<key>3</key> by
  default) to influence the length of station lists.</p>
 </item>
 <item>
  <title>โ˜‘ OnAir updates</title>
  <p> And the song title updating can be disabled (for speedier loading).
  Future versions of this channel plugin might poll it automatically,
  and keep the station list auto-updated.</p>
 </item>
 </list>

</section>

</page>

Modified help/channel_surfmusik.page from [1332e13d5f] to [3f9fdb1325].

24
25
26
27
28
29
30
31

32

33

34
35
36
37
38
39
24
25
26
27
28
29
30

31
32
33

34
35
36
37
38
39
40







-
+

+
-
+






        <note style="bug"><p>The MusicTV and NewsTV sections also return results, but those are mostly
        web-based video stations. Some of them are outdated links even.</p></note>

<section id="options">
  <title>Channel options.</title>
  <terms>
  <item>
    <title><code>Language</code></title>
    <title><code>๐Ÿ”  Language</code></title>
    <p>There's an English and a German variant of this radio directory. Genres are
    also localized.</p>
    also localized. Restart streamtuner2 after switching the Language option. Then
    <p>Restart streamtuner2 after switching the Language option. Then
    use <guiseq><gui>Channel</gui> <gui>Reload category tree</gui></guiseq>.</p>
  </item>
  </terms>
</section>

</page>

Modified help/channel_xiph.page from [a7041b6e17] to [abe76d071b].

67
68
69
70
71
72
73
74

75
76
77
67
68
69
70
71
72
73

74
75
76
77







-
+



    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>
  <p>The filter-by-bitrate option is now a generic plugin.</p>
</section>

</page>

Modified help/channel_youtube.page from [c1ab70c569] to [89d58ec22a].

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







-
+



-
+






-
+






        opening it in your web browser - click the station <key>home</key>
        button simply.</p>

        <section id="options">
          <title>Channel options.</title>
          <terms>
          <item>
            <title><code>Region</code></title>
            <title><code>๐Ÿ”  Region</code></title>
            <p>With the country dropdown you can predefine which mostPopular listings are returned.</p>
          </item>
          <item>
            <title><code>My Channels</code></title>
            <title><code>๐Ÿ”  My Channels</code></title>
            <p>You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
            To apply this setting, and have new categories show up in the genre pane, use
            <guiseq><gui>Channel</gui> <gui>Update category tree</gui></guiseq> first.</p>
            <p>It's not an exact map, but utilizes the search function to find channels.</p>
          </item>
          <item>
            <title><code>Wadsworth constant</code></title>
            <title><code>โ˜‘ Wadsworth constant</code></title>
            <p>Only influences the video homepage link.</p>
          </item>
          </terms>
        </section>

</page>

Modified help/config_apps.page from [7cbf0941ba] to [4f14b73fc7].

139
140
141
142
143
144
145
146

147
148
149
150
151

152
153
154
155
156
157
158
159
160
139
140
141
142
143
144
145

146
147
148
149
150

151
152
153
154
155
156
157
158
159
160







-
+




-
+









</section>

<section id="windows">
<title>Windows config</title>
<p>There's a few things you have to take care of when configuring players
and recording apps on Windows. Common applications and settings would be:</p>
<table shade="rows" rules="rows cols">
  <tr><td colspan="3"><p><strong>Player config</strong></p></td></tr>
  <tr><td colspan="3"><p><em>Player config</em></p></td></tr>
  <tr><td><p><app>audio/mpeg</app></p></td>  <td><p><cmd>wmplayer.exe %asx</cmd></p></td>   <td><note style="bug"><p>Windows media player doesn't understand PLS or M3U files.</p></note></td></tr>
  <tr><td><p><app>video/*</app></p></td>     <td><p><cmd>C:\Programs\VLC\vlc.exe %srv</cmd></p></td>   <td><note style="info"><p>VLC pretty much works alike on Windows.</p></note></td></tr>
  <tr><td><p><app>url/http</app></p></td>    <td><p><cmd>"C:/Program Files/Mozilla Firefox/firefox.exe" %url</cmd></p></td>   <td><note style="info"><p>It's best to enclose paths with spaces in quotes.</p></note></td></tr>
  <tr><td><p><app>url/http</app></p></td>    <td><p><cmd>iexplore.exe %url</cmd></p></td>   <td><note style="note"><p>IE is not recommended, of course.</p></note></td></tr>
  <tr><td colspan="3"><p><strong>Recording apps</strong></p></td></tr>
  <tr><td colspan="3"><p><em>Recording apps</em></p></td></tr>
  <tr><td><p><app>audio/*</app></p></td>     <td><p><cmd>/D "C:\Programs\Streamripper" streamripper.exe %srv</cmd></p></td>   <td><note style="bug"><p>Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program.</p></note></td></tr>
</table>
<p>You can avoid a few issues: if you put your executables in paths without
spaces, or set the system $PATH variable accordingly.</p>
<note style="info"><p>As reported by Oliver in the sourceforge Discussion
board.</p></note>
</section>

</page>

Modified help/configuration.page from [627ed3ce23] to [2e4f242f00].

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
79
80
81
82
83
84



















85
86
87
88
89
90
91
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
79
80









81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106







+
-
-
+
+
+
-
-
-
-
+
-
-
-
-
-
-
-
+
+
+
+
+
-

-
+
-
-
+
+
+
+
+
+
+
+

+
+
+
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








    <title>Player application settings</title>

    <p>MIME types are abstract identifiers for media types. <var>Audio/mpeg</var> for
    example represents MP3 files, and <var>audio/ogg</var> means OGG Vorbis.  And the player
    setting dialog simply associates an audio type with a playback application:</p>

    <p><media type="image" src="img/configapps.png" mime="image/png" /></p>
<table shade="rows" rules="rows cols">
  <thead>  <tr><td><p>Format</p></td>     <td><p>Application</p></td></tr> </thead>

    <list>
      <item><p><link xref="config_apps">Application names</link> are most
    <tr><td><p><var>audio/mpeg</var></p></td>     <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/ogg</var></p></td>      <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/*</var></p></td>        <td><p><cmd>vlc --one-instance</cmd></p></td></tr>
    <tr><td><p><var>video/*</var></p></td>        <td><p><cmd>totem</cmd></p></td></tr>
      always lowercase binary names.</p></item>
    <tr><td><p><var>video/youtube</var></p></td>  <td><p><cmd>vlc %srv</cmd></p></td></tr>
</table>

    <p>Application names are most always lowercase binary names. Double click an entry to edit it.
    After editing, the icon next to the application name will be updated. If it stays green, it's
    likely to work. If it turns red / into a stop symbol, then the entered name is likely incorrect.</p>

      
      <item><p> Double click an entry to edit it. After editing, the icon
      next to the application name will be updated.  If it stays green, it's
      likely to work.  If it turns red / into a stop symbol, then the
      entered name is likely incorrect. (Only works on U*ix-systems.)</p></item>
   <p><media type="image" src="img/configapps.png" mime="image/png" /></p>

    <p>After the application name, you can optionally use a placeholder like "<var>%pls</var>" (default),
      <item><p>After the application name, you can optionally use
    "<var>%m3u</var>" (old), or "<var>%xspf</var>" (modern), and "<var>%srv</var>" (for direct
    streaming URLs). See <link xref="config_apps#placeholders">placeholders</link>.</p>
      <link xref="config_apps#placeholders">a placeholder</link>:</p>
        <list>
        <item><p><var>%pls</var> โ†’ default format</p></item>
        <item><p><var>%m3u</var> โ†’ older scheme</p></item>
        <item><p><var>%xspf</var> โ†’ modern playlists,</p></item>
        <item><p><var>%srv</var> โ†’ for direct streaming URLs</p></item>
        </list>
      </item>

      <item><p>The format entries can specify generic or custom handlers:</p>
      <list>
        <item><p>Catch-all specifiers like <var>*/*</var> or a generic
    <p>Catch-all entries like <var>*/*</var> or a generic <var>audio/*</var> entry allow to
    configure a default player.  While <var>video/youtube</var> is specific to the Youtube
    channel.  And <var>url/http</var> a pseudo MIME type to configure a web browser (for
    station homepages).</p>
    
    <p>In practice you only need one entry for <var>audio/*</var> and one for
    <var>video/*</var>, both can use the same player even.  You can remove default entries by
    clearing both the Format field and its associated Application.  Add completely new
    associations through the emtpy line.  (Reopen the dialog to add another one.)</p>
        <var>audio/*</var> entry allow to configure a default
        player.</p></item>
        
        <item><p>While <var>video/youtube</var> is specific to the Youtube
        channel.</p></item>
        
        <item><p>And <var>url/http</var> a pseudo MIME type to configure a
        web browser (for station homepages).</p></item>
      </list>
      </item>

      <item><p>In practice you only needed one entry for <var>audio/*</var>
      and one for <var>video/*</var>, both can use the same player even. 
      </p></item>

      <item><p> You can remove existing entries by clearing both the Format
      field and its associated Application.  Add completely new associations
      through the emtpy line.  </p></item>
    </list>

</section>
<section id="recording">

    <title>Recording Apps</title>

    <p>The second block of entries in the 'Apps' section specifies recording applications.
228
229
230
231
232
233
234

235
236
237






238
239
240
241
242
243
244
243
244
245
246
247
248
249
250



251
252
253
254
255
256
257
258
259
260
261
262
263







+
-
-
-
+
+
+
+
+
+







 </terms>

</section>

<section id="plugins">
    <title>Channel and feature plugins and settings</title>

    <table><tr>
    <p>The tabs <key>๐Ÿ“ป Channels</key> lists all available directory services.
    While the <key>๐Ÿ”Œ Features</key> group provides internal or menu enhancements.
    Disabling or enabling a plugin however requires a restart of Streamtuner2
    <td><p>The <key>๐Ÿ“ป Channels</key> tab shows all available directory
    services.</p></td>
    <td><p>While the <key>๐Ÿ”Œ Features</key> group provides internal or menu
    enhancements.</p></td>
    </tr></table>
    <p>Disabling or enabling a plugin however requires a restart of Streamtuner2
    to take effect. (Unless the <link xref="pluginmanager2">Plugin Manager 2</link>
    is enabled, with its <key>๐Ÿ“ฆ Add</key> tab visible.)</p>
    
    
    <p><media type="image" src="img/configplugins.png" mime="image/png" /></p>

    <p>Each plugin can have its own little list of extra options. They'll be

Modified help/contrib_channels.page from [36fa65b88b] to [5f8be5599d].

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
79
80
81

82
83
84
85
86
87

88
89
90
91
92
93
94

95
96
97
98
99
100
101
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
79
80

81
82
83
84
85
86

87
88
89
90
91
92
93

94
95
96
97
98
99
100
101







-
+





-
+






-
+




-
+





-
+



-
+



-
+





-
+



-
+



-
+






-
+






-
+





-
+






-
+








<p>Besides the standard channels, there are a few more plugins available
for download. See the <link xref="pluginmanager2">Plugin Manager</link>
and its <key>๐Ÿ“ฆ Add</key> tab.</p>

<terms>
  <item>
    <title><link href="http://radio.net/">Radio.net</link></title>
    <title>๐Ÿ“ป <link href="http://radio.net/">Radio.net</link></title>
    <p>Radio.net is a European radio directory. It nicely catalogues
    stations into genres as usual. The primary list is ordered by
    popularity even. </p>
  </item>
  <item>
    <title><link href="http://magnatune.com/">Magnatune</link></title>
    <title>๐Ÿ“ป <link href="http://magnatune.com/">Magnatune</link></title>
    <p>Magnatune is an independent label for artists. It makes most
    albums available for free listening with only a few intermittent
    adverts. Otherwise it's a flatrate payable music discovery and
    download service. </p>
  </item>
  <item>
    <title><link href="http://publicradiofan.com/">PublicRadioFan</link></title>
    <title>๐Ÿ“ป <link href="http://publicradiofan.com/">PublicRadioFan</link></title>
    <p>PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p>
  </item>
  <item>
    <title><link href="http://delicast.com/">Delicast</link></title>
    <title>๐Ÿ“ป <link href="http://delicast.com/">Delicast</link></title>
    <p>Delicast.com is another web directory of radio stations. It's
    somewhat slower because playback addresses are hidden away with extra
    page requests. Works reliably still.</p>
  </item>
  <item>
    <title><link href="http://listenlive.eu/">ListenLive.eu</link></title>
    <title>๐Ÿ“ป <link href="http://listenlive.eu/">ListenLive.eu</link></title>
    <p>ListenLive is also an Europe-centric radio directory.</p>
  </item>
  <item>
    <title><link href="http://liveradio.ie/">Liveradio.ie</link></title>
    <title>๐Ÿ“ป <link href="http://liveradio.ie/">Liveradio.ie</link></title>
    <p>Is an Ireland-based radio station directory.</p>
  </item>
  <item>
    <title><link href="http://radiosure.com/">RadioSure</link></title>
    <title>๐Ÿ“ป <link href="http://radiosure.com/">RadioSure</link></title>
    <p>Station database that's readily available as CSV list. You'll
    currently need the tmp_clean_multiurl plugin as well, as most entries
    supply multiple URLs, but action.py doesn't support those currently.</p>
  </item>
  <item>
    <title><link href="http://vtuner.com/">vTuner</link></title>
    <title>๐Ÿ“ป <link href="http://vtuner.com/">vTuner</link></title>
    <p>Categorized station list by a cross-platform streaming service provider. </p>
  </item>
  <item>
    <title><link href="http://reciva.com/">Reciva</link></title>
    <title>๐Ÿ“ป <link href="http://reciva.com/">Reciva</link></title>
    <p>Reciva is an iPhone app, with a browsable station list. </p>
  </item>
  <item>
    <title><link href="http://house-mixes.com/">house-mixes</link></title>
    <title>๐Ÿ“ป <link href="http://house-mixes.com/">house-mixes</link></title>
    <p>House-mixes.com provides a growing collection of DJ mixes (house,
    dance, etc). The website can be used after a free registration to download
    complete MP3s (often in high quality). In Streamtuner2 you can even
    drag and drop them onto your desktop directly.</p>
  </item>
  <item>
    <title><link href="http://punkcast.com/">PunkCast</link></title>
    <title>๐Ÿ“ป <link href="http://punkcast.com/">PunkCast</link></title>
    <p>PunkCast is no longer maintained. It covered the NY music and tech
    scenes, but existing recordings are still accessible mostly (some are
    just weblinks however). This plugin is kept for nostalgic reasons;
    it was available with streamtuner1 as well. </p>
  </item>
  <item>
    <title><p>GrLittleRadioPlayer</p></title>
    <title>๐Ÿ“ป GrLittleRadioPlayer</title>
    <p>Great Little Radio Player is another Linux desktop radio browser.
    It comes with a default set of categorized stations. This plugin merely
    imports that list as static directory. </p>
  </item>
  <item>
    <title><p>Compound</p></title>
    <title>๐Ÿ“ป Compound</title>
    <p>The compound channel is a meta plugin. It can aggregate categories
    from other channel plugins on a per-category basis. You for example
    can mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio,
    Tunein, etc. Which avoids switching between channel tabs somewhat. </p>
  </item>
  <item>
    <title><p>File browser</p></title>
    <title>๐Ÿ“ป File browser</title>
    <p>You can also browse local files with streamtuner2 using the file
    browser plugin. It must be configured with your music collection path.
    It's not a default plugin, because this isn't really what Streamtuner2
    is made for. There are way better local music collection managers for
    Linux. It's just here for convenience, and displays files just as any
    other channel list. It has no specific file management features, and
    won't receive any. </p>

Modified help/contrib_features.page from [19a60ed775] to [c13105275b].

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
79
80
81
82





83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100



101
102
103
104
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
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98


99
100
101
102
103
104
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







-
+













-
+









-
+











-
+









-
+










-
-
-
-
-
+
+
+
+
+
















-
-
+
+
+









-
+



-
+





-
+





-
+

-
+







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


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

<section>
<title>Channel toolbar link</title>
<title>๐Ÿ”Œ Channel toolbar link</title>
<p>Adds a toolbar entry which shows the current channel/directory
service title and its homepage link. Such as:</p>
<code><span style="bold">  โ–ถ    โ—    ๐Ÿ      Shoutcast</span>
play rcrd  hmpg   <link href="http://shoutcast.com/">//shoutcast.com/</link>
</code>
<p>It depends on the "update window title" option being enabled.</p>
</section>

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

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

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

<section>
 <title>Other feature plugins</title>
 <list>
   <item><p><link xref="dragndrop">Drag and Drop</link></p></item>
   <item><p><link xref="favicon">Favicons</link></p></item>
   <item><p><link xref="global_key">Global key shortcut</link></p></item>
   <item><p><link xref="timer">Timer</link></p></item>
   <item><p><link xref="specbuttons">Specbuttons</link></p></item>
   <item><p><link xref="dragndrop">๐Ÿ”Œ Drag and Drop</link></p></item>
   <item><p><link xref="favicon">๐Ÿ”Œ Favicons</link></p></item>
   <item><p><link xref="global_key">๐Ÿ”Œ Global key shortcut</link></p></item>
   <item><p><link xref="timer">๐Ÿ”Œ Timer</link></p></item>
   <item><p><link xref="specbuttons">๐Ÿ”Œ Specbuttons</link></p></item>
 </list>
 <p>The "<link xref="search">search</link>",
 "<link xref="configuration">configwin</link>" and
 "<link xref="edit">streamedit</link>" plugins are considered
 built-ins and cannot be disabled.</p>
</section>


<section id="contrib">
<title>Downloadable contrib/ feature plugins</title>

<p>The <link xref="pluginmanager2">Plugin Manager</link> lists other
available feature plugins in the <key>๐Ÿ“ฆ Add</key> tab.</p>

<terms>
  <item>
    <title><p>Soundcloud streaming</p></title>
    <p>Enables playback of soundcloud.com links in the Reddit plugin.
    <title>๐Ÿ”Œ Soundcloud streaming</title>
    <p>Enables playback of soundcloud.com links, which are only used
    in the <link xref="channel_reddit">๐Ÿ“ป Reddit</link> plugin currently.
    Homepage links are transformed into direct MP3 streaming addresses
    on playback.</p>
    <note><p>Depends on python-soundcloud, which you can install per
    <cmd>pip install soundcloud</cmd>.</p></note>
    <p> Alternatively you could configure an external player like <link
    href="http://github.com/rekado/soundCLI">soundcli</link> of course.
    Use the pseudo type "audio/soundcloud" for the player settings table.</p>
  </item>
  <item>
    <title><p>dev_faulthandler</p></title>
    <title>๐Ÿ”Œ dev_faulthandler</title>
    <p>This is a pure development plugin, meant to debug ST2 crashes.</p>
  </item>
  <item>
    <title><p>bookmarks_show_extra</p></title>
    <title>๐Ÿ”Œ bookmarks_show_extra</title>
    <p>Is a slim UI adaption to show the `extra` field in the bookmarks
    channel. This field can contain user comments, but is used per default
    to store the originating channel in.</p>
  </item>
  <item>
    <title><p>new_station</p></title>
    <title>๐Ÿ”Œ new_station</title>
    <p>Currently not working. Small plugin to provide an "Add station..."
    menu entry. Note that ST2 is not meant as playlist manager, which is
    why this isn't a built-in feature. However, it's oft-requested anyway.</p>
  </item>
  <item>
    <title><p>tmp_clean_multiurl</p></title>
    <title>๐Ÿ”Œ tmp_clean_multiurl</title>
    <p>Strips extra space-separate URLs from station list. (Currently only
    required for RadioSure channel. Later ST2 versions will likely support
    required for ๐Ÿ“ป RadioSure channel. Later ST2 versions will likely support
    such entries per default again).</p>
  </item>
</terms>
</section>

</page>

Modified help/favicon.page from [30e8d787e0] to [1c4a0dc225].

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







-
+






-
+








-
+








-
+












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

<terms>
  <item>
    <title>Load favicons on playing</title>
    <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>
    <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>
    <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>
    <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/config_apps.html from [0b8cb4823e] to [276d7c5c17].

230
231
232
233
234
235
236
237

238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258

259
260
261
262
263
264
265
230
231
232
233
234
235
236

237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257

258
259
260
261
262
263
264
265







-
+




















-
+







</div></div>
<div id="windows" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Windows config</span></h2></div>
<div class="region"><div class="contents">
<p class="p">There's a few things you have to take care of when configuring players
and recording apps on Windows. Common applications and settings would be:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr><td colspan="3"><p class="p">Player config</p></td></tr>
<tr><td colspan="3"><p class="p"><span class="em">Player config</span></p></td></tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">audio/mpeg</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">wmplayer.exe %asx</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">Windows media player doesn't understand PLS or M3U files.</p></div></div></div></div></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">video/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">C:\Programs\VLC\vlc.exe %srv</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">VLC pretty much works alike on Windows.</p></div></div></div></div></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">url/http</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">"C:/Program Files/Mozilla Firefox/firefox.exe" %url</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">It's best to enclose paths with spaces in quotes.</p></div></div></div></div></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">url/http</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">iexplore.exe %url</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">IE is not recommended, of course.</p></div></div></div></div></td>
</tr>
<tr class="shade"><td style="border-top-style: solid;" colspan="3"><p class="p">Recording apps</p></td></tr>
<tr class="shade"><td style="border-top-style: solid;" colspan="3"><p class="p"><span class="em">Recording apps</span></p></td></tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">/D "C:\Programs\Streamripper" streamripper.exe %srv</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program.</p></div></div></div></div></td>
</tr>
</table></div></div></div>
<p class="p">You can avoid a few issues: if you put your executables in paths without

Modified help/html/configuration.html from [c03ec31177] to [2c2c4ff463].

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
79
80








81

82
83
84
85
86
87
88
89
90
91



























92
93
94
95
96
97
98
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94







-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-

+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+







</div>
<div id="apps" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Player application settings</span></h2></div>
<div class="region"><div class="contents">
<p class="p">MIME types are abstract identifiers for media types. <span class="var">Audio/mpeg</span> for
    example represents MP3 files, and <span class="var">audio/ogg</span> means OGG Vorbis.  And the player
    setting dialog simply associates an audio type with a playback application:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>
<td><p class="p">Format</p></td>
<td style="border-left-style: solid;"><p class="p">Application</p></td>
</tr></thead>
<tr>
<td><p class="p"><span class="var">audio/mpeg</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="cmd">audacious</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">audio/ogg</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">audacious</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="var">audio/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc --one-instance</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">video/*</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">totem</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="var">video/youtube</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc %srv</span></p></td>
</tr>
</table></div></div></div>
<p class="p">Application names are most always lowercase binary names. Double click an entry to edit it.
    After editing, the icon next to the application name will be updated. If it stays green, it's
    likely to work. If it turns red / into a stop symbol, then the entered name is likely incorrect.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/configapps.png" class="media media-inline" alt=""></span></span></p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p"><span class="link"><a href="config_apps.html" title="Audio players">Application names</a></span> are most
      always lowercase binary names.</p></li>
<li class="list"><p class="p"> Double click an entry to edit it. After editing, the icon
      next to the application name will be updated.  If it stays green, it's
      likely to work.  If it turns red / into a stop symbol, then the
      entered name is likely incorrect. (Only works on U*ix-systems.)</p></li>
<li class="list">
<p class="p">After the application name, you can optionally use a placeholder like "<span class="var">%pls</span>" (default),
<p class="p">After the application name, you can optionally use
    "<span class="var">%m3u</span>" (old), or "<span class="var">%xspf</span>" (modern), and "<span class="var">%srv</span>" (for direct
    streaming URLs). See <span class="link"><a href="config_apps.html#placeholders" title="URL placeholders">placeholders</a></span>.</p>
<p class="p">Catch-all entries like <span class="var">*/*</span> or a generic <span class="var">audio/*</span> entry allow to
    configure a default player.  While <span class="var">video/youtube</span> is specific to the Youtube
    channel.  And <span class="var">url/http</span> a pseudo MIME type to configure a web browser (for
    station homepages).</p>
<p class="p">In practice you only need one entry for <span class="var">audio/*</span> and one for
    <span class="var">video/*</span>, both can use the same player even.  You can remove default entries by
    clearing both the Format field and its associated Application.  Add completely new
    associations through the emtpy line.  (Reopen the dialog to add another one.)</p>
      <span class="link"><a href="config_apps.html#placeholders" title="URL placeholders">a placeholder</a></span>:</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p"><span class="var">%pls</span> โ†’ default format</p></li>
<li class="list"><p class="p"><span class="var">%m3u</span> โ†’ older scheme</p></li>
<li class="list"><p class="p"><span class="var">%xspf</span> โ†’ modern playlists,</p></li>
<li class="list"><p class="p"><span class="var">%srv</span> โ†’ for direct streaming URLs</p></li>
</ul></div></div></div>
</li>
<li class="list">
<p class="p">The format entries can specify generic or custom handlers:</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Catch-all specifiers like <span class="var">*/*</span> or a generic
        <span class="var">audio/*</span> entry allow to configure a default
        player.</p></li>
<li class="list"><p class="p">While <span class="var">video/youtube</span> is specific to the Youtube
        channel.</p></li>
<li class="list"><p class="p">And <span class="var">url/http</span> a pseudo MIME type to configure a
        web browser (for station homepages).</p></li>
</ul></div></div></div>
</li>
<li class="list"><p class="p">In practice you only needed one entry for <span class="var">audio/*</span>
      and one for <span class="var">video/*</span>, both can use the same player even. 
      </p></li>
<li class="list"><p class="p"> You can remove existing entries by clearing both the Format
      field and its associated Application.  Add completely new associations
      through the emtpy line.  </p></li>
</ul></div></div></div>
<div class="links topiclinks"><div class="inner"><div class="region"><div class="linkdiv "><a class="linkdiv" href="config_apps.html" title="Audio players"><span class="title">Audio players</span><span class="linkdiv-dash"> โ€” </span><span class="desc">Common applications to use as players.</span></a></div></div></div></div>
</div></div>
</div></div>
<div id="recording" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Recording Apps</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The second block of entries in the 'Apps' section specifies recording applications.
224
225
226
227
228
229
230

231
232
233






234
235
236
237
238
239
240
220
221
222
223
224
225
226
227



228
229
230
231
232
233
234
235
236
237
238
239
240







+
-
-
-
+
+
+
+
+
+







</div></div>
</div></div>
</div></div>
<div id="plugins" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel and feature plugins and settings</span></h2></div>
<div class="region">
<div class="contents">
<div class="table"><div class="inner"><div class="region"><table class="table"><tr>
<p class="p">The tabs <span class="key"><kbd>๐Ÿ“ป Channels</kbd></span> lists all available directory services.
    While the <span class="key"><kbd>๐Ÿ”Œ Features</kbd></span> group provides internal or menu enhancements.
    Disabling or enabling a plugin however requires a restart of Streamtuner2
<td><p class="p">The <span class="key"><kbd>๐Ÿ“ป Channels</kbd></span> tab shows all available directory
    services.</p></td>
<td><p class="p">While the <span class="key"><kbd>๐Ÿ”Œ Features</kbd></span> group provides internal or menu
    enhancements.</p></td>
</tr></table></div></div></div>
<p class="p">Disabling or enabling a plugin however requires a restart of Streamtuner2
    to take effect. (Unless the <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2 - ๐Ÿ“ฆ Add">Plugin Manager 2</a></span>
    is enabled, with its <span class="key"><kbd>๐Ÿ“ฆ Add</kbd></span> tab visible.)</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/configplugins.png" class="media media-inline" alt=""></span></span></p>
<p class="p">Each plugin can have its own little list of extra options. They'll be
    applied right away for already active channel/feature plugins.</p>
<div class="links topiclinks"><div class="inner"><div class="region">
<div class="linkdiv "><a class="linkdiv" href="internet_radio_org_uk.html" title="Internet-Radio"><span class="title">Internet-Radio</span><span class="linkdiv-dash"> โ€” </span><span class="desc">Large radio directory from the UK.</span></a></div>

Modified help/html/contrib_channels.html from [4226f6f921] to [a6c51beeee].

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
79
80
81
82
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
79
80

81
82
83
84
85

86
87
88
89
90
91
92
93







-
+
+



-
+
+




-
+
+


-
+
+



-
+
+

-
+
+

-
+
+



-
+
+

-
+
+

-
+
+




-
+
+




-
+



-
+




-
+







<div class="hgroup"><h1 class="title"><span class="title">โ†’ Contrib/Extra Channels</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Besides the standard channels, there are a few more plugins available
for download. See the <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2 - ๐Ÿ“ฆ Add">Plugin Manager</a></span>
and its <span class="key"><kbd>๐Ÿ“ฆ Add</kbd></span> tab.</p>
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="link"><a href="http://radio.net/" title="http://radio.net/">Radio.net</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://radio.net/" title="http://radio.net/">Radio.net</a></span>
</dt>
<dd class="terms"><p class="p">Radio.net is a European radio directory. It nicely catalogues
    stations into genres as usual. The primary list is ordered by
    popularity even. </p></dd>
<dt class="terms"><span class="link"><a href="http://magnatune.com/" title="http://magnatune.com/">Magnatune</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://magnatune.com/" title="http://magnatune.com/">Magnatune</a></span>
</dt>
<dd class="terms"><p class="p">Magnatune is an independent label for artists. It makes most
    albums available for free listening with only a few intermittent
    adverts. Otherwise it's a flatrate payable music discovery and
    download service. </p></dd>
<dt class="terms"><span class="link"><a href="http://publicradiofan.com/" title="http://publicradiofan.com/">PublicRadioFan</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://publicradiofan.com/" title="http://publicradiofan.com/">PublicRadioFan</a></span>
</dt>
<dd class="terms"><p class="p">PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p></dd>
<dt class="terms"><span class="link"><a href="http://delicast.com/" title="http://delicast.com/">Delicast</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://delicast.com/" title="http://delicast.com/">Delicast</a></span>
</dt>
<dd class="terms"><p class="p">Delicast.com is another web directory of radio stations. It's
    somewhat slower because playback addresses are hidden away with extra
    page requests. Works reliably still.</p></dd>
<dt class="terms"><span class="link"><a href="http://listenlive.eu/" title="http://listenlive.eu/">ListenLive.eu</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://listenlive.eu/" title="http://listenlive.eu/">ListenLive.eu</a></span>
</dt>
<dd class="terms"><p class="p">ListenLive is also an Europe-centric radio directory.</p></dd>
<dt class="terms"><span class="link"><a href="http://liveradio.ie/" title="http://liveradio.ie/">Liveradio.ie</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://liveradio.ie/" title="http://liveradio.ie/">Liveradio.ie</a></span>
</dt>
<dd class="terms"><p class="p">Is an Ireland-based radio station directory.</p></dd>
<dt class="terms"><span class="link"><a href="http://radiosure.com/" title="http://radiosure.com/">RadioSure</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://radiosure.com/" title="http://radiosure.com/">RadioSure</a></span>
</dt>
<dd class="terms"><p class="p">Station database that's readily available as CSV list. You'll
    currently need the tmp_clean_multiurl plugin as well, as most entries
    supply multiple URLs, but action.py doesn't support those currently.</p></dd>
<dt class="terms"><span class="link"><a href="http://vtuner.com/" title="http://vtuner.com/">vTuner</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://vtuner.com/" title="http://vtuner.com/">vTuner</a></span>
</dt>
<dd class="terms"><p class="p">Categorized station list by a cross-platform streaming service provider. </p></dd>
<dt class="terms"><span class="link"><a href="http://reciva.com/" title="http://reciva.com/">Reciva</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://reciva.com/" title="http://reciva.com/">Reciva</a></span>
</dt>
<dd class="terms"><p class="p">Reciva is an iPhone app, with a browsable station list. </p></dd>
<dt class="terms"><span class="link"><a href="http://house-mixes.com/" title="http://house-mixes.com/">house-mixes</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://house-mixes.com/" title="http://house-mixes.com/">house-mixes</a></span>
</dt>
<dd class="terms"><p class="p">House-mixes.com provides a growing collection of DJ mixes (house,
    dance, etc). The website can be used after a free registration to download
    complete MP3s (often in high quality). In Streamtuner2 you can even
    drag and drop them onto your desktop directly.</p></dd>
<dt class="terms"><span class="link"><a href="http://punkcast.com/" title="http://punkcast.com/">PunkCast</a></span></dt>
<dt class="terms">๐Ÿ“ป <span class="link"><a href="http://punkcast.com/" title="http://punkcast.com/">PunkCast</a></span>
</dt>
<dd class="terms"><p class="p">PunkCast is no longer maintained. It covered the NY music and tech
    scenes, but existing recordings are still accessible mostly (some are
    just weblinks however). This plugin is kept for nostalgic reasons;
    it was available with streamtuner1 as well. </p></dd>
<dt class="terms">GrLittleRadioPlayer</dt>
<dt class="terms">๐Ÿ“ป GrLittleRadioPlayer</dt>
<dd class="terms"><p class="p">Great Little Radio Player is another Linux desktop radio browser.
    It comes with a default set of categorized stations. This plugin merely
    imports that list as static directory. </p></dd>
<dt class="terms">Compound</dt>
<dt class="terms">๐Ÿ“ป Compound</dt>
<dd class="terms"><p class="p">The compound channel is a meta plugin. It can aggregate categories
    from other channel plugins on a per-category basis. You for example
    can mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio,
    Tunein, etc. Which avoids switching between channel tabs somewhat. </p></dd>
<dt class="terms">File browser</dt>
<dt class="terms">๐Ÿ“ป File browser</dt>
<dd class="terms"><p class="p">You can also browse local files with streamtuner2 using the file
    browser plugin. It must be configured with your music collection path.
    It's not a default plugin, because this isn't really what Streamtuner2
    is made for. There are way better local music collection managers for
    Linux. It's just here for convenience, and displays files just as any
    other channel list. It has no specific file management features, and
    won't receive any. </p></dd>

Modified help/html/contrib_features.html from [3e41daff11] to [5d89ccff69].

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
79
80
81
82
83
84
85
86
87
88
89
90
91





92
93
94
95
96
97
98
99
100
101
102
103
104
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
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
79
80
81
82
83
84
85
86





87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

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







-
+














-
+









-
+












-
+










-
+












-
-
-
-
-
+
+
+
+
+













-
+

-
+
+







-
+

-
+



-
+



-
+

-
+







<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">โ†’ Feature plugins</span></h1></div>
<div class="region">
<div class="contents"><p class="p">Extra functionality and behaviour changes are available in
the <span class="key"><kbd>๐Ÿ”Œ Feature</kbd></span> <span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configuration</a></span>
section.</p></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Filter Bitrate</span></h2></div>
<div class="hgroup"><h2 class="title"><span class="title">๐Ÿ”Œ Filter Bitrate</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Some channels provide lower-quality audio streams. In particular
Xiph lists some awful radio stations. And this plugin helps filtering
those out of station lists.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">MP3 streams often start to sound okay at 96kbit/s.</p></li>
<li class="list"><p class="p">Whereas OGG Vorbis or AAC are sometimes acceptable at 64kbit/s already.</p></li>
</ul></div></div></div>
<p class="p">Note that you may end up with empty channel lists
altogether if you set these options too high. Some channels provide all
their streams with 64kbit/s only.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Channel toolbar link</span></h2></div>
<div class="hgroup"><h2 class="title"><span class="title">๐Ÿ”Œ Channel toolbar link</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Adds a toolbar entry which shows the current channel/directory
service title and its homepage link. Such as:</p>
<div class="code"><pre class="contents "><span class="span">  โ–ถ    โ—    ๐Ÿ      Shoutcast</span>
play rcrd  hmpg   <span class="link"><a href="http://shoutcast.com/" title="http://shoutcast.com/">//shoutcast.com/</a></span></pre></div>
<p class="p">It depends on the "update window title" option being enabled.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Export all stations</span></h2></div>
<div class="hgroup"><h2 class="title"><span class="title">๐Ÿ”Œ Export all stations</span></h2></div>
<div class="region"><div class="contents">
<p class="p">There's an "Export All" plugin available. It adds an entry under
<span class="guiseq"><span class="gui">Main menu</span>ย โ–ธ <span class="gui">Extensions</span>ย โ–ธ <span class="gui">Export all stations</span></span>.
Which allows to export all stations from the currently visible channel category.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">This is of course intended primarily for saving your bookmarks.</p></li>
<li class="list"><p class="p">And it allows to import radio lists into any other music player  or playlist collection/management app (such as Rhythmbox).</p></li>
<li class="list"><p class="p">You can set the desired playlist format in the file saving dialog that pops up.</p></li>
</ul></div></div></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">RadioTray hook</span></h2></div>
<div class="hgroup"><h2 class="title"><span class="title">๐Ÿ”Œ RadioTray hook</span></h2></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 an 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"><h2 class="title"><span class="title">User Agent Switcher</span></h2></div>
<div class="hgroup"><h2 class="title"><span class="title">๐Ÿ”Œ User Agent Switcher</span></h2></div>
<div class="region"><div class="contents">
<p class="p">This plugin merely masks Streamtuner2 as an ordinary web browser when retrieving station lists.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p"> It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere. </p></li>
<li class="list"><p class="p">It's only useful as additional privacy feature really, but shouldn't be used habitually. </p></li>
</ul></div></div></div>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Other feature plugins</span></h2></div>
<div class="region"><div class="contents">
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p"><span class="link"><a href="dragndrop.html" title="Drag'n'drop">Drag and Drop</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="favicon.html" title="Station favicons">Favicons</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="global_key.html" title="Global_key">Global key shortcut</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="timer.html" title="Timer">Timer</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="specbuttons.html" title="Special extra/mini buttons">Specbuttons</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="dragndrop.html" title="Drag'n'drop">๐Ÿ”Œ Drag and Drop</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="favicon.html" title="Station favicons">๐Ÿ”Œ Favicons</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="global_key.html" title="Global_key">๐Ÿ”Œ Global key shortcut</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="timer.html" title="Timer">๐Ÿ”Œ Timer</a></span></p></li>
<li class="list"><p class="p"><span class="link"><a href="specbuttons.html" title="Special extra/mini buttons">๐Ÿ”Œ Specbuttons</a></span></p></li>
</ul></div></div></div>
<p class="p">The "<span class="link"><a href="search.html" title="Searching">search</a></span>",
 "<span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configwin</a></span>" and
 "<span class="link"><a href="edit.html" title="Edit">streamedit</a></span>" plugins are considered
 built-ins and cannot be disabled.</p>
</div></div>
</div></div>
<div id="contrib" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Downloadable contrib/ feature plugins</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The <span class="link"><a href="pluginmanager2.html" title="Plugin Manager 2 - ๐Ÿ“ฆ Add">Plugin Manager</a></span> lists other
available feature plugins in the <span class="key"><kbd>๐Ÿ“ฆ Add</kbd></span> tab.</p>
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">Soundcloud streaming</dt>
<dt class="terms">๐Ÿ”Œ Soundcloud streaming</dt>
<dd class="terms">
<p class="p">Enables playback of soundcloud.com links in the Reddit plugin.
<p class="p">Enables playback of soundcloud.com links, which are only used
    in the <span class="link"><a href="channel_reddit.html" title="channel_reddit">๐Ÿ“ป Reddit</a></span> plugin currently.
    Homepage links are transformed into direct MP3 streaming addresses
    on playback.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Depends on python-soundcloud, which you can install per
    <span class="cmd">pip install soundcloud</span>.</p></div></div></div></div>
<p class="p"> Alternatively you could configure an external player like <span class="link"><a href="http://github.com/rekado/soundCLI" title="http://github.com/rekado/soundCLI">soundcli</a></span> of course.
    Use the pseudo type "audio/soundcloud" for the player settings table.</p>
</dd>
<dt class="terms">dev_faulthandler</dt>
<dt class="terms">๐Ÿ”Œ dev_faulthandler</dt>
<dd class="terms"><p class="p">This is a pure development plugin, meant to debug ST2 crashes.</p></dd>
<dt class="terms">bookmarks_show_extra</dt>
<dt class="terms">๐Ÿ”Œ bookmarks_show_extra</dt>
<dd class="terms"><p class="p">Is a slim UI adaption to show the `extra` field in the bookmarks
    channel. This field can contain user comments, but is used per default
    to store the originating channel in.</p></dd>
<dt class="terms">new_station</dt>
<dt class="terms">๐Ÿ”Œ new_station</dt>
<dd class="terms"><p class="p">Currently not working. Small plugin to provide an "Add station..."
    menu entry. Note that ST2 is not meant as playlist manager, which is
    why this isn't a built-in feature. However, it's oft-requested anyway.</p></dd>
<dt class="terms">tmp_clean_multiurl</dt>
<dt class="terms">๐Ÿ”Œ tmp_clean_multiurl</dt>
<dd class="terms"><p class="p">Strips extra space-separate URLs from station list. (Currently only
    required for RadioSure channel. Later ST2 versions will likely support
    required for ๐Ÿ“ป RadioSure channel. Later ST2 versions will likely support
    such entries per default again).</p></dd>
</dl></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents">

Modified help/html/favicon.html from [461e70d2e3] to [01fb6cd7aa].

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







-
+




-
+






-
+






-
+







better safe than sorry).
Images are kept in the <span class="file">~/.config/streamtuner2/icons</span> directory.
</p></div></div></div></div>
</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>
<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>
<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>
<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>
<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">

Modified help/html/filtermusic.html from [28aeae6356] to [0ca2a3289e].

31
32
33
34
35
36
37

38


















39
40
41
42
43
44
45
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







+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+







</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">
<p class="p">Like the <span class="link"><a href="channel_xiph.html" title="channel_xiph">๐Ÿ“ป Xiph plugin</a></span> this channel provides
<p class="p">Like the Xiph plugin this channel provides two/three fetch modes.</p>
	three fetch modes:</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list">
<div class="title title-item"><h3><span class="title">Website</span></h3></div>
<p class="p">Extract all streams from the web page
         directly.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">XML Data</span></h3></div>
<p class="p">Use <span class="file">๐Ÿ’พ list.2.0.xml</span> which
         the channel service provides directly.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">Buffered</span></h3></div>
<p class="p">Keeps the XML file in memory. (It
         rarely changes.)</p>
</li>
</ul></div></div></div>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">
	There's no speed or feature differences this time. You might prefer
	the buffered mode, as it reduces update requests, but still allows
	refreshing lists.</p></div></div></div></div>
</div></div>
</div></div>
<div class="sect sect-links" role="navigation">

Modified help/html/internet_radio_org_uk.html from [6542280efb] to [905e32c3ca].

28
29
30
31
32
33
34


35
36
37




38
39
40
41
42
43
44
28
29
30
31
32
33
34
35
36



37
38
39
40
41
42
43
44
45
46
47







+
+
-
-
-
+
+
+
+







<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>
<li class="list"><p class="p">Uses HTML extraction (regex or pyquery) internally.</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"><div class="list"><div class="inner"><div class="region"><ul class="list"><li class="list">
<div class="title title-item"><h3><span class="title">๐Ÿ”Ÿ pages to fetch</span></h3></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>
<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 is because this directly influences the stream loading time.</p>
</li></ul></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="channels.html#list" title="Available channels">Available channels</a></li>

Modified help/html/jamendo.html from [9d103185cd] to [e6d4531f24].

34
35
36
37
38
39
40
41

42
43
44
45

46
47
48

49
50
51
52
53
54
55
34
35
36
37
38
39
40

41
42
43
44

45
46
47

48
49
50
51
52
53
54
55







-
+



-
+


-
+







<p class="p">Tracks and albums can be downloaded free of charge (Creative Commons). Yeah, imagine that.</p>
</div>
<div id="options" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title"><span class="link"><a href="configuration.html" title="Configuration / Settings dialog">Config</a></span> 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">System</span></h3></div>
<div class="region"><dl class="terms">
<dt class="terms">Streaming format</dt>
<dt class="terms">๐Ÿ”  Streaming format</dt>
<dd class="terms"><p class="p">You can switch between MP3 and Ogg Vorbis audio streams for Jamendo.
     It's not honored by the radio section, but albums and tracks should be
     received as Ogg when configured so.</p></dd>
<dt class="terms">Preview image sizes</dt>
<dt class="terms">๐Ÿ”  Preview image sizes</dt>
<dd class="terms"><p class="p">Album covers are downloaded in lieu of favicons. They're available
     in different sizes. Use 25px if you want just favicon-sized icons.</p></dd>
<dt class="terms">Result length</dt>
<dt class="terms">๐Ÿ”Ÿ Result length</dt>
<dd class="terms">
<p class="p">Currently only 1 page (of 200 entries each) of album/track lists are
     fetched.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">Setting a higher value may not work.</p></div></div></div></div>
</dd>
</dl></div>
</div></div></div></div>

Modified help/html/modarchive.html from [ea2cc48541] to [f0dd5d0d58].

29
30
31
32
33
34
35
36
37
38

39
40







41





42
43
44
45
46
47
48
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







-
-
-
+


+
+
+
+
+
+
+
-
+
+
+
+
+







<li class="list"><p class="p">GModplay</p></li>
<li class="list"><p class="p">VLC (built-in support)</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">See <span class="link"><a href="recording.html" title="Recording">recording configuration</a></span> if you
	want to enable the download mode.</p>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">Audio files are packaged up in ZIP files on MODArchive. 
<p class="p">Audio files are packaged up in ZIP files on MODArchive. 
	While they are different formats (IT, S3M, XM, etc) they'll all
	carry a generic <span class="var">audio/mod+zip</span> type specifier in
	streamtuner2 for configuration:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr><td rowspan="2"></td></tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="var">audio/mod+zip</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">cd ~/Music ; wget %srv</span></p></td>
</tr>
	streamtuner2.</p></div></div></div></div>
</table></div></div></div>
<p class="p">You can use <span class="cmd">curl</span>, or wrap the command with <span class="cmd">xterm</span>
	(though files are too quick to download).
	A few file managers might be able to open the URLs directly even.
	See <span class="link"><a href="recording.html" title="Recording">recording configuration</a></span> for more examples.</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>

Modified help/html/pluginmanager2.html from [a55af2cf87] to [5b461359d2].

40
41
42
43
44
45
46
47

48
49
50
51
52
53
54
40
41
42
43
44
45
46

47
48
49
50
51
52
53
54







-
+







</div>
<div id="configuration" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents"><div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></li>
<li class="list">
<p class="p">And you can let the plugin manager handle autoactivation
<p class="p">And you can let the plugin manager handle โ˜‘ autoactivation
	of changed plugin states.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">After reconfiguring existing channel plugins, they get
   	  automatically instantiated or disabled in the user interface.
   	  (Which avoids the usual restart).</p></li>
<li class="list"><p class="p">This currently doesn't work with feature/core
   	  plugins. Plugin deactivation is mostly visual, but does not undo

Modified help/html/radionomy.html from [144bfd8673] to [3b1a4b0165].

33
34
35
36
37
38
39
40



41
42
43
44
45
46









47
48
49
50
51
52
53
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







-
+
+
+

-
-
-
-
-
+
+
+
+
+
+
+
+
+







</ul></div></div></div>
<p class="p">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>
</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">
<div class="region"><div class="contents"><div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list">
<div class="title title-item"><h3><span class="title">๐Ÿ”Ÿ Number of pages</span></h3></div>
<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>
<p class="p"> And the song title updating ("<span class="key"><kbd>OnAir Updates</kbd></span>") can be disabled.
 Future versions of this channel plugin might poll it automatically,
 and keep the station list auto-updated.</p>
</div></div>
  default) to influence the length of station lists.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">โ˜‘ OnAir updates</span></h3></div>
<p class="p"> And the song title updating can be disabled (for speedier loading).
  Future versions of this channel plugin might poll it automatically,
  and keep the station list auto-updated.</p>
</li>
</ul></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="channels.html#list" title="Available channels">Available channels</a></li>

Modified help/html/recording.html from [1bf9cf3d51] to [ae5e061ac7].

19
20
21
22
23
24
25
26


27
28
29
30
31
32
33
19
20
21
22
23
24
25

26
27
28
29
30
31
32
33
34







-
+
+







<div class="hgroup"><h1 class="title"><span class="title">Recording</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool <span class="app">streamripper</span>.  If you
select a station and press <span class="gui">โ— record</span>, a console
window should appear, where streamripper shows its progress.</p>
<p class="p">You can <span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configure the recording tool</a></span> according to audio types again.</p>
<p class="p">You can <span class="link"><a href="configuration.html" title="Configuration / Settings dialog">configure the recording tool</a></span>
according to audio types again. Usually you want to use the <span class="link"><a href="config_apps.html#placeholders" title="URL placeholders"><span class="cmd">%srv</span> placeholder</a></span>.</p>
</div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Streamripper</span></h2></div>
<div class="region"><div class="contents">
<p class="p">There's already a default entry for recording radio stations:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<thead><tr>

Modified help/html/reddit.html from [76d4eb47d8] to [27cad7d290].

59
60
61
62
63
64
65
66

67
68
69




70
71
72
73
74
75
76
59
60
61
62
63
64
65

66
67


68
69
70
71
72
73
74
75
76
77
78







-
+

-
-
+
+
+
+







</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">There's a few options for the reddit plugin:</p>
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code"> Number of pages to fetch </span></dt>
<dt class="terms"><span class="code">๐Ÿ”Ÿ  Number of pages to fetch </span></dt>
<dd class="terms"><p class="p">Influences how many JSON requests are made to assemble a list of
    subreddit posts with playable content.</p></dd>
<dt class="terms"><span class="code"> Filter walled gardens </span></dt>
    subreddit posts with playable content. (For this plugin that's
    configurable, because counting streams wouldn't work as reddit
    result lists vary wildly in their usable links.)</p></dd>
<dt class="terms"><span class="code">โ˜‘ Filter walled gardens </span></dt>
<dd class="terms">
<p class="p">Many music posts on reddit meanwhile point to one of Soundcloud,
    Spotify, Bandcamp, Mixcloud. Those are basically just links you had
    open in your browser. --
    Now those are labeled "walled gardens" here, because they're hording
    user content behind a paywall/registration-wall, fiddly NIH APIs,
    non-standard audio formats, web-only players and sessioning.</p>
96
97
98
99
100
101
102
103

104
105
106
107
108
109
110
98
99
100
101
102
103
104

105
106
107
108
109
110
111
112







-
+







<td style="border-top-style: solid;"><p class="p"><span class="app">audio/mixcloud</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd"><span class="link"><a href="https://rg3.github.io/youtube-dl/supportedsites.html" title="https://rg3.github.io/youtube-dl/supportedsites.html">vlc $(youtube-dl -g %srv)</a></span></span></p></td>
</tr>
</table></div></div></div>
<p class="p">Obviously you want to pipe <span class="cmd">youtube-dl</span> to an actual audio player
    again. VLC also supports a few services directly or via plugins.</p>
</dd>
<dt class="terms"><span class="code"> Keep all web links </span></dt>
<dt class="terms"><span class="code">โ˜‘ Keep all web links </span></dt>
<dd class="terms"><p class="p">Besides audio/video links, some subreddits link to album art or
    are just news feeds. Enable the "keep all" option to retain them.
    Such entries will open in your web browser instead of an audio player,
    of course.</p></dd>
</dl></div></div></div>
<div class="note" title="Note"><div class="inner"><div class="region"><div class="contents"><p class="p">To utilize Soundcloud links, there's an <span class="link"><a href="contrib_features.html" title="โ†’ Feature plugins">extra url_soundcloud plugin</a></span>. 
 It overrides the <span class="file">audio/soundcloud</span> player config, and

Modified help/html/surfmusik.html from [d17901d46d] to [8ad176cdef].

31
32
33
34
35
36
37
38
39
40
41







42
43
44
45
46
47
48
31
32
33
34
35
36
37




38
39
40
41
42
43
44
45
46
47
48
49
50
51







-
-
-
-
+
+
+
+
+
+
+







</ul></div></div></div>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">The MusicTV and NewsTV sections also return results, but those are mostly
        web-based video stations. Some of them are outdated links even.</p></div></div></div></div>
</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">Language</span></dt>
<dd class="terms"><p class="p">There's an English and a German variant of this radio directory. Genres are
    also localized. Restart streamtuner2 after switching the Language option. Then
    use <span class="guiseq"><span class="gui">Channel</span>ย โ–ธ <span class="gui">Reload category tree</span></span>.</p></dd>
<dt class="terms"><span class="code">๐Ÿ”  Language</span></dt>
<dd class="terms">
<p class="p">There's an English and a German variant of this radio directory. Genres are
    also localized.</p>
<p class="p">Restart streamtuner2 after switching the Language option. Then
    use <span class="guiseq"><span class="gui">Channel</span>ย โ–ธ <span class="gui">Reload category tree</span></span>.</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>

Modified help/html/xiph.html from [2edd7cf7cd] to [c9281f9ce3].

74
75
76
77
78
79
80
81

82
83
84
85
86
87
88
74
75
76
77
78
79
80

81
82
83
84
85
86
87
88







-
+







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

Modified help/html/youtube.html from [9dfb1c1b02] to [6e670d8d64].

34
35
36
37
38
39
40
41

42
43

44
45
46
47
48
49
50

51
52
53
54
55
56
57
34
35
36
37
38
39
40

41
42

43
44
45
46
47
48
49

50
51
52
53
54
55
56
57







-
+

-
+






-
+







<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>
<div class="region"><div class="contents"><div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms"><span class="code">Region</span></dt>
<dt class="terms"><span class="code">๐Ÿ”  Region</span></dt>
<dd class="terms"><p class="p">With the country dropdown you can predefine which mostPopular listings are returned.</p></dd>
<dt class="terms"><span class="code">My Channels</span></dt>
<dt class="terms"><span class="code">๐Ÿ”  My Channels</span></dt>
<dd class="terms">
<p class="p">You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
            To apply this setting, and have new categories show up in the genre pane, use
            <span class="guiseq"><span class="gui">Channel</span>ย โ–ธ <span class="gui">Update category tree</span></span> first.</p>
<p class="p">It's not an exact map, but utilizes the search function to find channels.</p>
</dd>
<dt class="terms"><span class="code">Wadsworth constant</span></dt>
<dt class="terms"><span class="code">โ˜‘ Wadsworth constant</span></dt>
<dd class="terms"><p class="p">Only influences the video homepage link.</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>

Modified help/pluginmanager2.page from [c8464589f9] to [dd06743fce].

34
35
36
37
38
39
40
41

42
43
44
45
46
47
48
34
35
36
37
38
39
40

41
42
43
44
45
46
47
48







-
+







	Or disabling + saving once, then reenabling them.</p></note>
	
	<section id="configuration">
	<title>Configuration</title>
	<list>
	<item><p>Alternative download repositories may be configured. (Little
	practical value at the moment.)</p></item>
	<item><p>And you can let the plugin manager handle autoactivation
	<item><p>And you can let the plugin manager handle โ˜‘ autoactivation
	of changed plugin states.</p>
	  <list>
	  <item><p>After reconfiguring existing channel plugins, they get
   	  automatically instantiated or disabled in the user interface.
   	  (Which avoids the usual restart).</p></item>
	  <item><p>This currently doesn't work with feature/core
   	  plugins. Plugin deactivation is mostly visual, but does not undo