# → Feature plugins

## `🔌 Feature` 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 a 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.

### 🔌 Recording options

Overrides the `●` record button to not start streamripper right away. Instead it prompts for additional settings before proceeding.

Common options are conveniently listed and saveable on a per-station basis. Which allows to suppress stream splitting (record just one long MP3 file), or file naming schemes.

Additionally it supports options of following recording backends:

- streamrippper - for radio stations

- fPls/fIcy - for radio stations

- youtube-dl - video downloads

- wget - plain MOD/ZIP files

The plugin provides config options of its own, such as a default output directory, or how many / how detailed options to show.

## Core feature plugins

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

- 🔌 Drag and Drop

- 🔌 Favicons

- 🔌 Global key shortcut

- 🔌 Timer

- 🔌 Specbuttons

The "search", "configwin" and "streamedit" plugins are considered built-ins and cannot be disabled.

## Downloadable contrib/ feature plugins

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

#### 🔌 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

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

#### 🔌 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

(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

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

#### 🔌 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.

#### 🔌 Config prefs

Introduces three main menu entries:

- #### Station ▸ Extensions ▸ Config save

  Saves the streamtuner2.json file verbatim.

- #### Station ▸ Extensions ▸ Config restore

  While the file dialog incorrectly says and behaves like a file save dialog, it does in fact open and load the JSON file.

- #### Station ▸ Extensions ▸ Config delete

  The config reset additionally opens the settings window and requires you to hit `Save` for confirmation. In any case ST2 should also be restarted afterwards to unload disabled plugins.

#### 🔌 Cache reset

Adds a `Cache reset` button in the Options tab of the settings window. It shows how much space all cache files of ST2 occupy. Usually the icons take up most, while the channel/station archive is often just 2-3 MB. Temporary m3u/pls files can also be deleted. → Tick the parts you want to have removed before hitting the reset button.

#### 🔌 OGG Icon

Introduces small state icons to make higher-quality Vorbis and Opus stations stand out. (Not all channels provide exact format information, so you'll mostly notice for Jamendo and Xiph.)

#### 🔌 Win32/subprocess

Wraps the player/application exec() method. Instead of simple shell execution, uses the Python subprocess module or win32 API functions. This is mostly unneeded on Linux (kills a few features even), but avoids the cmd.exe popup and delay on Windows. Highly experimental at the moment.

#### 🔌 New favourite category

Adds a "New favourite category..." under Station > Extensions menu, and context menu options to copy station entries there. DND from other channels works, if you preselect the new subcategory beforehand. It's an afterthought/workaround for those who insist on using ST2 for stream management.