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

⌈⌋ ⎇ branch:  streamtuner2


Check-in [d1befc2a99]

Overview
Comment:Minor typo fixes.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: d1befc2a99b5b2b2170915bc32e519c9946c66db
User & Date: mario on 2015-05-09 21:36:57
Other Links: manifest | tags
Context
2015-05-09
21:37
Use custom GenericChannel.columns() wrapper to simplify passing TreeView widget and keeping returned liststore/rowmap/pix_entry. check-in: 5d8d7fd191 user: mario tags: trunk
21:36
Minor typo fixes. check-in: d1befc2a99 user: mario tags: trunk
21:36
Return ListStore, rowmap and pix_entry from uikit.columns() check-in: 8b187d699a user: mario tags: trunk
Changes

Modified help/action_edit.page from [a9168de12d] to [474edb59e2].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="edit">

<info>
	<link type="guide" xref="index#functions"/>
	<link type="guide" xref="streams#actions"/>
	<desc>Edit or inspect a station entry.</desc>
</info>

	<title>Edit</title>

	<p>You probably don't often need this. But there's an
	<guiseq><gui></gui> <gui>Edit/Details</gui></guiseq> context menu
	which brings up a station editor:
	</p>
	
	<media type="image" src="img/streamedit.png" mime="image/png" />

	<p>You can see the standard title and genre fields here. But also a












|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="edit">

<info>
	<link type="guide" xref="index#functions"/>
	<link type="guide" xref="streams#actions"/>
	<desc>Edit or inspect a station entry.</desc>
</info>

	<title>Edit</title>

	<p>You probably won't need this often. But there's an
	<guiseq><gui></gui> <gui>Edit/Details</gui></guiseq> context menu
	which brings up a station editor:
	</p>
	
	<media type="image" src="img/streamedit.png" mime="image/png" />

	<p>You can see the standard title and genre fields here. But also a

Modified help/channel_internetradioorguk.page from [3e6f88dc2e] to [7d2361e1e8].

12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
	<title>Internet-Radio</title>
        <subtitle><link href="http://internet-radio.com/">//internet-radio.com/</link></subtitle>
        
	<p>Internet-Radio.com is a broad alternative to Shoutcast.</p>
	<list>
 	 <item><p>It has regained station homepages for most entries again.</p></item>
 	 <item><p>Genres are similiar to Shoutcast.</p></item>
 	 <item><p>Updating station list is comperatively fast.</p></item>
 	</list>

        <section id="options">
        <title>Configuration</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>
	</section>

</page>







|










12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
	<title>Internet-Radio</title>
        <subtitle><link href="http://internet-radio.com/">//internet-radio.com/</link></subtitle>
        
	<p>Internet-Radio.com is a broad alternative to Shoutcast.</p>
	<list>
 	 <item><p>It has regained station homepages for most entries again.</p></item>
 	 <item><p>Genres are similiar to Shoutcast.</p></item>
 	 <item><p>Updating station lists is comperatively fast.</p></item>
 	</list>

        <section id="options">
        <title>Configuration</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>
	</section>

</page>

Modified help/channel_radionomy.page from [588c29d549] to [53cbc94f9b].

21
22
23
24
25
26
27
28


29
30
31
32
33
34
35
	which radionomy itself hosts streaming servers for.  It's over 6000
	already.  Both listening and station hosting are free (given agreement
	to autoplay advertisements, and a minimum quota of daily listeners). 
	Radionomy is therefore pretty popular and growing.</p>
	
	<p>The extraction method in streamtuner2 uses a mix of RegExp,
	DOM traversal, and JSON extraction, with some AJAX updating spiced
	in. (It closely follows the website scheme to fetch station lists.)


	</p>
	
	<section id="options">
	 <title>Configuration</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>







|
>
>







21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
	which radionomy itself hosts streaming servers for.  It's over 6000
	already.  Both listening and station hosting are free (given agreement
	to autoplay advertisements, and a minimum quota of daily listeners). 
	Radionomy is therefore pretty popular and growing.</p>
	
	<p>The extraction method in streamtuner2 uses a mix of RegExp,
	DOM traversal, and JSON extraction, with some AJAX updating spiced
	in. It closely follows the website scheme to fetch station lists.
	Instead of favicons smaller station logos are displayed (25px
	in contrast to the usual 16px).
	</p>
	
	<section id="options">
	 <title>Configuration</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>

Modified help/channel_xiph.page from [22866e4d09] to [cff20259ec].

8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

28
29
30
31
32
33
34
	<link type="guide" xref="configuration#plugins"/>
        <desc>ICEcast radio directory.</desc>
</info>

	<title>Xiph.org</title>
	<subtitle><link	href="http://dir.xiph.org/">//dir.xiph.org/</link></subtitle>

	<p>Xiph.org is a non-profit organization, which develops and
	promotes the OGG streaming format, and develops audio compression
	schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
	enve.  It also hosts a list of ICEcast streaming stations. ICEcast
	is their non-commercial pendant to the SHOUTcast server.</p>

        <p>This channel is somehwat easy to read for Streamtuner2, because the source data is already
        provided as &lt;XML&gt; file. (Internally we're using a caching service, which pre-converts
        that into JSON lists. The Xiph-org JSON API isn't really working yet).</p>

        <p>However, it lacks some essential informations like station homepages and listener numbers.</p>

        <p>Xiph also uses the .xspf format, instead of .pls stream links</p>


<section id="options">
  <title>Channel options.</title>
  <terms>
  <item>
    <title><code>Filter by minimum bitrate</code></title>
    <p>The bitrate of an audio stream determines the music quality. Many Xiph streams have simple







|


|


|
|
<
|
|

|
>







8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

23
24
25
26
27
28
29
30
31
32
33
34
	<link type="guide" xref="configuration#plugins"/>
        <desc>ICEcast radio directory.</desc>
</info>

	<title>Xiph.org</title>
	<subtitle><link	href="http://dir.xiph.org/">//dir.xiph.org/</link></subtitle>

	<p>Xiph.org is a non-profit organization, which maintains and
	promotes the OGG streaming format, and develops audio compression
	schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
	format.  It also hosts a list of ICEcast streaming stations. ICEcast
	is their non-commercial pendant to the SHOUTcast server.</p>

        <p>There are different ways for streamtuner2 to retrieve the station
        lists available on dir.xiph.org.  That's because this is a primary

        plugin, and fallback solutions therefore important.  Each fetching
        mode has its own advantages and drawbacks though.</p>

        <p>Xiph also uses the .xspf playlist format, instead of just the
        more ancient Shoutcast .pls stream links.</p>

<section id="options">
  <title>Channel options.</title>
  <terms>
  <item>
    <title><code>Filter by minimum bitrate</code></title>
    <p>The bitrate of an audio stream determines the music quality. Many Xiph streams have simple
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
        slow station list download/unpacking.
        </p>
      </item>
      <p></p>
      <item>
        <title><code>Forbidden fruits</code></title>
        <p>As new alternative, you can let ST2 directly scrape the station
        lists from dir.xiph.org (like it does for other channels). This is
        something which Xiph doesn't like/encourage. But the drawbacks of
        their alternative offerings are too severe and user-unfriendly;
        which is why there's this raw HTML extraction mode now.</p><p>The website
        listings contain full station homepages and a few more extras. In
        this mode we can even acceess the XSPF playlist formats directly.
        And the server search function, or browsing by audio/video format is
        supported.
        </p>
      </item>
    </terms>
  </item>
  </terms>
</section>

</page>







|
|
|
|
|
|
|
|
<







66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

81
82
83
84
85
86
87
        slow station list download/unpacking.
        </p>
      </item>
      <p></p>
      <item>
        <title><code>Forbidden fruits</code></title>
        <p>As new alternative, you can let ST2 directly scrape the station
        lists from dir.xiph.org (like it does for other channels).  This is
        something which Xiph doesn't approve of.  But the drawbacks of their
        alternative offerings are too severe and user-unfriendly; which is
        why there's this raw HTML extraction mode now.</p>
        <p>The website listings contain full station homepages and a few
        more extras.  In this mode we can even acceess the XSPF playlist
        formats directly.  Both, the server search function, or browsing by
        audio/video format are supported.  </p>

      </item>
    </terms>
  </item>
  </terms>
</section>

</page>

Modified help/pluginmanager2.page from [2d93aaf423] to [a90ffe8159].

16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
	
	<steps>
	 <item><p>See the <key>F12</key> config dialog <key>🔌 Feature</key> section.</p></item>
	 <item><p>Enable the <key>⨯</key> Plugin Manager (listed near the end).</p></item>
	 <item><p>Restart streamtuner2 one last time for this change to take effect.</p></item>
	</steps>
	
	<p>Once acticated it brings up a new <key>📦 Add</key> tab
	in the configuration window.</p>
	
	<p><media type="image" src="img/pluginmanager2.png"
	mime="image/png">Install dialog for user plugins</media></p>
	
	<p>You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not







|







16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
	
	<steps>
	 <item><p>See the <key>F12</key> config dialog <key>🔌 Feature</key> section.</p></item>
	 <item><p>Enable the <key>⨯</key> Plugin Manager (listed near the end).</p></item>
	 <item><p>Restart streamtuner2 one last time for this change to take effect.</p></item>
	</steps>
	
	<p>Once activated it brings up a new <key>📦 Add</key> tab
	in the configuration window.</p>
	
	<p><media type="image" src="img/pluginmanager2.png"
	mime="image/png">Install dialog for user plugins</media></p>
	
	<p>You can scan for available/new plugins there. And have them
	downloaded right away. New plugins are just downloaded, not