@@ -4,90 +4,96 @@ - + Additional feature plugins - → Feature plugins +
+<key>🔌 Feature</key> plugins and settings +

Extra functionality and behaviour changes are available in the 🔌 Feature configuration section.

-
-🔌 Filter Bitrate -

Some channels provide lower-quality audio streams. In particular -Xiph lists some awful radio stations. And this plugin helps filtering -those out of station lists.

- -

MP3 streams often start to sound okay at 96kbit/s.

 -

Whereas OGG Vorbis or AAC are sometimes acceptable at 64kbit/s already.

 - -

Note that you may end up with empty channel lists -altogether if you set these options too high. Some channels provide all -their streams with 64kbit/s only.

-
- -
-🔌 Channel toolbar link -

Adds a toolbar entry which shows the current channel/directory -service title and its homepage link. Such as:

- ▶ ● 🏠 Shoutcast -play rcrd hmpg //shoutcast.com/ - -

It depends on the "update window title" option being enabled.

-
- -
-🔌 Export all stations -

There's an "Export All" plugin available. It adds an entry under -Main menu Extensions Export all stations. -Which allows to export all stations from the currently visible channel category.

- -

This is of course intended primarily for saving your bookmarks.

 -

And it allows to import radio lists into any other music player or playlist collection/management app (such as Rhythmbox).

 -

You can set the desired playlist format in the file saving dialog that pops up.

 - -
- -
-🔌 RadioTray hook -

This plugin enables an extra category in the bookmarks tab. -It shows bookmarked stations from the RadioTray application, if that's -installed. Additionally it adds an context option to save new stations -from Streamtuner2 to RadioTray. The mapping option influences if added -radios are recategorized in RadioTray.

-

Please see the Wiki for further setup instructions.

 -
- -
-🔌 User Agent Switcher -

This plugin merely masks Streamtuner2 as an ordinary web browser when retrieving station lists.

- -

It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere.

-

It's only useful as additional privacy feature really, but shouldn't be used habitually.

- -
- -
-🔌 History -

Provides the small "history" category in the bookmarks tab. The length of -which is configurable (defaults to 20).

-
- -
-🔌 Links to directory services -

Adds a list of weblinks to other online music services in the "links" category -within the bookmarks tab.

-
- -
- Other feature plugins +
+ 🔌 Filter Bitrate +

Some channels provide lower-quality audio streams. In particular + Xiph lists some awful radio stations. And this plugin helps filtering + those out of station lists.

+ +

MP3 streams often start to sound okay at 96kbit/s.

 +

Whereas OGG Vorbis or AAC are sometimes acceptable at 64kbit/s already.

 + +

Note that you may end up with empty channel lists + altogether if you set these options too high. Some channels provide all + their streams with 64kbit/s only.

+
+ +
+ 🔌 Channel toolbar link +

Adds a toolbar entry which shows the current channel/directory + service title and its homepage link. Such as:

+ ▶ ● 🏠 Shoutcast + play rcrd hmpg //shoutcast.com/ + +

It depends on the "update window title" option being enabled.

+
+ +
+ 🔌 Export all stations +

There's an "Export All" plugin available. It adds an entry under + Main menu Extensions Export all stations. + Which allows to export all stations from the currently visible channel category.

+ +

This is of course intended primarily for saving your bookmarks.

 +

And it allows to import radio lists into any other music player or playlist collection/management app (such as Rhythmbox).

 +

You can set the desired playlist format in the file saving dialog that pops up.

 + +
+ +
+ 🔌 RadioTray hook +

This plugin enables an extra category in the bookmarks tab. + It shows bookmarked stations from the RadioTray application, if that's + installed. Additionally it adds an context option to save new stations + from Streamtuner2 to RadioTray. The mapping option influences if added + radios are recategorized in RadioTray.

+

Please see the Wiki for further setup instructions.

 +
+ +
+ 🔌 User Agent Switcher +

This plugin merely masks Streamtuner2 as an ordinary web browser when retrieving station lists.

+ +

It's technically unneeded, as ST2 isn't stressful to directory websites and not blocked anywhere.

+

It's only useful as additional privacy feature really, but shouldn't be used habitually.

+ +
+ +
+ 🔌 History +

Provides the small "history" category in the bookmarks tab. The length of + which is configurable (defaults to 20).

+
+ +
+ 🔌 Links to directory services +

Adds a list of weblinks to other online music services in the "links" category + within the bookmarks tab.

+
+ +
+ +
+ Core feature plugins +

Following plugins are covered more in-depth in the according manual + sections:

🔌 Drag and Drop

🔌 Favicons

🔌 Global key shortcut

🔌 Timer

 @@ -101,53 +107,75 @@
Downloadable contrib/ feature plugins -

The Plugin Manager lists other -available feature plugins in the 📦 Add tab.

+

The Plugin Manager lists more +downloadable feature plugins in the 📦 Add tab.

- - - 🔌 Soundcloud streaming +
+ 🔌 Soundcloud streaming

Enables playback of soundcloud.com links, which are only used in the 📻 Reddit plugin currently. Homepage links are transformed into direct MP3 streaming addresses on playback.

Depends on python-soundcloud, which you can install per pip install soundcloud.

Alternatively you could configure an external player like soundcli of course. Use the pseudo type "audio/soundcloud" for the player settings table.

- - - 🔌 dev_faulthandler +
+ +
+ 🔌 dev_faulthandler

This is a pure development plugin, meant to debug ST2 crashes.

- - - 🔌 bookmarks_show_extra +
+ +
+ 🔌 bookmarks_show_extra

Is a slim UI adaption to show the `extra` field in the bookmarks channel. This field can contain user comments, but is used per default to store the originating channel in.

- - - 🔌 new_station -

Currently not working. Small plugin to provide an "Add station..." +

+ +
+ 🔌 new_station +

(Still unfinished). Small plugin to provide an "Add station..." menu entry. Note that ST2 is not meant as playlist manager, which is why this isn't a built-in feature. However, it's oft-requested anyway.

- - - 🔌 tmp_clean_multiurl +
+ +
+ 🔌 tmp_clean_multiurl

Strips extra space-separate URLs from station list. (Currently only required for 📻 RadioSure channel. Later ST2 versions will likely support such entries per default again).

- - - 🔌 stop_button +
+ +
+ 🔌 Gtk theme setting +

You can set a custom theme for Streamtuner2 using the gtk_theme + plugin. It ought to list all available themes for Gtk2 or Gtk3 in + the according dropdown box. The "apply instantly" option may help + with enabling them right away.

+

Take note that not all Gtk themes will work, + and some might crash streamtuner2.

 +

If you see ST2 hang at startup, then either edit + settings.json to remove the "theme": "..." + name, or use the streamtuner2 -d gtk_theme + start command.

+

To install/enable themes just for ST2, you could create a + ~/.config/streamtuner2/themes/ folder, or one below + /usr/share/streamtuner2/themes/ even.

+
+ +
+ 🔌 stop_button

Adds the toolbar button to stop streamripper/fpls - same as in streamtuner1. Has become kind of redundant due to the newer 🔌 specbuttons plugin.

- - +
+
+