Index: help/configuration.page ================================================================== --- help/configuration.page +++ help/configuration.page @@ -15,25 +15,36 @@ 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.

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

 - Options -

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

- - - Channel Plugins + 📻 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.

+
@@ -171,21 +182,21 @@ 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 @@ -226,14 +237,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 Index: help/html/configuration.html ================================================================== --- help/html/configuration.html +++ help/html/configuration.html @@ -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 Index: help/html/pluginmanager2.html ================================================================== --- help/html/pluginmanager2.html +++ help/html/pluginmanager2.html @@ -17,11 +17,11 @@

Plugin Manager 2

As of release 2.1.8 there is a plugin manager. It's available as feature extension. Once acticated (after a restart) it brings up a - new 📦 Add tab in the configuration window.

+ new 📦 Add tab in the configuration window.

Install dialog for user plugins

You can scan for available/new plugins there. And have them downloaded right away. New plugins are just downloaded, not implictly enabled. Reopen the config dialog to see them in the regular lists.

Index: help/pluginmanager2.page ================================================================== --- help/pluginmanager2.page +++ help/pluginmanager2.page @@ -9,11 +9,11 @@ Plugin Manager 2

As of release 2.1.8 there is a plugin manager. It's available as feature extension. Once acticated (after a restart) it brings up a - new 📦 Add tab in the configuration window.

+ new 📦 Add tab in the configuration window.

Install dialog for user plugins

You can scan for available/new plugins there. And have them