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

⌈⌋ ⎇ branch:  streamtuner2


Check-in [0044d5a6c1]

Overview
Comment:Fix a few typos.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 0044d5a6c127c103b533f3e497b1fc7bf7264c4a
User & Date: mario on 2016-12-27 21:22:15
Other Links: manifest | tags
Context
2016-12-27
21:23
Support alternative lists for #depends: fields, allow #alias: names, and supply `python` builtin for pluginconf.dependency() checker. check-in: 0169107f28 user: mario tags: trunk
21:22
Fix a few typos. check-in: 0044d5a6c1 user: mario tags: trunk
21:21
Simplify virtual dependencies with new pluginconf.dependency(add=) param check-in: fff90115ee user: mario tags: trunk
Changes

Modified help/configuration.page from [cb1202e460] to [a9125eff38].

150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p>
    </item>
    <item>
      <title>🔟 Limit stream number</title>
      <p> Constraints the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p>
    </item>
    <item>
      <title>☑ Retain deleted stations</title> <p>When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.







|







150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p>
    </item>
    <item>
      <title>🔟 Limit stream number</title>
      <p> Constrains the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p>
    </item>
    <item>
      <title>☑ Retain deleted stations</title> <p>When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.

Modified help/glossary_files.page from [bdce36aed8] to [99ea8c383e].

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

<section>
<title>.JSON files</title>
<info><desc>JavaScript Object-Notation</desc></info>
<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 represantion, while still being
readable.</p>
<p>Streamtuner2 uses it to store all of its configuration and radio station data files.
The MIME type of these files is <sys>application/json</sys> and they often look like: </p>
<code mime="application/json">
[
  {
    "title": "Station title..",
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]
</code>
<p>It's also the basis for JSPF, the JSON variant of XSPF.</p>
</section>

<section>
<title>.XSPF files</title>
<info><desc>Xiph Shareable Playlist File</desc></info>
<p>The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced XML shareable playlist format "XSPF". 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>As MIME type <sys>application/xspf+xml</sys> and they often look like: </p>
<code mime="application/xspf+xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
  <trackList>
    <track>







|




















|
|







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

<section>
<title>.JSON files</title>
<info><desc>JavaScript Object-Notation</desc></info>
<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>Streamtuner2 uses it to store all of its configuration and radio station data files.
The MIME type of these files is <sys>application/json</sys> and they often look like: </p>
<code mime="application/json">
[
  {
    "title": "Station title..",
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]
</code>
<p>It's also the basis for JSPF, the JSON variant of XSPF.</p>
</section>

<section>
<title>.XSPF files</title>
<info><desc>Xiph Shareable Playlist File</desc></info>
<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>As MIME type <sys>application/xspf+xml</sys> and they often look like: </p>
<code mime="application/xspf+xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
  <trackList>
    <track>
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

<section>
<title>Uncommon formats</title>
<p>Various other file formats are in existence, but not widely used:</p>
<list>
  <item>
  <title>SMIL</title>
  <p>Synchronized Multimedia Integration Language is a HTML-style
  audio/video/stream-link format.</p>
  </item>
  <item>
  <title>ASX</title>
  <p>Is a Windows-only format, a variation of SMIL. There's an abhorrent
  number of similar formats, like .ASF and .WPL, basically doing the same
  thing. Nobody knows why.</p>







|







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

<section>
<title>Uncommon formats</title>
<p>Various other file formats are in existence, but not widely used:</p>
<list>
  <item>
  <title>SMIL</title>
  <p>Synchronized Multimedia Integration Language is an HTML-style
  audio/video/stream-link format.</p>
  </item>
  <item>
  <title>ASX</title>
  <p>Is a Windows-only format, a variation of SMIL. There's an abhorrent
  number of similar formats, like .ASF and .WPL, basically doing the same
  thing. Nobody knows why.</p>
114
115
116
117
118
119
120
121
122
123
124
125
126
  <p>*.desktop files can contain just one link.</p>
  </item>
  <item>
  <title>.url</title>
  <p>*.url (Internet Shortcut) files also are single-link containers.</p>
  </item>
</list>
<p>For a comparison of what various audio player support, see also
<link href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</link>
in the ST2 fossil wiki.</p>
</section>

</page>







|





114
115
116
117
118
119
120
121
122
123
124
125
126
  <p>*.desktop files can contain just one link.</p>
  </item>
  <item>
  <title>.url</title>
  <p>*.url (Internet Shortcut) files also are single-link containers.</p>
  </item>
</list>
<p>For a comparison of what various audio players support, see also
<link href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</link>
in the ST2 fossil wiki.</p>
</section>

</page>

Modified help/html/configuration.html from [1eb52962fb] to [a2922cc168].

136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<dd class="terms"><p class="p">Some channels provide proper APIs to fetch station lists. Others are just websites that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p></dd>
<dt class="terms">🔟 Limit stream number</dt>
<dd class="terms"><p class="p"> Constraints the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p></dd>
<dt class="terms">☑ Retain deleted stations</dt>
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often







|







136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<dd class="terms"><p class="p">Some channels provide proper APIs to fetch station lists. Others are just websites that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
      plugins often use a regex to match text. Occasionally the regex method is surprisingly more exact,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting, and thus speed it up.</p></dd>
<dt class="terms">🔟 Limit stream number</dt>
<dd class="terms"><p class="p"> Constrains the length of station lists per category.
      The number of stations option is not honored by all channel plugins. Often it's not possible to
      load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
      For the major plugins this however limits how many scrollable entries appear in the stream lists.</p></dd>
<dt class="terms">☑ Retain deleted stations</dt>
<dd class="terms"><p class="p">When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throw them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often

Modified help/html/filetypes.html from [96d25c7c46] to [d4f4b5e921].

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
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.JSON files</span></h2></div>
<div class="region"><div class="contents">
<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 represantion, while still being
readable.</p>
<p class="p">Streamtuner2 uses it to store all of its configuration and radio station data files.
The MIME type of these files is <span class="sys">application/json</span> and they often look like: </p>
<div class="code"><pre class="contents ">[
  {
    "title": "Station title..",
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]</pre></div>
<p class="p">It's also the basis for JSPF, the JSON variant of XSPF.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.XSPF files</span></h2></div>
<div class="region"><div class="contents">
<p class="p">The Xiph foundation manages the Ogg streaming format, Vorbis and other
codecs, and introduced XML shareable playlist format "XSPF". 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>
<div class="code"><pre class="contents syntax brush-html">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;playlist version="1" xmlns="http://xspf.org/ns/0/"&gt;
  &lt;trackList&gt;
    &lt;track&gt;
      &lt;title&gt;Top 500 hitz station XY&lt;/title&gt;







|


















|
|







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
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.JSON files</span></h2></div>
<div class="region"><div class="contents">
<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.
The MIME type of these files is <span class="sys">application/json</span> and they often look like: </p>
<div class="code"><pre class="contents ">[
  {
    "title": "Station title..",
    "url": "http://1.2.3.4:8000/",
    "homepage": "http://radio.org/",
  },
  { "title": "second" }
]</pre></div>
<p class="p">It's also the basis for JSPF, the JSON variant of XSPF.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">.XSPF files</span></h2></div>
<div class="region"><div class="contents">
<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>
<div class="code"><pre class="contents syntax brush-html">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;playlist version="1" xmlns="http://xspf.org/ns/0/"&gt;
  &lt;trackList&gt;
    &lt;track&gt;
      &lt;title&gt;Top 500 hitz station XY&lt;/title&gt;
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Uncommon formats</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Various other file formats are in existence, but not widely used:</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">SMIL</span></h3></div>
<p class="p">Synchronized Multimedia Integration Language is a HTML-style
  audio/video/stream-link format.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">ASX</span></h3></div>
<p class="p">Is a Windows-only format, a variation of SMIL. There's an abhorrent
  number of similar formats, like .ASF and .WPL, basically doing the same
  thing. Nobody knows why.</p>







|







83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Uncommon formats</span></h2></div>
<div class="region"><div class="contents">
<p class="p">Various other file formats are in existence, but not widely used:</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">SMIL</span></h3></div>
<p class="p">Synchronized Multimedia Integration Language is an HTML-style
  audio/video/stream-link format.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">ASX</span></h3></div>
<p class="p">Is a Windows-only format, a variation of SMIL. There's an abhorrent
  number of similar formats, like .ASF and .WPL, basically doing the same
  thing. Nobody knows why.</p>
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<p class="p">*.desktop files can contain just one link.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">.url</span></h3></div>
<p class="p">*.url (Internet Shortcut) files also are single-link containers.</p>
</li>
</ul></div></div></div>
<p class="p">For a comparison of what various audio player support, see also
<span class="link"><a href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support" title="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</a></span>
in the ST2 fossil wiki.</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">







|







109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<p class="p">*.desktop files can contain just one link.</p>
</li>
<li class="list">
<div class="title title-item"><h3><span class="title">.url</span></h3></div>
<p class="p">*.url (Internet Shortcut) files also are single-link containers.</p>
</li>
</ul></div></div></div>
<p class="p">For a comparison of what various audio players support, see also
<span class="link"><a href="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support" title="http://fossil.include-once.org/streamtuner2/wiki/Playlist+format+support">Playlist format support</a></span>
in the ST2 fossil wiki.</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">