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

⌈⌋ branch:  streamtuner2


Diff

Differences From Artifact [8b69bffa16]:

To Artifact [8010e28e83]:


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" group="first"
    id="configuration">

<info>
    <link type="guide" xref="index#configuration"/>
    <desc><key>F12</key> brings up the options window with the Player, Display, System and Plugin sections.</desc>
</info>

<title>Settings dialog</title>

<p>There are various options for streamtuner2.
You can find the settings dialog in the edit menu as "Preferences" (last entry).
<p>There are various options for streamtuner2, available under <guiseq><gui>Edit</gui>
<gui>Preferences</gui></guiseq> or via <key>F12</key>.
</p>

<terms>
  <title>It's separated into three main areas.</title>
  <item>
    <title>Player</title>
    <p>Lists audio formats and the audio player applications, or recording tools below.
48
49
50
51
52
53
54
55

56
57

58
59
60
61
62
63
64
48
49
50
51
52
53
54

55


56
57
58
59
60
61
62
63







-
+
-
-
+






    <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>
    <tr><td><p><var>video/youtube</var></p></td>  <td><p><cmd>vlc %srv</cmd></p></td></tr>
</table>

    <p>Application names are always lowercase binary names. Double click an entry to edit it.</p>

    <p>After the application name, you can use a placeholder like "<var>%pls</var>" (which is the default,
    <p>After the application name, you can use a placeholder like "<var>%pls</var>" (default),
    and returns a direct URL often) or "<var>%m3u</var>" (where streamtuner creates local MP3 playlist file first)
    and "<var>%src</var>" (a direct streaming server link, e.g. for VLC).</p>
    or "<var>%m3u</var>" and "<var>%src</var>". See <link xref="config_apps#placeholders">placeholders</link>.</p>

    <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 psdeudo MIME type
    to configure a web browser (for station homepages).</p>

</section>
<section id="recording">
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
107
108
109
110
111
112


113
114
115


116
117
118
119
120
121
122
123
124
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
107
108
109
110
111
112
113
114
115



116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152






153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174



175
176
177
178
179

180
181
182


183
184
185
186
187
188
189
190
191
192
193







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

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

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

-
-
-





-
+
+

-
-
+
+








    <p>To define a target directory, you can 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>

    <p>Most options here a self-explanatory. The options for the favicons define if station entries should
    show little icons. Not all stations have one, so you might as well turn this off to conserve a little
    memory.</p>

  <title>Display/GUI options</title>
  <terms>
    <title>Display settings</title>
    <item>
      <title>Display favicons</title>
      <p>The options for the favicons define if station entries should show little icons.
      Not all stations have one, so you might as well turn this off to conserve a little memory.</p>
    </item>
    <item>
      <title>Load favicons</title>
    <p>The number of stations setting 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.
      <p>When starting to play a station, its homepage favicon is automatically retrieved in the
      background. It's not going to be displayed right away, but after you reload the category/station list.
      Alternatively use <guiseq><gui>Channel</gui> <gui>Update favicons...</gui></guiseq> to update all
      station icons at once.</p>
    For the major plugins this however limits how much scroll text appears in the stream lists.</p>
    </item>
    <item>
      <title>Show bookmark star</title>
      <p>Bookmarked stations will be marked with a ★ star in all other station lists / categories.
      That doesn't often work for the same station entry from two different channel services / tabs though.</p>
    </item>
    <item>
      <title>Gtk+ theme</title>
      <p>Be careful. While Gtk allows to select a different theme per application, not all themes
      work right away. Switching the theme might hang streamtuner2. Just restart if that happens.</p>
    </item>
    <item>
      <title>Save window states</title>
      <p>Automatically remember window size, selected channel tab, categories, or selected station.
      Also keeps the width of station list columns. If disabled, you can manually save the current
      layout/selections via <guiseq><gui>Edit</gui> <gui>Save States</gui></guiseq>.</p>
    </item>
 </terms>

    <p>"Retain deleted stations" keeps old entries, when you reload a category/genre. Shoutcast often
    forgets stations or throws them out. If you keep this option enabled, these entries are kept in
    streamtuner2. Browse down in the stations list to still see them.</p>
  <terms>
    <title>Station loading</title>
    <item>
      <title>Prefer HTML traversing (PyQuery) over regex</title>
      <p>Some channels provide proper APIs to fetch station lists. Others are just websites, that
      require scraping listings out. Most channel tabs provide two alternative methods for that.
      The DOM/HTML selection method is sometimes more reliable. As fallback streamtuner2 plugins
      often use a regex to match text. Occassionally the regex method is actually more reliable,
      because directory services often use frightful unstructured HTML. If available, both methods
      are tried. You can influence the order with this setting.</p>
    </item>
    <item>
      <title>[<input>250</input>] Limit stream number</title>
      <p> Constraints the length of station lists per category.
      The number of stations setting 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 much scroll text appears in the stream lists.</p>
    </item>
    <item>
      <title>Retain deleted stations</title> <p>When enabled, keeps old station entries when
      updating/reloading a category/genre.  Services often forget stations or throws them out when inavailable.
      With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often
      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>google station homepages</title>
      <p>When playing a station that doesn't have a homepage entry, streamtuner2 tries to google
      the station title. The found URL is then used/kept as station homepage. (Btw, station titles
      like www.mymusicstation.com are automatically mapped to homepage URLs already.)</p>
    </item>
 </terms>

    <p>It's possible to select a Gtk+ theme. But not all themes work with all Gtk display engines, and
    not all themes work with streamtuner2. You'll have to try.</p>

    <p>Remembering window states allows streamtuner2 to reconstruct which channel and category was last
    selected. You can however disable this option, and instead manually save the window states/layout
    in the edit menu, if you want.</p>
  <terms>
    <title>System</title>
    <item>
      <title>Temporary files</title>
      <p>Streamtuner2 creates temporary .m3u files, if an audio player is configured to use %m3u files
      instead of %pls or %srv URLs. For archival purposes, you might want to set a dedicated directory
      for this. Leave this to the default /tmp else.</p>
    </item>
    <item>
      <title>Config directory</title>
      <p>Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc.
      You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME
      environment variable to adapt.</p>
    </item>
    <item>
      <title>Enable debug messages</title>
      <p>If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
      and processing or debug infos. Enable this only for testing, as it might slow down station
      rendering.</p>
    </item>
 </terms>

    <p>Setting another temporary directory might be useful, if you want to keep the temporary .m3u cache
    files. They are created whenever you hit play. For archival or speed-up porposes you might want to keep
    them elsewhere. They don't take a lot of space.</p>
</section>

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

    <p>Each channel plugin can bring its own list of configuration settings. These are collected here.</p>
    <p>This tab lists all available channel and feature plugins. Mark checkboxes for those plugins
    you want to enable. You have to restart Streamtuner2 for any changes here to take effect.</p>

    <p>The heading for each plugin allows to enable or disable it. To apply changed states you need to restart
    streamtuner2 however.</p>
    <p>Each channel plugin may come with its own set of addition configuration settings
    below.</p>

    <p>If you want to find out more about the short option descriptions (most settings are checkboxes),
    please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding
    *.py files. These are readable, and sometimes contain more information.</p>
</section>



</page>