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

⌈⌋ ⎇ branch:  streamtuner2


Check-in [ed73b89bba]

Overview
Comment:Update specbuttons help pages.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: ed73b89bba4c501e845e66d891f3e771ceaa70c0
User & Date: mario on 2016-10-31 14:32:22
Other Links: manifest | tags
Context
2016-10-31
14:33
Prepare simpler new_station dialog. check-in: 889ab628ed user: mario tags: trunk
14:32
Update specbuttons help pages. check-in: ed73b89bba user: mario tags: trunk
14:31
radio-browser.info: support for submitting stations check-in: 01c7c85d47 user: mario tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Added help/html/img/specbuttons.png version [65b7f79a0f].

cannot compute difference between binary files

Modified help/html/specbuttons.html from [61972457b9] to [22ea8adb94].

︙
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
63
64
65
66
67
68
69
70




71
72
73
74
75
76
77
78


79
80
81
82
83
84
85

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
63
64
65
66
67
68
69
70
71

72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92








-
-
+
+
+









+
+
+
+



-
-
-
-

-
+















-
+

-
+
+








-
+
+
+
+








+
+








</div></div>
<div class="body">
<div class="hgroup"><h1 class="title"><span class="title">Special extra/mini buttons</span></h1></div>
<div class="region">
<div class="contents">
<p class="p">Using the specbuttons plugin, you can define additional
	shortcuts. This is meant as convenience - allows to start
	other audio apps or system ontrols from within streamtuner2.</p>
<p class="p">The settings list can be found with th plugin options in the
	other audio apps or system controls from within streamtuner2.</p>
<p class="p"><span class="media"><span class="media media-image"><img src="img/specbuttons.png" class="media media-inline" alt=""></span></span></p>
<p class="p">The settings list can be found with the plugin options in the
	<span class="key"><kbd>🔌 Features</kbd></span> tab.  It follows the layout of the player/recording
	configuration.  Except that it lists icons and their according
	action commands:</p>
<div class="table"><div class="inner"><div class="region"><table class="table">
<tr>
<td><p class="p"><span class="em">Icon</span></p></td>
<td style="border-left-style: solid;"><p class="p"><span class="em">Cmd</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">volume-up</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">amixer sset Master 2%+</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">gtk-media-forward</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">vlc next</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">terminal</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">xterm</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">volume</span></p></td>
<td style="border-top-style: solid;"><p class="p"><span class="app">mixer</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">pavucontrol</span></p></td>
</tr>
<tr>
<td style="border-top-style: solid;"><p class="p"><span class="app">database</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">./myscript "%url" "%title"</span></p></td>
</tr>
<tr class="shade">
<td style="border-top-style: solid;"><p class="p"><span class="app">./import.png</span></p></td>
<td style="border-top-style: solid;border-left-style: solid;"><p class="p"><span class="cmd">audacity %pls</span></p></td>
</tr>
</table></div></div></div>
</div>
<div id="gtk-icons" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">gtk-icons</span></h2></div>
<div class="region"><div class="contents"><p class="p">Note that the icon name can also be that of a Gtk-builtin icon. Their
        names always start with "<span class="app">gtk-</span>", for example "<span class="app">gtk-cancel</span>". You can
        names always start with "<span class="app">gtk-</span>" - for example "<span class="app">gtk-cancel</span>". You can
        find a list of all available builtins under
        <span class="link"><a href="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html" title="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html">http://www.pygtk.org/pygtk2reference/gtk-stock-items.html</a></span>.</p></div></div>
        <span class="link"><a href="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html" title="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html">http://www.pygtk.org/pygtk2reference/gtk-stock-items.html</a></span>.
        They usually match your Gtk theme though.</p></div></div>
</div></div>
<div id="png-icons" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">PNG icons</span></h2></div>
<div class="region"><div class="contents">
<p class="p">In case you enter something like "<span class="app">player</span>", the icon name will be
	searched for and expanded to an absolute PNG filename. For example
        "<span class="file">totem</span>" might become <span class="file">/usr/share/icons/HighContrast/16x16/apps/totem.png</span>.</p>
<p class="p">This won't always yield the exact icon / theme / or size you wanted. So it's
	sometimes necessary to look up the complete path yourself.</p>
	sometimes necessary to look up the complete path yourself.
	So you might want search them manually <span class="cmd">locate /usr/shar/icons |
	grep "volume"</span> to pick out a more fitting icon.</p>
<p class="p">You can also use png files located in your homedir or else.</p>
</div></div>
</div></div>
<div id="placeholders" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">Commands</span></h2></div>
<div class="region"><div class="contents">
<p class="p">You can define any graphical or commandline application to be
        invoked by your custom toolbar button. Foremost you want to invoke
        audio controls of course, or start/stop players.</p>
<p class="p">For example <span class="cmd">amixer sset Master 1dB+</span> is likely to work
        for all current distributions.</p>
<p class="p">Placeholders like %title and %url or %pls and %m3u are supported
	for all commands as well. So you can have additional play/record
	shortcuts.</p>
</div></div>
</div></div>
<div id="" class="sect"><div class="inner">
<div class="hgroup"><h2 class="title"><span class="title">icon rows</span></h2></div>
︙

Added help/img/specbuttons.png version [65b7f79a0f].

cannot compute difference between binary files

Modified help/pluginmanager2.page from [e5c9c3a6b0] to [8d7462c5db].

︙
65
66
67
68
69
70
71
72

73
74
75
76
77
78
79
80
81

65
66
67
68
69
70
71

72
73
74
75
76
77
78
79
80
81








-
+










	take precedence after a restart. However the version number in
	PluginManager2 still shows the system-installed/older version
	regardless.</p>
	<p>So you'll have to take care to eventually refresh/delete outdated user plugins,
	whenever you install a newer Streamtuner2 version.</p></note>
	</section>
	
	<section>
	<section id="disable">
	<subtitle>Disable user plugin loading</subtitle>
	<p>Since this is still rather experimental, you may disable all
	associated features by starting ST2 via:</p>
	<screen>streamtuner2 -d <input>pluginmanager2</input></screen>
	<p>Which inhibits loading this whole extension. (The <code>-d</code>
	flag also works	for any other plugin name.)</p>
	</section>

</page>

Modified help/specbuttons.page from [76c3d65779] to [974bbd7502].

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

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








-
-
-
+
+
+
+
+





-
-
+
+
+
-
-
+







-
+

-
+
+









-
+
+
+
+
+







+
+
+






-
+













	<desc>Toolbar application short cuts.</desc>
</info>

	<title>Special extra/mini buttons</title>

	<p>Using the specbuttons plugin, you can define additional
	shortcuts. This is meant as convenience - allows to start
	other audio apps or system ontrols from within streamtuner2.</p>
	
	<p>The settings list can be found with th plugin options in the
	other audio apps or system controls from within streamtuner2.</p>

	<p><media type="image" src="img/specbuttons.png"></media></p>
	
	<p>The settings list can be found with the plugin options in the
	<key>🔌 Features</key> tab.  It follows the layout of the player/recording
	configuration.  Except that it lists icons and their according
	action commands:</p>

	<table shade="rows" rules="rows cols">
		<tr><td><p><em>Icon</em></p></td>  	<td><p><em>Cmd</em></p></td> </tr>
		<tr><td><p><app>gtk-media-forward</app></p></td>     <td><p><cmd>vlc next</cmd></p></td> </tr>
		<tr><td><p><em>Icon</em></p></td>  	        <td><p><em>Cmd</em></p></td> </tr>
		<tr><td><p><app>volume-up</app></p></td>        <td><p><cmd>amixer sset Master 2%+</cmd></p></td> </tr>
		<tr><td><p><app>gtk-media-forward</app></p></td><td><p><cmd>vlc next</cmd></p></td> </tr>
		<tr><td><p><app>terminal</app></p></td>  	<td><p><cmd>xterm</cmd></p></td> </tr>
		<tr><td><p><app>volume</app></p></td>		<td><p><cmd>pavucontrol</cmd></p></td> </tr>
		<tr><td><p><app>mixer</app></p></td>		<td><p><cmd>pavucontrol</cmd></p></td> </tr>
		<tr><td><p><app>database</app></p></td>		<td><p><cmd>./myscript "%url" "%title"</cmd></p></td> </tr>
		<tr><td><p><app>./import.png</app></p></td>	<td><p><cmd>audacity %pls</cmd></p></td> </tr>
	</table>

        <section id="gtk-icons">
        <title>gtk-icons</title>
	<p>Note that the icon name can also be that of a Gtk-builtin icon. Their
        names always start with "<app>gtk-</app>", for example "<app>gtk-cancel</app>". You can
        names always start with "<app>gtk-</app>" - for example "<app>gtk-cancel</app>". You can
        find a list of all available builtins under
        <link href="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html">http://www.pygtk.org/pygtk2reference/gtk-stock-items.html</link>.</p>
        <link href="http://www.pygtk.org/pygtk2reference/gtk-stock-items.html">http://www.pygtk.org/pygtk2reference/gtk-stock-items.html</link>.
        They usually match your Gtk theme though.</p>
	</section>
	
        <section id="png-icons">
        <title>PNG icons</title>
	<p>In case you enter something like "<app>player</app>", the icon name will be
	searched for and expanded to an absolute PNG filename. For example
        "<file>totem</file>" might become <file>/usr/share/icons/HighContrast/16x16/apps/totem.png</file>.</p>
        
        <p>This won't always yield the exact icon / theme / or size you wanted. So it's
	sometimes necessary to look up the complete path yourself.</p>
	sometimes necessary to look up the complete path yourself.
	So you might want search them manually <cmd>locate /usr/shar/icons |
	grep "volume"</cmd> to pick out a more fitting icon.</p>
	
	<p>You can also use png files located in your homedir or else.</p>
	</section>

        <section id="placeholders">
        <title>Commands</title>
        <p>You can define any graphical or commandline application to be
        invoked by your custom toolbar button. Foremost you want to invoke
        audio controls of course, or start/stop players.</p>
        
        <p>For example <cmd>amixer sset Master 1dB+</cmd> is likely to work
        for all current distributions.</p>
        
	<p>Placeholders like %title and %url or %pls and %m3u are supported
	for all commands as well. So you can have additional play/record
	shortcuts.</p>
	</section>

        <section>
        <section id="icon-rows">
        <title>icon rows</title>
	<p>With the "number of rows" setting, more buttons can be packed together.
	It looks okay with up to 3 rows - when using the large sized main toolbar.
	The defined icon shortcuts will always be packed column-wise.</p>

        <note style="bug"><p>The icon list isn't ordered. So you cannot
        define which button appears first. (Albeit the plugin config
        definition can be changed from 'dict' to 'table' now, and the plugin
        required just a little editing then.)</p></note>
        </section>

</page>

Modified help/technical.page from [588d62f8fc] to [7030648974]. 

1
2
3
4


5
6
7
8
9
10
11
12
13
14
15
16
17
18

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

	<title>Technical information</title>

<info>
	<link type="guide" xref="index#footer"/>
        <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>
︙

Modified help/timer.page from [ded05a2860] to [a6a3597ae0]. 

1
2
3
4
5

6
7
8
9
10
11
12

13
14
15
16
17
18
19
20
21

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

	<title>Timer</title>
<title>Timer</title>

<info>
	<link type="guide" xref="bookmarks#other"/>
	<link type="guide" xref="index#extra"/>
        <desc>Programming recurring play and recording events.</desc>
</info>

<section id="intro">

<section>
	<p>You can programm play/recording events with the timer plugin. Simply select a station
	and choose <guiseq><gui>Station</gui> <gui>Extensions</gui> <gui>Add timer...</gui></guiseq>.
	A small popup will ask for a data/time string. If you press <key>OK</key> the station
	and the programmed time will be stored in the bookmarks channel in the "timer" category.</p>
	
	<p><media type="image" src="img/timer.png" mime="image/png">Timer</media></p>
︙