@@ -16,20 +16,27 @@

There are various options for streamtuner2, available under Edit ▸ Preferences or via F12.

-

It's separated into three main sections / tabs.

+

It's separated into different sections/tabs.

-
Player
+
🔊 Player

Lists audio formats and the audio player applications, or recording tools below. - It's a file type to application table. Double click an entry for editing.

-
Options
-

Influences the display of all stream/station lists, and contains some system settings.

-
Channel Plugins
+ It's a map of file-types to applications. Double click an entry to edit it.

+
☑ Options
+

Influences the display of all stream/station lists, and contains some + behaviour and system settings.

+
📻 Channel Plugins

Every channel tab can have specific options. These are configured here. Also you can disable channels you don't need.

+
🔌 Feature Plugins
+

Another class of plugins enables internal functions, or adds extra menu + entries, or configuration options.

+
📦 Add
+

The Plugin Manager 2 adds another + tab for updating or installing new plugins.

Player application settings

@@ -165,21 +172,24 @@ particular necessary when you use ⏭ or ⏪ directly in your player. For %pls references your player typically usues the online-only playlist files anyway. If you disable this option, then converted pls/m3u/xspf files get recreated repeatedly.

Forgo any playlist conversion
-

Per default all server playlists (be they .pls or .m3u, .xpsf) into whatever - format your player/recording apss are configured with (per default %pls). - Set this option to disable those placeholders from the Player tab, and avoid +

+

Per default most server playlists (be they .pls or .m3u, .xpsf) are converted. + All player/recording apps receive a default %pls file normally. + Set this option to disable any such placeholders from the Player tab, and avoid streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio player gets passed - the literal server/playlist streaming address in any case. Note that this is only - a minor speedup, but may trip up some applications. A few channel sources even - don't provide standard stream URLs and playlist (Jamendo albums for example really + the literal server/playlist streaming URL then.

+

Note that this is only + a minor speedup, but may trip up some applications. A few channel sources don't + even provide standard stream addresses and playlists. (Jamendo albums for example really need pre-conversion; no audio player can deal with such custom JSON playlists). - In short: you don't normally want to enabled this, unless you run into problems - with streamtuner2 taking too long, or accidentially hangs due to downloading streams - itself.

+ In short: you don't normally want to enable this flag - unless you run into problems + with streamtuner2 taking too long, or when it hang by accidentially downloading streams + itself.

+

System

@@ -214,14 +224,15 @@

Channel and feature plugins and settings

-

The tabs Channels lists all available directory services. - While the Features group provides internal or menu enhancements. +

The tabs 📻 Channels lists all available directory services. + While the 🔌 Features group provides internal or menu enhancements. Disabling or enabling a plugin however requires a restart of Streamtuner2 - to take effect.

+ to take effect. (Unless the Plugin Manager 2 + is enabled, with its 📦 Add tab visible.)

Each plugin can have its own little list of extra options. They'll be applied right away for already active channel/feature plugins.

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