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

⌈⌋ ⎇ branch:  streamtuner2


Check-in [0fb24c100c]

Overview
Comment:Document row placeholders, such as %title or $playing
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 0fb24c100ca160fc28cf6794c5b93f0e7ad2baf4
User & Date: mario on 2016-11-06 12:42:38
Other Links: manifest | tags
Context
2016-11-06
12:45
Make action.cmd() more explicit again. Introduce cmd= override flag for action.run_fmt_url(). So that specbuttons can use it instead of just interpol(). Thus the urn:/mime handlers will engage as well. check-in: 2b300a090d user: mario tags: trunk
12:42
Document row placeholders, such as %title or $playing check-in: 0fb24c100c user: mario tags: trunk
12:13
Implement a status message for URN: resolving, shorten code back (- row[] object gets implicitly updated.) check-in: 199ac60b55 user: mario tags: trunk
Changes

Modified help/config_apps.page from [bfb6a04a62] to [9a92e71277].

79
80
81
82
83
84
85





























86
87
88
89
90
91
92
	<p>Use the newer <var>%xspf</var> format if your player supports
	it. This format retains the maximum of station infos (such as
	homepages etc.), and thus often makes for better bookmarking directly
	in your player.</p> </note>


	</section>





























	
<section>
<title>Other players</title>
<p>Here a few other configuration examples for other
players/backends.</p>
<terms>
  <item>







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







79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
	<p>Use the newer <var>%xspf</var> format if your player supports
	it. This format retains the maximum of station infos (such as
	homepages etc.), and thus often makes for better bookmarking directly
	in your player.</p> </note>


	</section>

	<section id="row_placeholders">
	<title>Other placeholders</title>

	<p>In addition to stream URL + type placeholders (<var>%r</var>, <var>%x</var>, 
	<var>%pls</var>, <var>%m3u</var>, etc),	you can also pass row
	placeholders. These contain the stream information like title or
	bitrate, or any other internal field:</p>

	<table shade="rows" rules="rows cols">
	<thead>	<tr><td><p>Placeholder</p></td><td><p>As variable</p></td><td><p>Field content</p></td></tr> </thead>
		<tr><td><p>%title</p></td><td><p>$title</p></td><td><p>Station title</p></td></tr>
		<tr><td><p>%genre</p></td><td><p>$genre</p></td><td><p>Stream category or genre list</p></td></tr>
		<tr><td><p>%playing</p></td><td><p>$playing</p></td><td><p>Currently playing song, or geographic location</p></td></tr>
		<tr><td><p>-</p></td><td><p>$url</p></td><td><p>Unfiltered stream url (may contain internal urn:xx:id)</p></td></tr>
		<tr><td><p>%format</p></td><td><p>$format</p></td><td><p>The MIME type ("audio/mpeg")</p></td></tr>
		<tr><td><p>%bitrate</p></td><td><p>$bitrate</p></td><td><p>Known stream bitrate, if any</p></td></tr>
		<tr><td><p>%extra</p></td><td><p>$extra</p></td><td><p>Comments or timer settings</p></td></tr>
		<tr><td><p>%favourite</p></td><td><p>$favourite</p></td><td><p>If bookmarked</p></td></tr>
	</table>

	<p>Not all fields are used in all channels. Sometimes they're repurposed (like <var>playing</var>
	often doubles as Location: field). And some channels may even use custom internal names.</p>

	<note style="info"><p>You often want to use such placeholders if you have a player or recording shell script, such as
	<link href="http://fossil.include-once.org/streamtuner2/artifact/51b695f41d9f9ad2"><file>contrib/cmdline/streamripper_addgenre</file></link>
	to handle them. Or if you define a <link xref="specbuttons">mini-toolbar specbutton</link>
	with custom commands.</p></note>
	</section>
	
<section>
<title>Other players</title>
<p>Here a few other configuration examples for other
players/backends.</p>
<terms>
  <item>

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

59
60
61
62
63
64
65

66
67
68
69
70
71
72
73
74
75
        <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 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>







>
|
|
<







59
60
61
62
63
64
65
66
67
68

69
70
71
72
73
74
75
        <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><link xref="config_apps#placeholders">Placeholders</link>
	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 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>