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

⌈⌋ branch:  streamtuner2


Check-in [4caf8247dc]

Overview
Comment:updated html dump
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 4caf8247dc5227427ff47945f45622342ad751c7
User & Date: mario on 2020-10-30 19:34:37
Other Links: manifest | tags
Context
2020-10-31
16:59
select: is now preparsed in pluginconf (but configwin/combobox expected tuple-list instead of dict till now; might need further changes) check-in: 8d130efe89 user: mario tags: trunk
2020-10-30
19:34
updated html dump check-in: 4caf8247dc user: mario tags: trunk
19:34
peertube+youtube detection check-in: 7205e8f9b4 user: mario tags: trunk
Changes

Modified help/contrib_channels.page from [6d3c23fcb3] to [648d54c9d4].

33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
  </section>
  <section>
    <subtitle>📻 <link href="http://publicradiofan.com/">PublicRadioFan</link></subtitle>
    <p>PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p>
  </section>
  <section>
    <subtitle>📻 <link href="http://liveradio.ie/">Liveradio.ie</link></subtitle>
    <p>Is an Ireland-based radio station directory.</p>
  </section>
  <section>
    <subtitle>📻 <link href="http://radiosure.com/">RadioSure</link></subtitle>
    <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>
  </section>
  <section>
    <subtitle>📻 <link href="http://vtuner.com/">vTuner</link></subtitle>







<
<
<
<







33
34
35
36
37
38
39




40
41
42
43
44
45
46
  </section>
  <section>
    <subtitle>📻 <link href="http://publicradiofan.com/">PublicRadioFan</link></subtitle>
    <p>PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p>
  </section>
  <section>




    <subtitle>📻 <link href="http://radiosure.com/">RadioSure</link></subtitle>
    <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>
  </section>
  <section>
    <subtitle>📻 <link href="http://vtuner.com/">vTuner</link></subtitle>
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
    <subtitle>📻 <link href="http://radiolist.net/">radiolist.net</link></subtitle>
    <p>Is a continent/country-oriented radio directory. The stream formats
    vary wildly however.</p>
  </section>
  <section>
    <subtitle>📻 Compound</subtitle>
    <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>
  </section>
</section>

<section>
<subtitle>Repository</subtitle>
<p>See also the list of
<link href="http://fossil.include-once.org/streamtuner2/wiki/plugins">available
plugins</link> in the project wiki.</p>
</section>
</page>







|
|











84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
    <subtitle>📻 <link href="http://radiolist.net/">radiolist.net</link></subtitle>
    <p>Is a continent/country-oriented radio directory. The stream formats
    vary wildly however.</p>
  </section>
  <section>
    <subtitle>📻 Compound</subtitle>
    <p>The compound channel is a meta plugin. It can aggregate categories
    from other channel plugins on a per-category basis. You can, for example,
    mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio,
    Tunein, etc. Which avoids switching between channel tabs somewhat. </p>
  </section>
</section>

<section>
<subtitle>Repository</subtitle>
<p>See also the list of
<link href="http://fossil.include-once.org/streamtuner2/wiki/plugins">available
plugins</link> in the project wiki.</p>
</section>
</page>

Modified help/html/contrib_channels.html from [3d4dfd673a] to [a7c286dfa8].

44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
    adverts. Otherwise it's a flatrate payable music discovery and
    download service. </p></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://publicradiofan.com/" title="http://publicradiofan.com/">PublicRadioFan</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><p class="p">PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://liveradio.ie/" title="http://liveradio.ie/">Liveradio.ie</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><p class="p">Is an Ireland-based radio station directory.</p></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://radiosure.com/" title="http://radiosure.com/">RadioSure</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><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></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://vtuner.com/" title="http://vtuner.com/">vTuner</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><p class="p">Categorized station list by a cross-platform streaming service provider. </p></div></div>







<
<
<







44
45
46
47
48
49
50



51
52
53
54
55
56
57
    adverts. Otherwise it's a flatrate payable music discovery and
    download service. </p></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://publicradiofan.com/" title="http://publicradiofan.com/">PublicRadioFan</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><p class="p">PublicRadioFan.com hosts a huge lists of worldwide radio stations.
    This plugin displays just the genre list though.</p></div></div>
</div></section><section id=""><div class="inner">



<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://radiosure.com/" title="http://radiosure.com/">RadioSure</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><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></div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h4 class="subtitle"><span class="subtitle">📻 <span class="link"><a href="http://vtuner.com/" title="http://vtuner.com/">vTuner</a></span></span></h4></div>
<div class="region"><div class="contents pagewide"><p class="p">Categorized station list by a cross-platform streaming service provider. </p></div></div>

Modified help/html/filetypes.html from [567ad64c68] to [de75007b01].

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
</head>
<body><main><div class="page">
<header><div class="inner pagewide"><div class="trails" role="navigation"><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#footer" title="index#footer"></a> » <a class="trail" href="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div></header><article><div class="hgroup pagewide"><h1 class="title"><span class="title">File types</span></h1></div>
<div class="region">
<div class="contents pagewide"><p class="p">Streamtuner2 understands different playlist formats as used by various
directory services and audio players.</p></div>
<section id=""><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.M3U files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">M3U files are one of the simplest playlist types. They're often used by desktop audio players.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-mpegurl</span> and often contain just a list of URLs:</p>
<div class="code"><pre class="contents"><code class="">#M3U
http://123.45.67.189:8222/
http://123.45.67.222:7555/</code></pre></div>
</div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.PLS files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">Playlist files often have the extension <span class="file">.pls</span>. It's the primary station
stream link format of SHOUTcast, and was popularized by WinAmp.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-scpls</span> and they often look like: </p>
<div class="code"><pre class="contents"><code class="">[playlist]
numberofentries=1
File1=http://123.45.67.189:8222
Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez
Length1=-1</code></pre></div>
</div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.JSON files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">JSON is a data representation format derived from Javascript (the browser embedded
programming language for websites). It's commonly used because it provides a
nice balance between terse and exact data representation, while still being
readable.</p>
<p class="p">Streamtuner2 uses it to store all of its configuration and radio station data files.







|








|











|







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
</head>
<body><main><div class="page">
<header><div class="inner pagewide"><div class="trails" role="navigation"><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#footer" title="index#footer"></a> » <a class="trail" href="glossary.html" title="Glossary">Glossary</a> › <a class="trail" href="glossary.html#filetypes" title="Filetypes">Filetypes</a> » </div></div></div></header><article><div class="hgroup pagewide"><h1 class="title"><span class="title">File types</span></h1></div>
<div class="region">
<div class="contents pagewide"><p class="p">Streamtuner2 understands different playlist formats as used by various
directory services and audio players.</p></div>
<section id="m3u"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.M3U files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">M3U files are one of the simplest playlist types. They're often used by desktop audio players.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-mpegurl</span> and often contain just a list of URLs:</p>
<div class="code"><pre class="contents"><code class="">#M3U
http://123.45.67.189:8222/
http://123.45.67.222:7555/</code></pre></div>
</div></div>
</div></section><section id="pls"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.PLS files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">Playlist files often have the extension <span class="file">.pls</span>. It's the primary station
stream link format of SHOUTcast, and was popularized by WinAmp.</p>
<p class="p">The MIME type of these files is <span class="sys">audio/x-scpls</span> and they often look like: </p>
<div class="code"><pre class="contents"><code class="">[playlist]
numberofentries=1
File1=http://123.45.67.189:8222
Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez
Length1=-1</code></pre></div>
</div></div>
</div></section><section id="json"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.JSON files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">JSON is a data representation format derived from Javascript (the browser embedded
programming language for websites). It's commonly used because it provides a
nice balance between terse and exact data representation, while still being
readable.</p>
<p class="p">Streamtuner2 uses it to store all of its configuration and radio station data files.
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]</code></pre></div>
<p class="p">It's also the basis for JSPF, the JSON variant of XSPF.</p>
</div></div>
</div></section><section id=""><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.XSPF files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced the "XML shareable playlist format" or "XSPF" for short.
They're hard to look at and not very widespread. On the upside they
contain more meta information than any other playlist store.</p>
<p class="p">As MIME type <span class="sys">application/xspf+xml</span> and they often look like: </p>







|







55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]</code></pre></div>
<p class="p">It's also the basis for JSPF, the JSON variant of XSPF.</p>
</div></div>
</div></section><section id="xspf"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">.XSPF files</span></h2></div>
<div class="region"><div class="contents pagewide">
<p class="p">The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced the "XML shareable playlist format" or "XSPF" for short.
They're hard to look at and not very widespread. On the upside they
contain more meta information than any other playlist store.</p>
<p class="p">As MIME type <span class="sys">application/xspf+xml</span> and they often look like: </p>

Modified help/html/reddit.html from [3fda0f1ed8] to [6ccdb172bc].

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
<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></header><article><div class="hgroup pagewide">
<h1 class="title"><span class="title"><span class="media"><span class="media media-image"><img src="img/channel_reddit.png" class="media media-inline" alt=""></span></span> Reddit</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://reddit.com/r/Music" title="http://reddit.com/r/Music">//reddit.com/r/Music</a></span></span></h2>
</div>
<div class="region">
<div class="contents pagewide">
<p class="p">Reddit (AKA "the frontpage of the internet") is a social media website.
Among its various sections is a large group of music subreddits.
Most of them link popular or novel Youtube music/videos, or user-produced
content etc.</p>

<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Around <span class="em">620</span> subreddits are queried. That's just a selected part
  though. Most others do not see as many audio posts / or are just for
  discussion and news.</p></li>
<li class="list"><p class="p">Besides youtube/mp3 files, this channel may also
  list Soundcloud/Mixcloud/Bandcamp links.</p></li>
<li class="list"><p class="p"><span class="link"><a href="http://radioreddit.com/" title="http://radioreddit.com/">Radioreddit.com</a></span>
  even provides streaming servers. Its categories are: main, random,
  rock, metal, indie, electronic, hiphop, talk, festival.</p></li>
<li class="list"><p class="p">Thumbnails are slightly larger (32x26) than regular favicons.</p></li>
<li class="list"><p class="p">All entries also show poster name and user votes.</p></li>
</ul></div></div></div>
<p class="p">See the config options if you want to keep regular webpage posts - instead
of just showing playable content.</p>
</div>
<section id="statusicons"><div class="inner">
<div class="hgroup pagewide"><h3 class="subtitle"><span class="subtitle">Status icons</span></h3></div>
<div class="region"><div class="contents pagewide">
<p class="p">Station entries may contain a status icon (leftmost; where usually
the bookmarks ✩ star goes).
It's a quick indicator of what type of content is linked:</p>
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">▶</dt>
<dd class="terms"><p class="p">Directly playable entry (MP3, MP4, Youtube, MIDI)</p></dd>
<dt class="terms">▶▶</dt>
<dd class="terms"><p class="p">Walled garden (Soundcloud, Spotify, Bandcamp, Mixcloud) → playable</p></dd>
<dt class="terms">▮▮</dt>
<dd class="terms"><p class="p">Walled gardens without playback handler.</p></dd>
<dt class="terms">📄</dt>
<dd class="terms"><p class="p">Just a web-link. Those are kept with the ☒ keep all option.</p></dd>
</dl></div></div></div>



</div></div>
</div></section><section id="options"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents pagewide">
<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>







|
|
|
|
>


|
|

|

|
|




|





|
|










>
>
>







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
<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></header><article><div class="hgroup pagewide">
<h1 class="title"><span class="title"><span class="media"><span class="media media-image"><img src="img/channel_reddit.png" class="media media-inline" alt=""></span></span> Reddit</span></h1>
<h2 class="subtitle"><span class="subtitle"><span class="link"><a href="http://reddit.com/r/Music" title="http://reddit.com/r/Music">//reddit.com/r/Music</a></span></span></h2>
</div>
<div class="region">
<div class="contents pagewide">
<p class="p">Reddit harbours a growing list of music-related communities.
        User-contributed audio files or audio/video links can be found
	across almost two hundred subreddit boards. There's always a
	mix of new bands or fresh releases to be found, along with
	links to all-time favourites etc.</p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Around <span class="em">620</span> subreddits are queried. That's just a selected part
          though. Most others do not see as many audio posts / or are just for
          discussion and news.</p></li>
<li class="list"><p class="p">Besides youtube/mp3 files, this channel may also
          list Soundcloud/Mixcloud/Bandcamp links.</p></li>
<li class="list"><p class="p"><span class="link"><a href="http://radioreddit.com/" title="http://radioreddit.com/">Radioreddit.com</a></span>
          even provides streaming servers. Its categories are: main, random,
          rock, metal, indie, electronic, hiphop, talk, festival.</p></li>
<li class="list"><p class="p">Thumbnails are slightly larger (32x26) than regular favicons.</p></li>
<li class="list"><p class="p">All entries also show poster name and user votes.</p></li>
</ul></div></div></div>
<p class="p">See the config options if you want to keep regular webpage posts - instead
        of just showing playable content.</p>
</div>
<section id="statusicons"><div class="inner">
<div class="hgroup pagewide"><h3 class="subtitle"><span class="subtitle">Status icons</span></h3></div>
<div class="region"><div class="contents pagewide">
<p class="p">Station entries may contain a status icon (leftmost; where usually
        the bookmarks ✩ star goes).
        It's a quick indicator of what type of content is linked:</p>
<div class="terms"><div class="inner"><div class="region"><dl class="terms">
<dt class="terms">▶</dt>
<dd class="terms"><p class="p">Directly playable entry (MP3, MP4, Youtube, MIDI)</p></dd>
<dt class="terms">▶▶</dt>
<dd class="terms"><p class="p">Walled garden (Soundcloud, Spotify, Bandcamp, Mixcloud) → playable</p></dd>
<dt class="terms">▮▮</dt>
<dd class="terms"><p class="p">Walled gardens without playback handler.</p></dd>
<dt class="terms">📄</dt>
<dd class="terms"><p class="p">Just a web-link. Those are kept with the ☒ keep all option.</p></dd>
</dl></div></div></div>
<p class="p">Please note that <span class="guiseq"><span class="gui">Channel</span> ▸ <span class="gui">Reload category
        tree</span></span> will retrieve a differently structured list of
        subreddits from the /r/music wiki.</p>
</div></div>
</div></section><section id="options"><div class="inner">
<div class="hgroup pagewide"><h2 class="title"><span class="title">Configuration</span></h2></div>
<div class="region"><div class="contents pagewide">
<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>

Modified help/html/shoutcast.html from [4cbc1dbe00] to [907c77f2c1].

26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<div class="region">
<div class="contents pagewide">
<p class="p">SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
	station lists on shoutcast.com.
        </p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Station entries usually provide current playing information.</p></li>
<li class="list"><p class="p">Stream links are plain <span class="link"><a href="pls.html" title="pls">PLS files</a></span>.</p></li>
<li class="list"><p class="p">Genres are subcategorized, so the main groups in the category
		list must be expanded to see the interesting entries.</p></li>
</ul></div></div></div>
<p class="p">Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
        entries for currently played songs, and homepage links are largely gone. Hencewhy the
        Shoutcast channel is no longer considered a primary feature.</p>
</div>







|







26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<div class="region">
<div class="contents pagewide">
<p class="p">SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
	station lists on shoutcast.com.
        </p>
<div class="list"><div class="inner"><div class="region"><ul class="list">
<li class="list"><p class="p">Station entries usually provide current playing information.</p></li>
<li class="list"><p class="p">Stream links are plain <span class="link"><a href="filetypes.html#pls" title=".PLS files">PLS files</a></span>.</p></li>
<li class="list"><p class="p">Genres are subcategorized, so the main groups in the category
		list must be expanded to see the interesting entries.</p></li>
</ul></div></div></div>
<p class="p">Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
        entries for currently played songs, and homepage links are largely gone. Hencewhy the
        Shoutcast channel is no longer considered a primary feature.</p>
</div>