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

⌈⌋ ⎇ branch:  streamtuner2


Diff

Differences From Artifact [627ed3ce23]:

To Artifact [2e4f242f00]:


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
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106







+
-
-
+
+
+
-
-
-
-
+
-
-
-
-
-
-
-
+
+
+
+
+
-

-
+
-
-
+
+
+
+
+
+
+
+

+
+
+
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








    <title>Player application settings</title>

    <p>MIME types are abstract identifiers for media 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>

    <p><media type="image" src="img/configapps.png" mime="image/png" /></p>
<table shade="rows" rules="rows cols">
  <thead>  <tr><td><p>Format</p></td>     <td><p>Application</p></td></tr> </thead>

    <list>
      <item><p><link xref="config_apps">Application names</link> are most
    <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>
    <tr><td><p><var>video/*</var></p></td>        <td><p><cmd>totem</cmd></p></td></tr>
      always lowercase binary names.</p></item>
    <tr><td><p><var>video/youtube</var></p></td>  <td><p><cmd>vlc %srv</cmd></p></td></tr>
</table>

    <p>Application names are most always lowercase binary names. Double click an entry to edit it.
    After editing, the icon next to the application name will be updated. If it stays green, it's
    likely to work. If it turns red / into a stop symbol, then the entered name is likely incorrect.</p>

      
      <item><p> Double click an entry to edit it. After editing, the icon
      next to the application name will be updated.  If it stays green, it's
      likely to work.  If it turns red / into a stop symbol, then the
      entered name is likely incorrect. (Only works on U*ix-systems.)</p></item>
   <p><media type="image" src="img/configapps.png" mime="image/png" /></p>

    <p>After the application name, you can optionally use a placeholder like "<var>%pls</var>" (default),
      <item><p>After the application name, you can optionally use
    "<var>%m3u</var>" (old), or "<var>%xspf</var>" (modern), and "<var>%srv</var>" (for direct
    streaming URLs). See <link xref="config_apps#placeholders">placeholders</link>.</p>
      <link xref="config_apps#placeholders">a placeholder</link>:</p>
        <list>
        <item><p><var>%pls</var> → default format</p></item>
        <item><p><var>%m3u</var> → older scheme</p></item>
        <item><p><var>%xspf</var> → modern playlists,</p></item>
        <item><p><var>%srv</var> → for direct streaming URLs</p></item>
        </list>
      </item>

      <item><p>The format entries can specify generic or custom handlers:</p>
      <list>
        <item><p>Catch-all specifiers like <var>*/*</var> or a generic
    <p>Catch-all entries like <var>*/*</var> or a generic <var>audio/*</var> entry allow to
    configure a default player.  While <var>video/youtube</var> is specific to the Youtube
    channel.  And <var>url/http</var> a pseudo MIME type to configure a web browser (for
    station homepages).</p>
    
    <p>In practice you only need one entry for <var>audio/*</var> and one for
    <var>video/*</var>, both can use the same player even.  You can remove default entries by
    clearing both the Format field and its associated Application.  Add completely new
    associations through the emtpy line.  (Reopen the dialog to add another one.)</p>
        <var>audio/*</var> entry allow to configure a default
        player.</p></item>
        
        <item><p>While <var>video/youtube</var> is specific to the Youtube
        channel.</p></item>
        
        <item><p>And <var>url/http</var> a pseudo MIME type to configure a
        web browser (for station homepages).</p></item>
      </list>
      </item>

      <item><p>In practice you only needed one entry for <var>audio/*</var>
      and one for <var>video/*</var>, both can use the same player even. 
      </p></item>

      <item><p> You can remove existing entries by clearing both the Format
      field and its associated Application.  Add completely new associations
      through the emtpy line.  </p></item>
    </list>

</section>
<section id="recording">

    <title>Recording Apps</title>

    <p>The second block of entries in the 'Apps' section specifies recording applications.
228
229
230
231
232
233
234

235
236
237






238
239
240
241
242
243
244
243
244
245
246
247
248
249
250



251
252
253
254
255
256
257
258
259
260
261
262
263







+
-
-
-
+
+
+
+
+
+







 </terms>

</section>

<section id="plugins">
    <title>Channel and feature plugins and settings</title>

    <table><tr>
    <p>The tabs <key>📻 Channels</key> lists all available directory services.
    While the <key>🔌 Features</key> group provides internal or menu enhancements.
    Disabling or enabling a plugin however requires a restart of Streamtuner2
    <td><p>The <key>📻 Channels</key> tab shows all available directory
    services.</p></td>
    <td><p>While the <key>🔌 Features</key> group provides internal or menu
    enhancements.</p></td>
    </tr></table>
    <p>Disabling or enabling a plugin however requires a restart of Streamtuner2
    to take effect. (Unless the <link xref="pluginmanager2">Plugin Manager 2</link>
    is enabled, with its <key>📦 Add</key> tab visible.)</p>
    
    
    <p><media type="image" src="img/configplugins.png" mime="image/png" /></p>

    <p>Each plugin can have its own little list of extra options. They'll be