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

⌈⌋ branch:  streamtuner2


Check-in [89ba7b5c8e]

Overview
Comment:Minor additions, more cross references, and Mallard note icons. Document Jamendo plugin options.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 89ba7b5c8e102c25add2b428565aa463a4185f4a
User & Date: mario on 2015-03-28 07:34:55
Other Links: manifest | tags
Context
2015-03-28
07:41
Moved project status notes into Fossil wiki. check-in: 21947be529 user: mario tags: trunk
07:34
Minor additions, more cross references, and Mallard note icons. Document Jamendo plugin options. check-in: 89ba7b5c8e user: mario tags: trunk
07:33
Basic rewrites to transition to fully plugin meta data capable implementation. check-in: 21d6d1cf4b user: mario tags: trunk
Changes

Modified help/action_homepage.page from [925ad15877] to [8a24a04e4d].

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="homepage">

	<info>
	<link type="guide" xref="index#functions"/>
	<desc>Start a web browser for a station.</desc>
	<link type="guide" xref="streams#actions"/>
	</info>

	<title>Radio homepages</title>

	<p>Most radio stations are listed with a homepage URL. Use the <gui>house</gui> symbol in the
	toolbar or <guiseq><gui>right click</gui> <gui>homepage</gui></guiseq> to open it in a web browser.</p>

        <p>Some homepage links are guessed, because some channels (e.g. Shoutcast) don't provide them (anymore).
	If you play a station without homepage URL, it automatically gets googled. (The link will be visible
        once you reselect the genre/category.)
        </p>













|







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="homepage">

	<info>
	<link type="guide" xref="index#functions"/>
	<desc>Start a web browser for a station.</desc>
	<link type="guide" xref="streams#actions"/>
	</info>

	<title>Radio homepages</title>

	<p>Most radio stations are listed with a homepage URL. Use the <gui style="button">house</gui> symbol in the
	toolbar or <guiseq><gui>right click</gui> <gui>homepage</gui></guiseq> to open it in a web browser.</p>

        <p>Some homepage links are guessed, because some channels (e.g. Shoutcast) don't provide them (anymore).
	If you play a station without homepage URL, it automatically gets googled. (The link will be visible
        once you reselect the genre/category.)
        </p>

Modified help/action_playing.page from [d7dfd37d58] to [bdf7add03c].

9
10
11
12
13
14
15
16

17
18
19
20
21
22
23
	</info>

	<title>Playing</title>

	<p>Simply double click a station entry. It starts with your configured audio player.</p>

        <p>In streamtuner2 you can configure different audio players for different audio
        formats (MP3 or OGG). In the 'Apps' section of the settings dialog, you can associate a player

        with each audio file (MIME) type. Per default this is audacious, but you can use any other
        media player (like VLC).</p>

        <note><p>Note however that some audio players will run multiple instance and won't
        allow simple station switching. In such situations it might be sensible to write
        a wrapper script, or configure special commandline arguments to your favoured audio
        player (e.g. "vlc --one-instance").</p></note>







|
>







9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
	</info>

	<title>Playing</title>

	<p>Simply double click a station entry. It starts with your configured audio player.</p>

        <p>In streamtuner2 you can configure different audio players for different audio
        formats (MP3 or OGG). In the <link xref="config_apps">Apps</link> section of the
        <link xref="configuration">settings dialog</link>, you can associate one player
        with each audio file (MIME) type. Per default this is audacious, but you can use any other
        media player (like VLC).</p>

        <note><p>Note however that some audio players will run multiple instance and won't
        allow simple station switching. In such situations it might be sensible to write
        a wrapper script, or configure special commandline arguments to your favoured audio
        player (e.g. "vlc --one-instance").</p></note>

Modified help/action_recording.page from [b83df63689] to [21ce04c854].

1
2
3
4
5
6
7
8
9
10
11
12
13
14

15
16
17

18
19
20
21
22
23

24
25
26
27
28
29
30
31
32

33
34
35
36
37
38
39
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="recording">

<info>
	<link type="guide" xref="streams#actions"/>
	<link type="guide" xref="configuration#recording"/>
	<link type="guide" xref="index#functions"/>
	<desc>Save radio songs as MP3 files via streamripper.</desc>
</info>

<title>Recording</title>

<p>Most stations that stream MP3 or OGG music can be recorded. This is accomplished through

the command-line tool "streamripper". If you select a station and press <gui style="button">● record</gui>,
a console window should appear, where streamripper shows its progress.</p>



<section>
<title>Streamripper</title>

<p>The <cmd>xterm -e</cmd> prefix brings up the terminal popup, to follow streamrippers
progress. Remove that for silent downloads.</p>


<table shade="rows" rules="rows cols">
  <thead>  <tr><td><p>Format</p></td>     <td><p>Application</p></td></tr> </thead>
  <tr><td><p><var>audio/*</var></p></td>  <td><p><cmd>xterm -e streamripper %srv</cmd></p></td></tr>
</table>

<p>To configure a default download directory, use the <cmd>-d</cmd> option to streamripper.
For example <cmd>xterm -e "streamripper -d /media/music/"</cmd> would use an absolute path.
Else it downloads to the current working directory (often your HOME path).</p>

</section>


<section>
<title>fIcy/fPls</title>

<p>As alternative to streamripper, check out <link href="http://freshcode.club/projects/ficy">fIcy/fPls</link>













|
>
|
|

>




|
|
>








|
>







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="recording">

<info>
	<link type="guide" xref="streams#actions"/>
	<link type="guide" xref="configuration#recording"/>
	<link type="guide" xref="index#functions"/>
	<desc>Save radio songs as MP3 files via streamripper.</desc>
</info>

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

<section>
<title>Streamripper</title>

<p>The <cmd>xterm -e</cmd> prefix brings up the terminal popup. If you want
silent downloads in the background instead of seeing its progress, remove
the xterm call.</p>

<table shade="rows" rules="rows cols">
  <thead>  <tr><td><p>Format</p></td>     <td><p>Application</p></td></tr> </thead>
  <tr><td><p><var>audio/*</var></p></td>  <td><p><cmd>xterm -e streamripper %srv</cmd></p></td></tr>
</table>

<p>To configure a default download directory, use the <cmd>-d</cmd> option to streamripper.
For example <cmd>xterm -e "streamripper -d /media/music/"</cmd> would use an absolute path.
Else it downloads to the current working directory (often your HOME path),
and creates one directory per radio station there.</p>
</section>


<section>
<title>fIcy/fPls</title>

<p>As alternative to streamripper, check out <link href="http://freshcode.club/projects/ficy">fIcy/fPls</link>

Modified help/action_saving.page from [2ed27dbb6c] to [0763672c97].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15


16
17

18
19

20
21
22
23
24
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="saving">

<info>
	<link type="guide" xref="index#functions"/>
	<link type="guide" xref="streams#actions"/>
	<desc>Export a station entry as .m3u/.pls file.</desc>
</info>

	<title>Saving</title>

	<p>You can export the currently selected stream using
	<guiseq><gui>Station</gui> <gui>Save</gui></guiseq>.  A file dialog
	opens, where you can adapt the title.  The extension of the filename


	decides on the saved link format.  Per default a .m3u file is
	created, because most audio players understand this format.</p>


	<p> But you can also save in .pls or .xspf or .asx or .smil format. 

	Note that the lower right dropdown has no effect. You have to edit the
	filename field.</p>


</page>













|
|
>
>
|
|
>

|
>
|
|



1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="saving">

<info>
	<link type="guide" xref="index#functions"/>
	<link type="guide" xref="streams#actions"/>
	<desc>Export a station entry as .m3u/.pls file.</desc>
</info>

	<title>Saving</title>

	<p>You can export the currently selected stream using
	<guiseq><gui>Station</gui> <gui>Save</gui></guiseq> or
	<key>F2</key>.  A file dialog opens, where you can adapt the title.
	</p>

	<p>The extension of the filename decides on the saved link format.  Per
	default a .m3u file is created, because that's what most audio players
	understand.</p>

	<note><p> But you can also save in <file>.pls</file> or <file>.xspf</file>
	or <file>.asx</file> or <file>.smil</file> format.  Note that the
	lower right dropdown has no effect.  You have to edit the extension
	into the filename field.</p></note>


</page>

Modified help/channel_bookmarks.page from [78eee67b88] to [f3ea068b31].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

19
20


21
22
23
24
25


26


27
28
29
30
31
32
33
34
35
36

37
38
39
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="bookmarks">

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="streams#actions"/>
        <desc>Collect favourites via bookmark function, entry editing and deleting.</desc>
</info>

	<title>Bookmarks</title>

	<p>It's easy to lose oversight when switching across channel tabs,
        genres and internet radio stations.  Therefore streamtuner2 allows
        to bookmark stations to collect favoured streams in a single place.</p>

        <p>Just right click a station you want to bookmark, and choose bookmark in the context

        menu. Alternatively you can use the Streams entry in the application menu. Once bookmarked
        you can see the station entry in the (!) "bookmarks" tab, under "favourite". That's where


        they go.</p>

	<section id="editing">
	<title>Editing</title>
        <p>Entries can be removed from the bookmark list again. Use the edit menu for that.</p>





	<p>Bookmarked stations are shown with a star in all other channel tabs. If you delete the
        entry there, it won't remove it from the real bookmarks list.</p>
	</section>

	<section id="other">
	<title>Subcategories</title>
	<p>The bookmarks tab can display other categories besides "favourite". For example the
	search feature creates a "search", while the "timer" and "links" plugins also display
	lists here.</p>
	<p>However the favourite list itself can not yet be categorized further.</p>

	</section>

</page>













<
|
|

|
>
|
|
>
>
|



|
>
>

>
>
|
<







|
>



1
2
3
4
5
6
7
8
9
10
11
12
13

14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

34
35
36
37
38
39
40
41
42
43
44
45
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="bookmarks">

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
	<link type="guide" xref="streams#actions"/>
        <desc>Collect favourites via bookmark function, entry editing and deleting.</desc>
</info>

	<title>Bookmarks</title>


	<p>Streamtuner2 allows to bookmark favoured streams/stations.
	Which is what the <gui style="menu">bookmarks</gui> tab is for, of course.</p>

        <p>Use the right click a stations <guiseq><gui>context menu</gui> <gui>bookmark</gui></guiseq>
        or <key>F8</key>.</p>

        <p>Once bookmarked the station is listed under
        <guiseq><gui style="menu">bookmarks</gui> <gui>favourite</gui></guiseq>.
        Additionally every appearance of the station in channel tabs gets a ★
        star icon.</p>

	<section id="editing">
	<title>Editing</title>
        <p>Entries can be removed from the bookmark list again. Use
        <guiseq><gui>Edit</gui> <gui>Delete</gui></guiseq> or the <key>DEL</key>
	key for that.</p>

        <p>You can also manually adapt an entry via <guiseq><gui>Station</gui> <gui>Edit</gui></guiseq> or <key>F3</key>.
	</p>


	</section>

	<section id="other">
	<title>Subcategories</title>
	<p>The bookmarks tab can display other categories besides "favourite". For example the
	search feature creates a "search", while the "timer" and "links" plugins also display
	lists here.</p>
	<note style="bug"><p>However the favourite list itself can not yet be categorized
	further.</p></note>
	</section>

</page>

Modified help/channel_jamendo.page from [2bc6bce1cf] to [aca793404b].

16
17
18
19
20
21
22

23
24

























25

        <p>The new Jamendo v3.0 is now utilized. It allows to list albums,
        playlists, and individual tracks by genre.  The radio list is static
        (they're looping over randomized songs from each genre.)</p>

        <p>Instead of favicons, streamtuner2 can fetch album or track
        covers.  Thus the images are a bit larger, and retrieving them all

        via Channel &gt; Load favicons...  takes a while longer.</p>


























</page>







>
|

>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>

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

        <p>The new Jamendo v3.0 is now utilized. It allows to list albums,
        playlists, and individual tracks by genre.  The radio list is static
        (they're looping over randomized songs from each genre.)</p>

        <p>Instead of favicons, streamtuner2 can fetch album or track
        covers.  Thus the images are a bit larger, and retrieving them all
via <guiseq><gui>Channel</gui> <gui>Load favicons...</gui></guiseq>
takes a while longer.</p>

<section id="options">
<title><link xref="configuration">Config</link> options</title>
<terms>
   <title>System</title>
   <item>
     <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>
     <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>
     <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 [3541eb6a94] to [755a76a43d].

17
18
19
20
21
22
23




24
             <item><p>XMP/libxmp</p></item>
             <item><p>MikMod</p></item>
             <item><p>MODPlug for XMMS</p></item>
             <item><p>GModplay</p></item>
             <item><p>VLC (built-in support)</p></item>
        </list>





</page>







>
>
>
>

17
18
19
20
21
22
23
24
25
26
27
28
             <item><p>XMP/libxmp</p></item>
             <item><p>MikMod</p></item>
             <item><p>MODPlug for XMMS</p></item>
             <item><p>GModplay</p></item>
             <item><p>VLC (built-in support)</p></item>
        </list>

	<note><p>See <link xref="recording">recording
	configuration</link> if you want to enable the download mode. (Audio
	files are packaged up in ZIP files on MODArchive.)</p></note>

</page>

Modified help/channel_myoggradio.page from [4f5ecdcc5f] to [23cd12b6a8].

11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

	<title>MyOggRadio</title>

	<p><link href="http://ehm.homelinux.org/MyOggRadio/">MyOggRadio</link> is an open
        source internet radio directory project. Since it provides its station list as
	JSON it's very well supported.</p>

        <p>Because the directory is currently still rather small,
	streamtuner2 provides the option to share radion station links.  Use
	the <guiseq><gui>Station</gui> <gui>Extensions</gui>
	<gui>Share...</gui></guiseq> menu entry to upload the currently
	selected radio (from your favourite bookmarks).</p>

        <p>The personal section is empty per default. You need to specify an user account
	in the settings dialog, and actually bookmark stations in MyOggRadio web site.
	Shared entries are not automatically in the MOR favorite list.</p>

	<p>There's also <link href="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</link>
	as specific frontend and player for MyOggRadio.</p>

<terms>
  <title>Channel options.</title>
  <item>







|
|
|
|
|


|
|







11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

	<title>MyOggRadio</title>

	<p><link href="http://ehm.homelinux.org/MyOggRadio/">MyOggRadio</link> is an open
        source internet radio directory project. Since it provides its station list as
	JSON it's very well supported.</p>

        <p>To help with populating the directory further,
	streamtuner2 provides an option to share radion station links.
	Use <guiseq><gui>Station</gui> <gui>Extensions</gui>
	<gui>Share on MyOggRadio...</gui></guiseq> menu entry to upload the currently
	selected radio (e.g. from your favourite bookmarks).</p>

        <p>The personal section is empty per default. You need to specify an user account
	in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
	Shared entries aren't automatically in the MOR favorite list.</p>

	<p>There's also <link href="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</link>
	as specific frontend and player for MyOggRadio.</p>

<terms>
  <title>Channel options.</title>
  <item>

Modified help/channel_shoutcast.page from [db8803fec4] to [e24b434587].

13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

	<p>SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
	station lists on shoutcast.com.
        </p>

        <list>
		<item><p>Station entries usually provide current playing information.</p></item>
		<item><p>Stream links are plain PLS files.</p></item>
		<item><p>Genres are subcategorized, so the main groups in the category
		list must be expanded to see the interesting entries.</p></item>
        </list>

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

<terms>
  <title>There are a few plugin options for this channel.</title>
  <item>
    <title><code>PyQuery parsing</code></title>
    <p>Uses an XML parser to extract station data from within HTML &lt;tags&gt; of the shoutcast.com site. This is
    slower, but often more reliable than regular expressions, which look for plain text markers.</p>
  </item>
</terms>

</page>







|








<
<
<
<
<
<
<
<


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








29
30

	<p>SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
	station lists on shoutcast.com.
        </p>

        <list>
		<item><p>Station entries usually provide current playing information.</p></item>
		<item><p>Stream links are plain <link xref="gloassry_pls">PLS files</link>.</p></item>
		<item><p>Genres are subcategorized, so the main groups in the category
		list must be expanded to see the interesting entries.</p></item>
        </list>

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










</page>

Modified help/channel_xiph.page from [7c08eb127b] to [4121e0845e].

26
27
28
29
30
31
32
33
34
35
36
37
38

<terms>
  <title>Channel options.</title>
  <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
    and low quality microphone sources. To filter these out, and only leave high quality music
    stations, you can therefore set this option. OGG starts to sound well with 96 kbit/s (whereas
    MP3 often requires 148 or 192 at least).</p>
  </item>
</terms>

</page>







|





26
27
28
29
30
31
32
33
34
35
36
37
38

<terms>
  <title>Channel options.</title>
  <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
    and low quality microphone sources. To filter these out, and only leave high quality music
    stations, you can therefore change this option. OGG starts to sound well with 96 kbit/s (whereas
    MP3 often requires 148 or 192 at least).</p>
  </item>
</terms>

</page>

Modified help/channel_youtube.page from [8eb410d49b] to [726ac47b89].

11
12
13
14
15
16
17
18
19


20






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




36
37
38

	<title>Youtube</title>

	<p>Googles <link href="https://youtube.com/">Youtube</link> provides a quirky
        JSON API that makes browsing channels and genres feasible. This beta plugin
        provides a little overview, and usually retrieves recent video uploads.</p>

        <p>VLC can directly play Youtube URLs. For other players the default application
        setting wraps <link href="http://youtube-dl.org/">youtube-dl</link>, which is also


        used for recording.</p>








<terms>
  <title>Channel options.</title>
  <item>
    <title><code>Region</code></title>
    <p>With the country dropdown you can predefine which mostPopular listins are returned.</p>
  </item>
  <item>
    <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>




</terms>

</page>







|
|
>
>
|
>
>
>
>
>
>















>
>
>
>



11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

	<title>Youtube</title>

	<p>Googles <link href="https://youtube.com/">Youtube</link> provides a quirky
        JSON API that makes browsing channels and genres feasible. This beta plugin
        provides a little overview, and usually retrieves recent video uploads.</p>

        <p>VLC can directly play Youtube URLs. For other players one can use
        <link href="http://youtube-dl.org/">youtube-dl</link> as wrapper.
        For example <cmd>totem $(youtube-dl %srv)</cmd> as configured player
        command.</p>
        
        <p>Youtube-dl is preconfigued as "recording"/download tool for this channel
        tab.</p>

        <p>Of course you could also just invoke a specific YT video by
        opening it in your web browser - click the station <key>home</key>
        button simply.</p>


<terms>
  <title>Channel options.</title>
  <item>
    <title><code>Region</code></title>
    <p>With the country dropdown you can predefine which mostPopular listins are returned.</p>
  </item>
  <item>
    <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>
    <p>Only influences the video homepage link.</p>
  </item>
</terms>

</page>

Modified help/channels.page from [e25889019f] to [7e889cc321].

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

	<section id="homepage">
	<title>Channel service homepage</title>
	<p>You can dobule click the channel tab to visit the channel/directory homepage.
	Alternatively there is an entry in the <gui>Channel</gui> menu.</p>
	</section>

	<section id="homepage">
	<title>Channel menu options</title>
	<terms>
		<item>
			<title>Homepage of directory service</title>
			<p>Opens a webbrowser with the current channels website.</p>
		</item>
		<item>
			<title>Reload</title>
			<p>Updates the current category and displays fresh station lists.</p>
		</item>
		<item>
			<title>Update favicons...</title>
			<p>Starts assembling favicons for the current list of stations in the background.
			To actually display the freshly loaded favicons, reselect the current category.</p>
		</item>
		<item>
			<title>Reload category tree</title>
			<p>Updates the genre list in the left category pane.
			For most channels the category list is already complete, but it might
			change over time. So this option often only is used for initializing streamtuner2
			channels when the list is empty.</p>
		</item>
	</terms>
	<p>The channel menu also contains a list of available channels. Select an entry to switch
	into that tab.</p>
	</section>

</page>







|
|


















|








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

	<section id="homepage">
	<title>Channel service homepage</title>
	<p>You can dobule click the channel tab to visit the channel/directory homepage.
	Alternatively there is an entry in the <gui>Channel</gui> menu.</p>
	</section>

	<section id="actions">
	<title>Channel menu actions</title>
	<terms>
		<item>
			<title>Homepage of directory service</title>
			<p>Opens a webbrowser with the current channels website.</p>
		</item>
		<item>
			<title>Reload</title>
			<p>Updates the current category and displays fresh station lists.</p>
		</item>
		<item>
			<title>Update favicons...</title>
			<p>Starts assembling favicons for the current list of stations in the background.
			To actually display the freshly loaded favicons, reselect the current category.</p>
		</item>
		<item>
			<title>Reload category tree</title>
			<p>Updates the genre list in the left category pane.
			For most channels the category list is already complete, but it might
			change over time. So this option is often only used for initializing streamtuner2
			channels when the list is empty.</p>
		</item>
	</terms>
	<p>The channel menu also contains a list of available channels. Select an entry to switch
	into that tab.</p>
	</section>

</page>

Modified help/cli.page from [b1f0422cfc] to [01b21f5802].

44
45
46
47
48
49
50


51
52

53
54
            <p>Fetches the current list of available categories/genres for a channel service.</p>
          </item>
        </terms>

	<p>Specifying a channel name is often optional. If you add one, it should be all-lowercase.
	You can also give a list, like "shoutcast,xiph" which would be searched then.</p>



	<p>GUI mode: There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
	is picked depending on Python version. But you can manually override this.</p>


</page>







>
>
|

>


44
45
46
47
48
49
50
51
52
53
54
55
56
57
            <p>Fetches the current list of available categories/genres for a channel service.</p>
          </item>
        </terms>

	<p>Specifying a channel name is often optional. If you add one, it should be all-lowercase.
	You can also give a list, like "shoutcast,xiph" which would be searched then.</p>

        <section>
        <title>GUI options</title>
	<p>There are also --gtk3 and --gtk2 command line options. Usually the right toolkit
	is picked depending on Python version. But you can manually override this.</p>
	</section>

</page>

Modified help/config_apps.page from [c46ba2ba34] to [648f589300].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="config_apps">

<info>
	<link type="guide" xref="configuration#apps"/>
	<link type="guide" xref="index#configuration"/>
	<desc>Common applications to use as players.</desc>
</info>

	<title>Audio players</title>

	<p>On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
	<link xref="configuration">configure</link> most of them as target application. Mostly it makes sense to use a single





|
|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="config_apps">

<info>
	<link type="seealso" xref="index#configuration"/>
	<link type="guide" xref="configuration#apps"/>
	<desc>Common applications to use as players.</desc>
</info>

	<title>Audio players</title>

	<p>On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
	<link xref="configuration">configure</link> most of them as target application. Mostly it makes sense to use a single

Modified help/configuration.page from [8010e28e83] to [b22f222667].

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" group="first"
    id="configuration">

<info>
    <link type="guide" xref="index#configuration"/>
    <desc><key>F12</key> brings up the options window with the Player, Display, System and Plugin sections.</desc>
</info>

<title>Settings dialog</title>


<p>There are various options for streamtuner2, available under <guiseq><gui>Edit</gui>
<gui>Preferences</gui></guiseq> or via <key>F12</key>.
</p>

<terms>
  <title>It's separated into three main areas.</title>
  <item>
    <title>Player</title>












>
|







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

<info>
    <link type="guide" xref="index#configuration"/>
    <desc><key>F12</key> brings up the options window with the Player, Display, System and Plugin sections.</desc>
</info>

<title>Settings dialog</title>

<p>
There are various options for streamtuner2, available under <guiseq><gui>Edit</gui>
<gui>Preferences</gui></guiseq> or via <key>F12</key>.
</p>

<terms>
  <title>It's separated into three main areas.</title>
  <item>
    <title>Player</title>
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
    <item>
      <title>Show bookmark star</title>
      <p>Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p>
    </item>
    <item>
      <title>Gtk+ theme</title>
      <p>Be careful. While Gtk allows to select a different theme per application, not all themes
      work right away. Switching the theme might hang streamtuner2. Just restart if that happens.</p>
    </item>
    <item>
      <title>Save window states</title>
      <p>Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <guiseq><gui>Edit</gui> <gui>Save States</gui></guiseq>.</p>







|







99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
    <item>
      <title>Show bookmark star</title>
      <p>Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p>
    </item>
    <item>
      <title>Gtk+ theme</title>
      <p><em style="bug">Be careful</em>. While Gtk allows to select a different theme per application, not all themes
      work right away. Switching the theme might hang streamtuner2. Just restart if that happens.</p>
    </item>
    <item>
      <title>Save window states</title>
      <p>Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <guiseq><gui>Edit</gui> <gui>Save States</gui></guiseq>.</p>
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
    </item>
 </terms>

  <terms>
    <title>System</title>
    <item>
      <title>Temporary files</title>
      <p>Streamtuner2 creates temporary .m3u files, if an audio player is configured to use %m3u files
      instead of %pls or %srv URLs. For archival purposes, you might want to set a dedicated directory
      for this. Leave this to the default /tmp else.</p>
    </item>
    <item>
      <title>Config directory</title>
      <p>Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc.
      You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME
      environment variable to adapt.</p>
    </item>
    <item>
      <title>Enable debug messages</title>
      <p>If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
      and processing or debug infos. Enable this only for testing, as it might slow down station
      rendering.</p>







|
|




|
|







151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
    </item>
 </terms>

  <terms>
    <title>System</title>
    <item>
      <title>Temporary files</title>
      <p>Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files
      instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory
      for this. Leave this to the default /tmp else.</p>
    </item>
    <item>
      <title>Config directory</title>
      <p>Is where streamtuner2 keeps its <file>settings.json</file> and channel caches, favicons, etc.
      You can't set this in the config dialog. This is just for display. Set the <sys>XDG_CONFIG_HOME</sys>
      environment variable to adapt.</p>
    </item>
    <item>
      <title>Enable debug messages</title>
      <p>If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
      and processing or debug infos. Enable this only for testing, as it might slow down station
      rendering.</p>
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193

    <p>This tab lists all available channel and feature plugins. Mark checkboxes for those plugins
    you want to enable. You have to restart Streamtuner2 for any changes here to take effect.</p>

    <p>Each channel plugin may come with its own set of addition configuration settings
    below.</p>

    <p>If you want to find out more about the short option descriptions (most settings are checkboxes),
    please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
    *.py files. These are readable, and sometimes contain more information.</p>
</section>



</page>







|

|





180
181
182
183
184
185
186
187
188
189
190
191
192
193
194

    <p>This tab lists all available channel and feature plugins. Mark checkboxes for those plugins
    you want to enable. You have to restart Streamtuner2 for any changes here to take effect.</p>

    <p>Each channel plugin may come with its own set of addition configuration settings
    below.</p>

    <note style="note"><p>If you want to find out more about the short option descriptions (most settings are checkboxes),
    please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
    *.py files. These are readable, and sometimes contain more information.</p></note>
</section>



</page>

Modified help/global_key.page from [2c1d73522f] to [a8e726e2d6].

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

<info>
	<link type="guide" xref="index#extra"/>
        <desc>Global keyboard shortcut for radio switching.</desc>
</info>

	<title>Global_key</title>

	<p>Using the global_key extension you can define a keyboard shortcut for switching within
	a list of favourite radio stations. Per default it uses your bookmarks list, but it can be
	configured to alternate in any other channel.</p>

	<p>This is useful if you don't want to keep the streamtuner2 window in the foreground
	all the time, but still want to switch radios easily.</p>

	<p>Go into settings <key>F12</key> for plugins to define a keyboard shortcut:</p>

	<table shade="rows" rules="rows cols">
	<thead>	<tr><td><p>keyspec</p></td>                   <td><p>corresponds to</p></td></tr> </thead>
		<tr><td><p><input>F9</input></p></td>              <td><p>Responds to only <key>F9</key>. (too generic)</p></td></tr>
		<tr><td><p><input>&lt;Meta&gt;R</input></p></td>   <td><p>often the 'Windows'-key and R</p></td></tr>

|













|
|







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

<info>
	<link type="guide" xref="index#extra"/>
        <desc>Global keyboard shortcut for radio switching.</desc>
</info>

	<title>Global_key</title>

	<p>Using the global_key extension you can define a keyboard shortcut for switching within
	a list of favourite radio stations. Per default it uses your bookmarks list, but it can be
	configured to alternate in any other channel.</p>

	<p>This is useful if you don't want to keep streamtuner2 atop your
	desktop all the time, but still want to switch radios easily.</p>

	<p>Go into settings <key>F12</key> for plugins to define a keyboard shortcut:</p>

	<table shade="rows" rules="rows cols">
	<thead>	<tr><td><p>keyspec</p></td>                   <td><p>corresponds to</p></td></tr> </thead>
		<tr><td><p><input>F9</input></p></td>              <td><p>Responds to only <key>F9</key>. (too generic)</p></td></tr>
		<tr><td><p><input>&lt;Meta&gt;R</input></p></td>   <td><p>often the 'Windows'-key and R</p></td></tr>

Modified help/glossary.page from [fdb0bc7317] to [f9acb8a091].

1
2
3
4
5
6
7
8
9
10
11
12
13
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="glossary">

<info>
	<link type="guide" xref="index#extra"/>
	<desc>Technical and streamtuner2 specific terminology and jargon.</desc>
</info>

	<title>Glossary</title>








|







1
2
3
4
5
6
7
8
9
10
11
12
13
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="glossary">

<info>
	<link type="topic" xref="index#extra"/>
	<desc>Technical and streamtuner2 specific terminology and jargon.</desc>
</info>

	<title>Glossary</title>



Modified help/glossary_pls.page from [ce07c24f1a] to [cc14ff4447].

1
2
3
4
5
6
7
8
9
10
11
12
13
14

15
16
17
18
19
20
21
22
23
24
25
26
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="pls">

<info>
	<link type="guide" xref="glossary#filetypes"/>
        <desc>Playlist file format.</desc>
</info>

	<title>.PLS files</title>

	<p>Playlist files often have the extension .pls</p>

	<p>It's the primary station stream link format of SHOUTcast.</p>


	<p>The MIME type of these files is audio/x-scpls and they often look like: </p>

<code mime="audio/x-scpls">
[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>

</page>













|
>

|










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

<info>
	<link type="guide" xref="glossary#filetypes"/>
        <desc>Playlist file format.</desc>
</info>

	<title>.PLS files</title>

	<p>Playlist files often have the extension .pls</p>

	<p>It's the primary station stream link format of SHOUTcast, and was
	popularized by WinAmp.</p>

	<p>The MIME type of these files is <sys>audio/x-scpls</sys> and they often look like: </p>

<code mime="audio/x-scpls">
[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>

</page>

Modified help/introduction.page from [3987e9e782] to [aac694493f].

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

	<section id="actions">
	<title>What else can you do?</title>
	<p>Double clicking an entry row in the radio list starts your audio player. But there are
	other functions available. Either go to the <guiseq><gui/><gui>Station</gui></guiseq> menu,
	or access the context menu with a right click.</p>
	<table shade="rows" rules="rows cols">
		<tr><td><p>Play</p></td><td><p>Starts the radio in a configured audio player</p></td></tr>
		<tr><td><p>Record</p></td><td><p>Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs.</p></td></tr>
		<tr><td><p>Bookmarks</p></td><td><p>Copy radio entry over into the <gui>bookmarks</gui> channel.</p></td></tr>
		<tr><td><p>Homepage</p></td><td><p>Most radio stations have a homepage. Open this in a web browser.</p></td></tr>
		<tr><td><p>Saving</p></td><td><p>A radio entry can be exported as .m3u or .pls file.</p></td></tr>
		<tr><td><p>Extensions<guiseq><gui/><gui/></guiseq></p></td><td><p>Some plugins add other features in this submenu.</p></td></tr>
		<tr><td><p>Editing</p></td><td><p>This command is in the <gui>Edit</gui> and context menu, allows to inspect and modify radio descriptions.</p></td></tr>
		<tr><td><p>Searching</p></td><td><p>You can get a radio list according to search criteria.</p></td></tr>
	</table>
	<p> Play, Record and Homepage also have buttons in the toolbar.</p>







|
|
|







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

	<section id="actions">
	<title>What else can you do?</title>
	<p>Double clicking an entry row in the radio list starts your audio player. But there are
	other functions available. Either go to the <guiseq><gui/><gui>Station</gui></guiseq> menu,
	or access the context menu with a right click.</p>
	<table shade="rows" rules="rows cols">
		<tr><td><p><link xref="playing">Play</link></p></td><td><p>Starts the radio in a configured audio player</p></td></tr>
		<tr><td><p><link xref="recording">Record</link></p></td><td><p>Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs.</p></td></tr>
		<tr><td><p><link xref="bookmarks">Bookmarks</link></p></td><td><p>Copy radio entry over into the <gui>bookmarks</gui> channel.</p></td></tr>
		<tr><td><p>Homepage</p></td><td><p>Most radio stations have a homepage. Open this in a web browser.</p></td></tr>
		<tr><td><p>Saving</p></td><td><p>A radio entry can be exported as .m3u or .pls file.</p></td></tr>
		<tr><td><p>Extensions<guiseq><gui/><gui/></guiseq></p></td><td><p>Some plugins add other features in this submenu.</p></td></tr>
		<tr><td><p>Editing</p></td><td><p>This command is in the <gui>Edit</gui> and context menu, allows to inspect and modify radio descriptions.</p></td></tr>
		<tr><td><p>Searching</p></td><td><p>You can get a radio list according to search criteria.</p></td></tr>
	</table>
	<p> Play, Record and Homepage also have buttons in the toolbar.</p>

Modified help/reloading.page from [97b72bc5a3] to [15ff08e456].

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="reloading">

<info>
	<link type="guide" xref="streams#actions"/>
        <desc>Updating station lists.</desc>
</info>

	<title>Reloading</title>
        <p>Station information can get stale. Especially Shoutcast invalidates old information
        frequently. Therefore you have to [Reload] the lists. There is an action button below
        the menu bar for this. It retrieves the current data from the directory service.</p>

	<p>Favicons aren't loaded automatically. There is a menu entry in Channels for that, which
        works in the background and doesn't display the new icons automatically either. Simply
        reselect the category/genre in the left pane. Or again, use the station reload button.</p>


</page>











|








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="reloading">

<info>
	<link type="guide" xref="streams#actions"/>
        <desc>Updating station lists.</desc>
</info>

	<title>Reloading</title>
        <p>Station information can get stale. Especially Shoutcast invalidates old information
        frequently. Therefore you have to <guiseq><gui></gui> <gui>Reload</gui></guiseq> the lists. There is an action button below
        the menu bar for this. It retrieves the current data from the directory service.</p>

	<p>Favicons aren't loaded automatically. There is a menu entry in Channels for that, which
        works in the background and doesn't display the new icons automatically either. Simply
        reselect the category/genre in the left pane. Or again, use the station reload button.</p>


</page>

Modified help/search.page from [9e8c65c6ba] to [eb9178cf8b].

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

        <p>It either will search in all channels, or just the last active
        channel/service.</p>

	<p>Then there are two search methods.  You mostly want to use
        the live <gui>Server search</gui>.  It passes your search terms to
        the actual directory services, and loads the most recent data into a
        result list (this might take a few seconds).  It's not implemented
        for all channel plugins however.</p>

	<p>With <gui>Cache find</gui> would just look up entries in your
        already downloaded channel/genre lists.  Since often you are just
        looking for something you had already seen, this will give you the
        desired results.</p>

	</section>

</page>







|



|
|
<




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

43
44
45
46

        <p>It either will search in all channels, or just the last active
        channel/service.</p>

	<p>Then there are two search methods.  You mostly want to use
        the live <gui>Server search</gui>.  It passes your search terms to
        the actual directory services, and loads the most recent data into a
        result list. This might take a few seconds. And it's not implemented
        for all channel plugins however.</p>

	<p>With <gui>Cache find</gui> would just look up entries in your
        already downloaded channel/genre lists.  This is sufficient when
        you're just looking for something previously seen/listended to.</p>


	</section>

</page>

Modified help/technical.page from [dc272f5824] to [f416212abd].

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="technical">

<info>
	<link type="guide" xref="index#extra"/>
        <desc>Filenames, Directories, Dependencies</desc>
</info>

	<title>Technical information</title>


	<section id="dependecies">
        <terms>
  	  <title>Dependencies</title>
          <item><p>Python 2.7 or 3.x</p></item>
          <item><p>PyGtk or PyGI</p></item>
          <item><p>Gtk2 or Gtk3</p></item>
          <item><p>Requests/urllib3</p></item>
	</terms>
        <terms>
  	  <title>Soft dependencies</title>
          <item><p>Python-LXML</p></item>
          <item><p>Python-PyQuery</p></item>
          <item><p>Python-Kronos</p></item>
          <item><p>Audacious</p></item>
	</terms>
	</section>


	<section id="config_files">





|









|
|

|



|
|







1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<page	xmlns="http://projectmallard.org/1.0/"
	type="guide"
	id="technical">

<info>
	<link type="topic" xref="index#extra"/>
        <desc>Filenames, Directories, Dependencies</desc>
</info>

	<title>Technical information</title>


	<section id="dependecies">
        <terms>
  	  <title>Dependencies</title>
          <item><p><link action="install:python">Python 2.7 or 3.x</link></p></item>
          <item><p><link action="install:python-gtk2">PyGtk or PyGI</link></p></item>
          <item><p>Gtk2 or Gtk3</p></item>
          <item><p><link action="install:python-requests">Requests/urllib3</link></p></item>
	</terms>
        <terms>
  	  <title>Soft dependencies</title>
          <item><p><link action="install:python-lxml">Python-LXML</link></p></item>
          <item><p><link action="install:python-pyquery">Python-PyQuery</link></p></item>
          <item><p>Python-Kronos</p></item>
          <item><p>Audacious</p></item>
	</terms>
	</section>


	<section id="config_files">