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

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


Check-in [54d59ae47f]

Overview
Comment:Minor simplifications in manual, remove iCast page.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 54d59ae47fa93ddfde59bc335dc8b18e78f2c8d0
User & Date: mario on 2015-05-18 00:28:04
Other Links: manifest | tags
Context
2015-05-18
00:28
Remove _=time from streaminfo json urls. check-in: b23180bba7 user: mario tags: trunk
00:28
Minor simplifications in manual, remove iCast page. check-in: 54d59ae47f user: mario tags: trunk
2015-05-17
19:13
Adapt config options (color, and type: int) check-in: eb460acb8f user: mario tags: trunk
Changes

Modified help/action_recording.page from [68b00a5e32] to [ee64709a1b].

41
42
43
44
45
46
47
48


49
50
51
52
53
54
55
     <list> <item><p><cmd>xterm -e "streamripper -A -s 3600 -d ~/Music/ %srv"</cmd></p></item> </list>
  </item>
  <item><p>Pretend to be an audio player (in case recording is blocked):</p>
     <list> <item><p><cmd>streamripper -u 'WinampMPEG/5.0' %srv</cmd></p></item> </list>
  </item>
</steps>

<p>Whenever you leave out the <cmd>xterm</cmd> prefix, it runs silently in the background.</p>



<p>See the streamripper(1) man page or its
<link href="http://streamripper.sourceforge.net/faq.php">FAQ</link> for more tips.</p>

</section>

<section>







|
>
>







41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
     <list> <item><p><cmd>xterm -e "streamripper -A -s 3600 -d ~/Music/ %srv"</cmd></p></item> </list>
  </item>
  <item><p>Pretend to be an audio player (in case recording is blocked):</p>
     <list> <item><p><cmd>streamripper -u 'WinampMPEG/5.0' %srv</cmd></p></item> </list>
  </item>
</steps>

<p>Whenever you leave out the <cmd>xterm</cmd> prefix, it runs silently in the background.
Common xterm alternatives are <cmd>x-terminal-emulator</cmd>, or <cmd>rxvt</cmd>,
<cmd>gnome-terminal</cmd>, and <cmd>xfce4-terminal</cmd> etc.</p>

<p>See the streamripper(1) man page or its
<link href="http://streamripper.sourceforge.net/faq.php">FAQ</link> for more tips.</p>

</section>

<section>

Deleted help/channel_icast.page version [eecefba447].

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"
	id="icast">

<info>
	<link type="guide" xref="index#channels"/>
	<link type="guide" xref="channels#list"/>
        <desc>iCast (removed)</desc>
</info>

	<title>iCast.io</title>
	<subtitle>removed</subtitle>

	<p>iCast was a collaborative (CC-BY-SA licensed entries) radio
	station directory.</p>
	
	<note style="bug"><p>As of May 2015 it seems to be down. Which is why the channel
	plugin got removed. It's still downloadable from contrib/ in the
	project repository or per Plugin Manager.</p></note>

</page>
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<










































Modified help/configuration.page from [2c9bf10605] to [5cb7e14a58].

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
51
52
53
54
55
56
57
58
59
60
61
62
<p>
There are various options for streamtuner2, available under <guiseq><gui>Edit</gui>
<gui>Preferences</gui></guiseq> or via <key>F12</key>.
</p>
  <p><media type="image" src="img/configtabs.png" mime="image/png" /></p>

<terms>
  <title>It's separated into different sections/tabs.</title>
  <item>
    <title>๐Ÿ”Š Player</title>
    <p>Lists audio formats and the audio player applications, or recording tools below.
    It's a map of file-types to applications. Double click an entry to edit it.</p>
  </item>
  <item>
    <title>โ˜‘ Options</title>
    <p>Influences the display of all stream/station lists, and contains some
    behaviour and system settings.</p>
  </item>
  <item>
    <title>๐Ÿ“ป Channel Plugins</title>
    <p>Every channel tab can have specific options. These are configured here.
    Also you can disable channels you don't need.</p>
  </item>
  <item>
    <title>๐Ÿ”Œ Feature Plugins</title>
    <p>Another class of plugins enables internal functions, or adds extra menu
    entries, or configuration options.</p>
  </item>
  <item>
    <title>๐Ÿ“ฆ Add</title>
    <p>The <link xref="pluginmanager2">Plugin Manager 2</link> adds another
    tab for updating or installing new plugins.</p>
  </item>
</terms>



<section id="apps">

    <title>Player application settings</title>

    <p>MIME types are categorzied identifiers for file types. <var>Audio/mpeg</var> for
    example represents MP3 files, and <var>audio/ogg</var> means just OGG.  And the player
    setting dialog simply associates an audio type with a playback application:</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/mpeg</var></p></td>     <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/ogg</var></p></td>      <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/*</var></p></td>        <td><p><cmd>vlc --one-instance</cmd></p></td></tr>







|


|
<








|
|




|














|
|







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
51
52
53
54
55
56
57
58
59
60
61
<p>
There are various options for streamtuner2, available under <guiseq><gui>Edit</gui>
<gui>Preferences</gui></guiseq> or via <key>F12</key>.
</p>
  <p><media type="image" src="img/configtabs.png" mime="image/png" /></p>

<terms>
  <title>It's grouped into:</title>
  <item>
    <title>๐Ÿ”Š Player</title>
    <p>Associates media formats to audio player applications or recording tools.</p>

  </item>
  <item>
    <title>โ˜‘ Options</title>
    <p>Influences the display of all stream/station lists, and contains some
    behaviour and system settings.</p>
  </item>
  <item>
    <title>๐Ÿ“ป Channel Plugins</title>
    <p>Allows to enable or disable channel tabs. Each can have specific
    options, which can be configured here.</p>
  </item>
  <item>
    <title>๐Ÿ”Œ Feature Plugins</title>
    <p>Another class of plugins enables internal functions, or adds extra menu
    entries, or further configuration options.</p>
  </item>
  <item>
    <title>๐Ÿ“ฆ Add</title>
    <p>The <link xref="pluginmanager2">Plugin Manager 2</link> adds another
    tab for updating or installing new plugins.</p>
  </item>
</terms>



<section id="apps">

    <title>Player application settings</title>

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

<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/mpeg</var></p></td>     <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/ogg</var></p></td>      <td><p><cmd>audacious</cmd></p></td></tr>
    <tr><td><p><var>audio/*</var></p></td>        <td><p><cmd>vlc --one-instance</cmd></p></td></tr>
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

<table shade="rows" rules="rows cols">
    <tr><td><p><var>audio/*</var></p></td>         <td><p><cmd>xterm -e streamripper %srv</cmd></p></td></tr>
    <tr><td><p><var>video/youtube</var></p></td>   <td><p><cmd>xterm -e "youtube-dl %srv"</cmd></p></td></tr>
</table>

    <p>To define a target directory, you can often add commandline arguments to each. Also it's typically
    helpful to leave the xterm prefix on, so you can follow the processing state. (Alternatively to
    xterm there is x-terminal-emulator, or rxvt, gnome-terminal, xfce4-terminal, etc.)</p>
</section>


<section id="gui">

  <title>Display/GUI options</title>
  <terms>







|
<







93
94
95
96
97
98
99
100

101
102
103
104
105
106
107

<table shade="rows" rules="rows cols">
    <tr><td><p><var>audio/*</var></p></td>         <td><p><cmd>xterm -e streamripper %srv</cmd></p></td></tr>
    <tr><td><p><var>video/youtube</var></p></td>   <td><p><cmd>xterm -e "youtube-dl %srv"</cmd></p></td></tr>
</table>

    <p>To define a target directory, you can often add commandline arguments to each. Also it's typically
    helpful to leave the xterm prefix on, so you can follow the processing state.</p>

</section>


<section id="gui">

  <title>Display/GUI options</title>
  <terms>
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
      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. Occassionally 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>[<input>250</input>] 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







|







134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
      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. Occassionally 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>[<input>500</input>] 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
153
154
155
156
157
158
159






160
161
162
163
164
165
166
      at the end of the list).</p>
    </item>
    <item>
      <title>Update favouries from freshened URLs</title>
      <p>Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't
      very reliable, as often station titles change together with the streaming URLs.</p>
    </item>






 </terms>

  <terms>
    <title>Playlist</title>
    <item>
      <title>Reuse .m3u/.pls files</title> <p>When converting online station playlists,
      streamtuner2 creates temporary files like <var>shoutcast.11539398391891.m3u</var> for







>
>
>
>
>
>







151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
      at the end of the list).</p>
    </item>
    <item>
      <title>Update favouries from freshened URLs</title>
      <p>Streaming URLs in bookmarked stations get renewed on category reloads/updates. This isn't
      very reliable, as often station titles change together with the streaming URLs.</p>
    </item>
    <item>
      <title>Save station lists after updates</title>
      <p>After reloading (<key>F5</key>) the updated station lists are
      autoamtically saved. For favicon updates or drag and drop events this
      only happens automatically when this option is set.</p>
    </item>
 </terms>

  <terms>
    <title>Playlist</title>
    <item>
      <title>Reuse .m3u/.pls files</title> <p>When converting online station playlists,
      streamtuner2 creates temporary files like <var>shoutcast.11539398391891.m3u</var> for

Modified help/dragndrop.page from [63af538af2] to [08c0d98091].

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

34
35
36

37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
	directly into VLC or any running music player.  That'll usually
	copy a stream/station address directly.</p>

	<p>Now it's not guaranteed to work with all applications or file
	managers, as X11/Gtk DND support is somewhat arcane and wonky.
	You may specifically have to adapt the default export format for
	this. Generally a XSPF or PLS file gets created for file managers.
	While VLC is one of the few applications that understand direct
	playlist URLs or literal M3U/PLS payloads even.</p>
	

        <section id="import">
	<title>Importing</title>

	<p>Playlist importing also works mostly. Here the action module
	takes care to unpack PLS, XPSF or M3U files and a few other
	formats. If you drag in streams/playlists from other applications,
	it'll usually be expanded.</p>
	

	<p>Take note that Streamtuner2 is not intended as playlist manager
	though. It will only accept radio streaming lists and discard
	local MP3/Ogg files.</p>


	<p>The import capabilities also allow to move a station entry
	from one of the channel tabs into your bookmarks list. Simply drag
	an entry over the "bookmarks" notebook tab then further along into
	the favourite list. - While this also works the other way round,
	it doesn't make sense to add bookmarks to Shoutcast/Xiph/etc.
	Because when their lists get refreshed (<key>F5</key>) all custom
	entries are usually discarded.</p>
	</section>
	
	<section id="configuration">
	<title>Export format configuration</title>

	<p>Use <key>F12</key> and change the DND export format. Again
	PLS is most universal, XSPF most complete, but other formats







|











>



>







|







15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
	directly into VLC or any running music player.  That'll usually
	copy a stream/station address directly.</p>

	<p>Now it's not guaranteed to work with all applications or file
	managers, as X11/Gtk DND support is somewhat arcane and wonky.
	You may specifically have to adapt the default export format for
	this. Generally a XSPF or PLS file gets created for file managers.
	While VLC is one of the few applications that understands direct
	playlist URLs or literal M3U/PLS payloads even.</p>
	

        <section id="import">
	<title>Importing</title>

	<p>Playlist importing also works mostly. Here the action module
	takes care to unpack PLS, XPSF or M3U files and a few other
	formats. If you drag in streams/playlists from other applications,
	it'll usually be expanded.</p>
	
	<note style="warning">
	<p>Take note that Streamtuner2 is not intended as playlist manager
	though. It will only accept radio streaming lists and discard
	local MP3/Ogg files.</p>
	</note>

	<p>The import capabilities also allow to move a station entry
	from one of the channel tabs into your bookmarks list. Simply drag
	an entry over the "bookmarks" notebook tab then further along into
	the favourite list. - While this also works the other way round,
	it doesn't make sense to add bookmarks to Shoutcast/Xiph/etc.
	Because when their lists get refreshed (<key>F5</key>) all custom
	entries are usually dropped.</p>
	</section>
	
	<section id="configuration">
	<title>Export format configuration</title>

	<p>Use <key>F12</key> and change the DND export format. Again
	PLS is most universal, XSPF most complete, but other formats

Deleted help/html/icast.html version [87ad638d9d].

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
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<title>iCast.io</title>
<link rel="stylesheet" type="text/css" href="C.css">
<script type="text/javascript" src="jquery.js"></script><script type="text/javascript" src="jquery.syntax.js"></script><script type="text/javascript" src="yelp.js"></script>
</head>
<body><div class="page" role="main">
<div class="header"><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#browsing" title="Browsing channels and radio stations">Browsing channels and radio stations</a>ย ยป <a class="trail" href="channels.html" title="Channels">Channels</a>ย โ€บ <a class="trail" href="channels.html#list" title="Available channels">Available channels</a>ย ยป </div>
<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#channels" title="Channel tabs">Channel tabs</a>ย ยป </div>
</div></div>
<div class="body">
<div class="hgroup">
<h1 class="title"><span class="title">iCast.io</span></h1>
<h2 class="subtitle"><span class="subtitle">removed</span></h2>
</div>
<div class="region">
<div class="contents">
<p class="p">iCast was a collaborative (CC-BY-SA licensed entries) radio
	station directory.</p>
<div class="note note-bug" title="Bug"><div class="inner"><div class="region"><div class="contents"><p class="p">As of May 2015 it seems to be down. Which is why the channel
	plugin got removed. It's still downloadable from contrib/ in the
	project repository or per Plugin Manager.</p></div></div></div></div>
</div>
<div class="sect sect-links" role="navigation">
<div class="hgroup"></div>
<div class="contents"><div class="links guidelinks"><div class="inner">
<div class="title"><h2><span class="title">More Information</span></h2></div>
<div class="region"><ul>
<li class="links "><a href="channels.html#list" title="Available channels">Available channels</a></li>
<li class="links "><a href="index.html#channels" title="Channel tabs">Channel tabs</a></li>
</ul></div>
</div></div></div>
</div>
</div>
<div class="clear"></div>
</div>
<div class="footer"></div>
</div></body>
</html>
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<