Overview
Context
Changes
Modified help/action_playing.page
from [7e0e7e5d73]
to [d7dfd37d58].
| ︙ | | |
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
-
+
|
<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 these circumstance it might be sensible to write
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>
<p>It's also possible to save a station entry as .m3u or .pls file, and load this manually
in your player. You might even want to collect such .m3u files for archival / backup
purposes.</p>
</page>
|
Modified help/action_recording.page
from [45d9ea2b2c]
to [c158ed0318].
| ︙ | | |
20
21
22
23
24
25
26
27
28
29
|
20
21
22
23
24
25
26
27
28
29
30
31
32
|
+
+
+
|
radio station title as name. Within that directory the individual music titles are split
into separate .mp3 files.</p>
<p>You can influence all these behaviours with -arguments to the streamripper program.
Please refer to the manpage of streamripper. The options are too broad to list here.
You can set default arguments (e.g. another default save directory) in the Config > Apps
dialog.</p>
<p>As alternative check out <link href="http://freshcode.club/projects/ficy">fIcy/fPls</a>
for recording ICEcast/SHOUTcast streaming servers.</p>
</page>
|
Modified help/action_saving.page
from [3c0377374f]
to [2ed27dbb6c].
| ︙ | | |
13
14
15
16
17
18
19
20
21
22
23
24
|
13
14
15
16
17
18
19
20
21
22
23
24
|
-
+
|
<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 must edit the
Note that the lower right dropdown has no effect. You have to edit the
filename field.</p>
</page>
|
Modified help/channel_bookmarks.page
from [7b477a62be]
to [78eee67b88].
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
-
+
-
-
+
|
<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 overview when you browse across channel tabs,
<p>It's easy to lose oversight when switching across channel tabs,
genres and internet radio stations. Therefore streamtuner2 allows
to bookmark stations. This way you can collect favoured streams in
a single place.</p>
|
| ︙ | | |
Added help/channel_icast.page version [553e37377e].
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<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</desc>
</info>
<title>iCast.io</title>
<p>iCast is another huge collaborative radio station directory.</p>
<p>Its support in Streamtuner2 is quite robust, as it provides a JSON API.
It lacks in meta data information though (homepages, currently playing, listeners, etc.)</p>
</page>
|
| | | | | | | | | | | | | | | | |
Modified help/channel_internetradioorguk.page
from [91bc69e94a]
to [a66a87b567].
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
-
-
-
+
+
+
-
+
|
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="internet_radio_org_uk">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<link type="guide" xref="configuration#plugins"/>
<desc>Large radio directory from the UK.</desc>
</info>
<title>Internet-Radio.com</title>
<p>Internet-Radio.com is a broad alternative to Shoutcast. It also
lacks station homepages in most cases, but is a likewise
encyclopedical. Genres are similiar to Shoutcast.</p>
<p>Internet-Radio.com is a broad alternative to Shoutcast. It
has regained station homepages for most entries again.
Genres are similiar to Shoutcast.</p>
<note><p>Note that this plugin has its own setting for how many
<note><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></note>
</page>
|
Added help/channel_itunes.page version [cd1ba54f9c].
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="itunes">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<desc>iTunes (RoliSoft Playlists)</desc>
</info>
<title>iTunes Radios via RS</title>
<p>iTunes radio is indirectly supported through the RoliSoft Radio Playlist
APIs.</p>
</page>
|
| | | | | | | | | | | | | | |
Added help/channel_live365.page version [73500ebc2f].
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="live365">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<desc>Live365 radio network</desc>
</info>
<title>Live365</title>
<p>Live365 is a radio broadcasting service and directory. It categorizes stations in
over 250 genres. Not all radio stations are free to listen however. It's a commercial
provider. Therefore streamtuner2 tries to filter result lists.</p>
<p>This channel plugin is known to break once in a while. And it can't be guaranteed
to pass working streaming URLs to audio players.</p>
<p>If it breaks once more, it's going to get removed. (Unless someone else sends in
a patch, of course!)</p>
</page>
|
| | | | | | | | | | | | | | | | | | | | | |
Added help/channel_modarchive.page version [3541eb6a94].
|
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="modarchive">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<desc>MOD files.</desc>
</info>
<title>The MOD Archive</title>
<p>MODArchive is a collection of module/tracker files. It's a community project, and
categorizes individual audio files. You'll need a MOD-capable audio player.</p>
<list>
<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>
|
| | | | | | | | | | | | | | | | | | | | | | |
Modified help/channel_myoggradio.page
from [9efab033a3]
to [68aa9d8f28].
| ︙ | | |
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
|
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
|
-
+
-
-
-
+
+
+
+
+
|
<desc>Open source stream directory.</desc>
</info>
<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 is very well supported.</p>
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, unless you specify an user account in the settings
and actually bookmarks stations on the MyOggRadio web site. Shared entries are not
automatically in the MOR favorite list.</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 <a href="http://freshcode.club/projects/jmorp">JMyOggRadioPlayer</a>
as specific frontend and player for MyOggRadio.</p>
<terms>
<title>Channel options.</title>
<item>
<title><code>Login settings</code></title>
<p>If you want to upload station infos to MyOggRadio, you need an account there. Registration
is free and doesn't require personal information nor email address. Specify username and
|
| ︙ | | |
Added help/channel_tunein.page version [242af3be3e].
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|
<page xmlns="http://projectmallard.org/1.0/"
type="guide"
id="tunein">
<info>
<link type="guide" xref="index#channels"/>
<link type="guide" xref="channels#list"/>
<desc>Radio and Podcast directory.</desc>
</info>
<title>TuneIn</title>
<p>TuneIn hosts a major radio, show and podcast directory. It also provides the
RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML
lists only for radio stations currently.</p>
</page>
|
| | | | | | | | | | | | | | | |
Modified help/cli.page
from [c1ef947327]
to [ca261558e1].
| ︙ | | |
43
44
45
46
47
48
49
50
51
|
43
44
45
46
47
48
49
50
51
52
53
54
|
+
+
+
|
<title><code>streamtuner2 categories channel</code></title>
<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>
|
Modified help/config_apps.page
from [d2fdafb87a]
to [e50bfca5a3].
| ︙ | | |
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
|
<p>On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
configure most of them as target application. Mostly it makes sense to use a single
application for all audio formats. But at least the */* media type should be handled
by a generic player, like vlc.</p>
<table shade="rows" rules="rows cols">
<tr><td>Audacious</td><td>audacious %m3u</td><td>audio</td></tr>
<tr><td>XMMS2</td><td>xmms2 %m3u</td><td>audio</td></tr>
<tr><td>Amarok</td><td>amarok -l %pls</td><td>audio</td></tr>
<tr><td>Exaile</td><td>exaile %m3u</td><td>audio</td></tr>
<tr><td>Amarok</td><td>amarok -l %pls</td><td>audio</td></tr>
<tr><td>mplayer</td><td>mplayer %srv</td><td>console</td></tr>
<tr><td>VLC</td><td>vlc %u</td><td>video/*</td></tr>
<tr><td>Totem</td><td>totem %u</td><td>video/*</td></tr>
<tr><td>Media Player</td><td>mplayer2.exe %pls</td><td>Win32</td></tr>
<tr><td><app>Audacious</app></td> <td><cmd>audacious %m3u</cmd></td> <td>audio</td></tr>
<tr><td><app>XMMS2</td> <td><cmd>xmms2 %m3u</cmd></td> <td>audio</td></tr>
<tr><td><app>Amarok</app></td> <td><cmd>amarok -l %pls</cmd></td> <td>audio</td></tr>
<tr><td><app>Exaile</app></td> <td><cmd>exaile %m3u</cmd></td> <td>audio</td></tr>
<tr><td><app>Amarok</app></td> <td><cmd>amarok -l %pls</cmd></td> <td>audio</td></tr>
<tr><td><app>mplayer</app></td> <td><cmd>mplayer %srv</cmd></td> <td>console</td></tr>
<tr><td><app>VLC</app></td> <td><cmd>vlc %u</cmd></td> <td>video/*</td></tr>
<tr><td><app>Totem</app></td> <td><cmd>totem %u</cmd></td> <td>video/*</td></tr>
<tr><td><app>Media Player</app></td> <td><cmd>mplayer2.exe %pls</cmd></td> <td>Win32</td></tr>
</table>
<p>Some audio players open a second instance when you actually want to switch radios.
In this case it's a common workaround to write <code>pkill vlc ; vlc %u</code> instead,
which ends the previous player process and starts it anew.
For VLC there's however also the <code>--one-instance</code> option, which sometimes
works better. (And sometimes not.)</p>
|
| ︙ | | |
Modified help/extending.page
from [f8a1d832ce]
to [c8f3444160].
| ︙ | | |
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
-
+
|
<title>Extension Howto</title>
<p>Streamtuner2 is written in Python, a rather easy programming language. And it's also rather simple
to write a new channel plugin.</p>
<p>The basic layout of every channel plugin is as follows:</p>
<p><code type="text/python">
<code type="text/python">
from channels import *
class myplugin (ChannelPlugin):
title = "MyNewChannel"
module = "myplugin"
|
| ︙ | | |
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
-
+
|
# ...
# get it from somewhere
# ...
return entries
</code></p>
</code>
<p>There are some self-explanatory description fields, and two important methods. Sometimes you
don't need categories even. The update_streams() function often downloads a website, parses it
with regular expressions or PyQuery / DOM methods, and packs into into a result list.</p>
<p>Here entries is a list of dictionaries, with standardized entry names like "title" and "playing"
for the description, and "homepage" for a browsable link, and most importantly "url" for the
actual streaming link. Often you want to add a "genre" and "format" and "bitrate" info. But this depends
on your plugins data source, really.</p>
</page>
|
Modified help/global_key.page
from [ac7daddbb5]
to [4d55acbd37].
| ︙ | | |
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
-
-
-
-
-
-
-
+
+
+
+
+
+
+
|
<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">
<tr><td>keyspec:</td><td>corresponds to:</td></tr>
<tr><td>F9</td><td>Responds to only <key>F9</key>. (too generic)</td></tr>
<tr><td><Meta>R</td><td>often the 'Windows'-key and R</td></tr>
<tr><td><Ctrl>N</td><td>Control and <key>N</key></td></tr>
<tr><td><Shift>F1</td><td>Shift and F1</td></tr>
<tr><td><Alt>SPACE</td><td>Use Alt and <key>Space</key>. (too generic)</td></tr>
<tr><td>XF86Forward</td><td>Uses a "forward" function key. (default)</td></tr>
<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><Meta>R</input></p></td> <td><p>often the 'Windows'-key and R</p></td></tr>
<tr><td><p><input><Ctrl>N</input></p></td> <td><p>Control and <key>N</key></p></td></tr>
<tr><td><p><input><Shift>F1</input></p></td> <td><p>Shift and F1</p></td></tr>
<tr><td><p><input><Alt>SPACE</input></p></td> <td><p>Use Alt and <key>Space</key>. (too generic)</p></td></tr>
<tr><td><p><input>XF86Forward</input></p></td> <td><p>Uses a "forward" function key. (default)</p></td></tr>
</table>
<p>To define another channel as source, enter its module name in the according field. Also
add a category separated by : colon here.</p>
<note><p>If the configured keyboard shortcut conflicts with another application,
it won't work. And if you choose it too generic, you won't be able to type longer
documents. Also found out: key names are case sensitive.</p></note>
</page>
|
Modified help/technical.page
from [6bda9a713e]
to [a2181693a9].
| ︙ | | |
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
|
</section>
<section id="config_files">
<title>Configuration files</title>
<terms>
<item>
<title>/home/$USER/.config/streamtuner2/</title>
<title><file>/home/$USER/.config/streamtuner2/</file></title>
<p>Corresponds to the XDG_CONFIG_HOME setting. All ST2 configuration settings
are contained within here and are in JSON format.</p>
</item>
<item>
<title>~/.config/streamtuner2/settings.json</title>
<title><file>~/.config/streamtuner2/settings.json</file></title>
<p>General runtime options, plugin settings, and configured audio players.</p>
</item>
<item>
<title>~/.config/streamtuner2/window.json</title>
<title><file>~/.config/streamtuner2/window.json</file></title>
<p>Saved window sizes, list widths.</p>
</item>
<item>
<title>~/.config/streamtuner2/state.json</title>
<title><file>~/.config/streamtuner2/state.json</file></title>
<p>Last category in each channel tab.</p>
</item>
<item>
<title>~/.config/streamtuner2/bookmarks.json</title>
<title><file>~/.config/streamtuner2/bookmarks.json</file></title>
<p>Is a separate cache file for your bookmarked/favourite radio stations.</p>
</item>
<item>
<title>~/.config/streamtuner2/cache/***.json</title>
<title><file>~/.config/streamtuner2/cache/***.json</file></title>
<p>JSON files for stream lists in each channel.</p>
</item>
<item>
<title>~/.config/streamtuner2/icons/*.png</title>
<title><file>~/.config/streamtuner2/icons/*.png</file></title>
<p>Holds downloaded favicons for station homepages.</p>
</item>
</terms>
</section>
<section id="install_dirs">
<title>Installation spread</title>
<terms>
<item>
<title>/usr/bin/streamtuner2</title>
<title><file>/usr/bin/streamtuner2</file></title>
<p>Is the main binary.</p>
</item>
<item>
<title>/usr/share/streamtuner2/</title>
<title><file>/usr/share/streamtuner2/</file></title>
<p>Contains the individual ST2 python modules, and plugins in channels/. Also packages in pyquery/, but which is only used if the according modules aren't installed by the distribution.</p>
</item>
<item>
<title>/usr/share/doc/streamtuner2/</title>
<title><file>/usr/share/doc/streamtuner2/</file></title>
<p>Contains the README, and Mallard/gnome-help/yelp files under help/.</p>
</item>
</terms>
</section>
<section id="license">
|
| ︙ | | |