The tabs
The |
+ While the |
+
Disabling or enabling a plugin however requires a restart of Streamtuner2
to take effect. (Unless the Plugin Manager 2
is enabled, with its
Radio.net is a European radio directory. It nicely catalogues stations into genres as usual. The primary list is ordered by popularity even.
Magnatune is an independent label for artists. It makes most albums available for free listening with only a few intermittent adverts. Otherwise it's a flatrate payable music discovery and download service.
PublicRadioFan.com hosts a huge lists of worldwide radio stations. This plugin displays just the genre list though.
Delicast.com is another web directory of radio stations. It's somewhat slower because playback addresses are hidden away with extra page requests. Works reliably still.
ListenLive is also an Europe-centric radio directory.
Is an Ireland-based radio station directory.
Station database that's readily available as CSV list. You'll currently need the tmp_clean_multiurl plugin as well, as most entries supply multiple URLs, but action.py doesn't support those currently.
Categorized station list by a cross-platform streaming service provider.
Reciva is an iPhone app, with a browsable station list.
House-mixes.com provides a growing collection of DJ mixes (house, dance, etc). The website can be used after a free registration to download complete MP3s (often in high quality). In Streamtuner2 you can even drag and drop them onto your desktop directly.
PunkCast is no longer maintained. It covered the NY music and tech scenes, but existing recordings are still accessible mostly (some are just weblinks however). This plugin is kept for nostalgic reasons; it was available with streamtuner1 as well.
Great Little Radio Player is another Linux desktop radio browser. It comes with a default set of categorized stations. This plugin merely imports that list as static directory.
The compound channel is a meta plugin. It can aggregate categories from other channel plugins on a per-category basis. You for example can mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio, Tunein, etc. Which avoids switching between channel tabs somewhat.
You can also browse local files with streamtuner2 using the file
browser plugin. It must be configured with your music collection path.
It's not a default plugin, because this isn't really what Streamtuner2
is made for. There are way better local music collection managers for
Linux. It's just here for convenience, and displays files just as any
Index: help/contrib_features.page
==================================================================
--- help/contrib_features.page
+++ help/contrib_features.page
@@ -16,11 +16,11 @@
the
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.
@@ -30,21 +30,21 @@
altogether if you set these options too high. Some channels provide all
their streams with 64kbit/s only.
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.
There's an "Export All" plugin available. It adds an entry under
This is of course intended primarily for saving your bookmarks.
@@ -52,21 +52,21 @@
You can set the desired playlist format in the file saving dialog that pops up.
This plugin enables an extra category in the
Please see the Wiki for further setup instructions.
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.
-
-
Drag and Drop
- Favicons
- Global key shortcut
- Timer
- Specbuttons
+ ๐ Drag and Drop
+ ๐ Favicons
+ ๐ Global key shortcut
+ ๐ Timer
+ ๐ Specbuttons
The "search", "configwin" and "streamedit" plugins are considered built-ins and cannot be disabled.
@@ -94,41 +94,42 @@The Plugin Manager lists other
available feature plugins in the
Enables playback of soundcloud.com links in the Reddit plugin. +
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
Alternatively you could configure an external player like soundcli of course. Use the pseudo type "audio/soundcloud" for the player settings table.
This is a pure development plugin, meant to debug ST2 crashes.
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.
Currently not working. 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.
Strips extra space-separate URLs from station list. (Currently only - required for RadioSure channel. Later ST2 versions will likely support + required for ๐ป RadioSure channel. Later ST2 versions will likely support such entries per default again).
When starting to play a station, its homepage favicon is automatically downloaded
in the background. It's even displayed right away as soon as it's there. You can
also have a whole category/genre list updated right away per menu command
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. This isn't super exact however, so you might end up with homepages and icons from Wikipedia, Twitter, Facebook or something for generic radio station names. (Btw, station titles like www.mymusicstation.com are automatically mapped to homepage URLs already.)
Downloading favicons directly from station homepages can sometimes be
a little slow. Which is because it requires to inspect the homepage
itself first, and then uncovering an image resource. The Google method
instead uses
Oftentimes the Google favicon service sends back a placeholder icon (a blue mini globe), which doesn't look very interesting. So you might want to disable those. (They're still downloaded, but just not saved in the cache directory.)
Windows config
There's a few things you have to take care of when configuring players and recording apps on Windows. Common applications and settings would be:
Player config | ||
Player config | ||
audio/mpeg |
wmplayer.exe %asx |
Windows media player doesn't understand PLS or M3U files. |
url/http |
iexplore.exe %url |
IE is not recommended, of course. |
Recording apps | ||
Recording apps | ||
audio/* |
/D "C:\Programs\Streamripper" streamripper.exe %srv |
Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program. |
Format |
-Application |
-
audio/mpeg |
-audacious |
-
audio/ogg |
-audacious |
-
audio/* |
-vlc --one-instance |
-
video/* |
-totem |
-
video/youtube |
-vlc %srv |
-
Application names are most always lowercase binary names. Double click an entry to edit it. - After editing, the icon next to the application name will be updated. If it stays green, it's - likely to work. If it turns red / into a stop symbol, then the entered name is likely incorrect.
After the application name, you can optionally use a placeholder like "%pls" (default), - "%m3u" (old), or "%xspf" (modern), and "%srv" (for direct - streaming URLs). See placeholders.
-Catch-all entries like */* or a generic audio/* entry allow to - configure a default player. While video/youtube is specific to the Youtube - channel. And url/http a pseudo MIME type to configure a web browser (for - station homepages).
-In practice you only need one entry for audio/* and one for - video/*, both can use the same player even. You can remove default entries by - clearing both the Format field and its associated Application. Add completely new - associations through the emtpy line. (Reopen the dialog to add another one.)
+-
+
Application names are most + always lowercase binary names.
+Double click an entry to edit it. After editing, the icon + next to the application name will be updated. If it stays green, it's + likely to work. If it turns red / into a stop symbol, then the + entered name is likely incorrect. (Only works on U*ix-systems.)
+-
+
After the application name, you can optionally use + a placeholder:
++-
+
%pls โ default format
+%m3u โ older scheme
+%xspf โ modern playlists,
+%srv โ for direct streaming URLs
+
+ -
+
The format entries can specify generic or custom handlers:
++-
+
Catch-all specifiers like */* or a generic + audio/* entry allow to configure a default + player.
+While video/youtube is specific to the Youtube + channel.
+And url/http a pseudo MIME type to configure a + web browser (for station homepages).
+
+ In practice you only needed one entry for audio/* + and one for video/*, both can use the same player even. +
+You can remove existing entries by clearing both the Format + field and its associated Application. Add completely new associations + through the emtpy line.
+
Recording Apps
Channel and feature plugins and settings
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 +
The ๐ป Channels tab shows 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. (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.
Index: help/html/contrib_channels.html ================================================================== --- help/html/contrib_channels.html +++ help/html/contrib_channels.html @@ -23,58 +23,69 @@Besides the standard channels, there are a few more plugins available for download. See the Plugin Manager and its ๐ฆ Add tab.
-
-
- Radio.net +
- ๐ป Radio.net +
Radio.net is a European radio directory. It nicely catalogues stations into genres as usual. The primary list is ordered by popularity even.
-- Magnatune +
- ๐ป Magnatune +
Magnatune is an independent label for artists. It makes most albums available for free listening with only a few intermittent adverts. Otherwise it's a flatrate payable music discovery and download service.
-- PublicRadioFan +
- ๐ป PublicRadioFan +
PublicRadioFan.com hosts a huge lists of worldwide radio stations. This plugin displays just the genre list though.
-- Delicast +
- ๐ป Delicast +
Delicast.com is another web directory of radio stations. It's somewhat slower because playback addresses are hidden away with extra page requests. Works reliably still.
-- ListenLive.eu +
- ๐ป ListenLive.eu +
ListenLive is also an Europe-centric radio directory.
-- Liveradio.ie +
- ๐ป Liveradio.ie +
Is an Ireland-based radio station directory.
-- RadioSure +
- ๐ป RadioSure +
Station database that's readily available as CSV list. You'll currently need the tmp_clean_multiurl plugin as well, as most entries supply multiple URLs, but action.py doesn't support those currently.
-- vTuner +
- ๐ป vTuner +
Categorized station list by a cross-platform streaming service provider.
-- Reciva +
- ๐ป Reciva +
Reciva is an iPhone app, with a browsable station list.
-- house-mixes +
- ๐ป house-mixes +
House-mixes.com provides a growing collection of DJ mixes (house, dance, etc). The website can be used after a free registration to download complete MP3s (often in high quality). In Streamtuner2 you can even drag and drop them onto your desktop directly.
-- PunkCast +
- ๐ป PunkCast +
PunkCast is no longer maintained. It covered the NY music and tech scenes, but existing recordings are still accessible mostly (some are just weblinks however). This plugin is kept for nostalgic reasons; it was available with streamtuner1 as well.
-- GrLittleRadioPlayer +
- ๐ป GrLittleRadioPlayer
Great Little Radio Player is another Linux desktop radio browser. It comes with a default set of categorized stations. This plugin merely imports that list as static directory.
-- Compound +
- ๐ป Compound
The compound channel is a meta plugin. It can aggregate categories from other channel plugins on a per-category basis. You for example can mash Top40 or Classic genres from Shoutcast, Xiph, InternetRadio, Tunein, etc. Which avoids switching between channel tabs somewhat.
-- File browser +
- ๐ป File browser
You can also browse local files with streamtuner2 using the file browser plugin. It must be configured with your music collection path. It's not a default plugin, because this isn't really what Streamtuner2 is made for. There are way better local music collection managers for Linux. It's just here for convenience, and displays files just as any Index: help/html/contrib_features.html ================================================================== --- help/html/contrib_features.html +++ help/html/contrib_features.html @@ -20,11 +20,11 @@
Extra functionality and behaviour changes are available in the ๐ Feature configuration section.
-+Filter Bitrate
๐ 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.
-
@@ -35,21 +35,21 @@
altogether if you set these options too high. Some channels provide all
their streams with 64kbit/s only.
-+Channel toolbar link
๐ 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
๐ 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.
-
@@ -58,11 +58,11 @@
You can set the desired playlist format in the file saving dialog that pops up.
-+RadioTray hook
๐ 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 @@ -69,11 +69,11 @@ radios are recategorized in RadioTray.
Please see the Wiki for further setup instructions.
-+User Agent Switcher
๐ 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.
@@ -82,15 +82,15 @@
Other feature plugins
The "search", "configwin" and "streamedit" plugins are considered built-ins and cannot be disabled.
@@ -100,33 +100,34 @@Downloadable contrib/ feature plugins
The Plugin Manager lists other available feature plugins in the ๐ฆ Add tab.
-
-
- Soundcloud streaming +
- ๐ Soundcloud streaming
-
-
Enables playback of soundcloud.com links in the Reddit plugin. +
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 +
- ๐ new_station
Currently not working. 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 + required for ๐ป RadioSure channel. Later ST2 versions will likely support such entries per default again).
Configuration options
Index: help/html/filtermusic.html ================================================================== --- help/html/filtermusic.html +++ help/html/filtermusic.html @@ -33,11 +33,29 @@ listen to most popular stations.-
-
- Load favicons on playing +
- โ Load favicons on playing
When starting to play a station, its homepage favicon is automatically downloaded in the background. It's even displayed right away as soon as it's there. You can also have a whole category/genre list updated right away per menu command Channelย โธ Update favicons....
-- Homepage googling +
- โ Homepage googling
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. This isn't super exact however, so you might end up with homepages and icons from Wikipedia, Twitter, Facebook or something for generic radio station names. (Btw, station titles like www.mymusicstation.com are automatically mapped to homepage URLs already.)
-- Use Google favicon service +
- โ Use Google favicon service
Downloading favicons directly from station homepages can sometimes be a little slow. Which is because it requires to inspect the homepage itself first, and then uncovering an image resource. The Google method instead uses http://www.google.com/s2/favicons?domain=www.example.com to fetch a PNG icon right away. Which is often faster. You might want to disable this for privacy reasons though.
-- Omit placeholders +
- โ Omit placeholders
Oftentimes the Google favicon service sends back a placeholder icon (a blue mini globe), which doesn't look very interesting. So you might want to disable those. (They're still downloaded, but just not saved in the cache directory.)
Configuration
Index: help/html/internet_radio_org_uk.html ================================================================== --- help/html/internet_radio_org_uk.html +++ help/html/internet_radio_org_uk.html @@ -30,13 +30,16 @@-Like the Xiph plugin this channel provides two/three fetch modes.
+Like the ๐ป Xiph plugin this channel provides + three fetch modes:
+-
+
-
++
Website
Extract all streams from the web page + directly.
+
+ -
++
XML Data
Use ๐พ list.2.0.xml which + the channel service provides directly.
+
+ -
++
Buffered
Keeps the XML file in memory. (It + rarely changes.)
+
+
There's no speed or feature differences this time. You might prefer the buffered mode, as it reduces update requests, but still allows refreshing lists.
Uses HTML extraction (regex or pyquery) internally.
-Configuration
+Note that this plugin has its own setting on how many - links to retrieve. Instead of stream numbers, it only counts pages. - Which however speeds up processing now.
-
++
๐ pages to fetch
Note that this plugin has its own setting on how many + links to retrieve. Instead of stream numbers, it only counts pages. + Which is because this directly influences the stream loading time.
+
Obviously you want to pipe youtube-dl to an actual audio player again. VLC also supports a few services directly or via plugins.
-Besides audio/video links, some subreddits link to album art or are just news feeds. Enable the "keep all" option to retain them. Such entries will open in your web browser instead of an audio player, of course.
Channel options.
-
-
- Language -
There's an English and a German variant of this radio directory. Genres are - also localized. Restart streamtuner2 after switching the Language option. Then - use Channelย โธ Reload category tree.
+- ๐ Language +
-
+
There's an English and a German variant of this radio directory. Genres are + also localized.
+Restart streamtuner2 after switching the Language option. Then + use Channelย โธ Reload category tree.
+