Index: help/action_recording.page ================================================================== --- help/action_recording.page +++ help/action_recording.page @@ -14,11 +14,13 @@
Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool
You can configure the recording tool according to audio types again.
+You can configure the recording tool
+according to audio types again. Usually you want to use the
There's already a default entry for recording radio stations:
Index: help/channel_filtermusic.page ================================================================== --- help/channel_filtermusic.page +++ help/channel_filtermusic.page @@ -24,13 +24,22 @@Most useful if you don't like to browse around, and want to listen to most popular stations.
Like the Xiph plugin this channel provides two/three fetch modes.
+Like the ๐ป Xiph plugin this channel provides + three fetch modes:
+Extract all streams from the web page + directly.
Use
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.
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.
+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.
+You can switch between MP3 and Ogg Vorbis audio streams for Jamendo. It's not honored by the radio section, but albums and tracks should be received as Ogg when configured so.
Album covers are downloaded in lieu of favicons. They're available in different sizes. Use 25px if you want just favicon-sized icons.
Currently only 1 page (of 200 entries each) of album/track lists are fetched.
Setting a higher value may not work.
VLC (built-in support)
See recording configuration if you - want to enable the download mode.
-Audio files are packaged up in ZIP files on MODArchive. +
Audio files are packaged up in ZIP files on MODArchive. While they are different formats (IT, S3M, XM, etc) they'll all carry a generic audio/mod+zip type specifier in - streamtuner2.
Recording apps | |
audio/mod+zip |
You can use
You can configure the number of pages it'll try (
And the song title updating ("
You can configure the number of pages it'll try (
And the song title updating can be disabled (for speedier loading). + Future versions of this channel plugin might poll it automatically, + and keep the station list auto-updated.
+Language
๐ 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 + also localized.
+Restart streamtuner2 after switching the Language option. Then
use
A miximum of 100 entries get fetched in this mode however (which is 5 pages รก 20 entries).
The filter by bitrate option is now a generic plugin.
+The filter-by-bitrate option is now a generic plugin.
Region
๐ Region
With the country dropdown you can predefine which mostPopular listings are returned.
My Channels
๐ My Channels
You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
To apply this setting, and have new categories show up in the genre pane, use
It's not an exact map, but utilizes the search function to find channels.
Wadsworth constant
โ Wadsworth constant
Only influences the video homepage link.
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 | ||
Windows media player doesn't understand PLS or M3U files. | ||
VLC pretty much works alike on Windows. | ||
It's best to enclose paths with spaces in quotes. | ||
IE is not recommended, of course. | ||
Recording apps | ||
Recording apps | ||
Command line programs need the /D switch first, then its path enclosed in quotes and a space before the program. |
You can avoid a few issues: if you put your executables in paths without spaces, or set the system $PATH variable accordingly.
As reported by Oliver in the sourceforge Discussion board.
MIME types are abstract identifiers for media types. Audio/mpeg for example represents MP3 files, and audio/ogg means OGG Vorbis. And the player setting dialog simply associates an audio type with a playback application:
-Format | Application |
audio/mpeg | |
audio/ogg | |
audio/* | |
video/* | |
video/youtube |
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.
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.
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
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
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.
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.
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.
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.
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
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
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
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
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.)
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.
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 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/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.
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.
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 Main menuย โธ Extensionsย โธ Export all stations. Which allows to export all stations from the currently visible channel category.
You can set the desired playlist format in the file saving dialog that pops up.
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.
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.
The "search", "configwin" and "streamedit" plugins are considered built-ins and cannot be disabled.
@@ -100,33 +100,34 @@The Plugin Manager lists other available feature plugins in the ๐ฆ Add tab.
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.
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 Channelย โธ Update favicons....
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 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.
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.)
Like the Xiph plugin this channel provides two/three fetch modes.
+Like the ๐ป Xiph plugin this channel provides + three fetch modes:
+Extract all streams from the web page + directly.
+Use ๐พ list.2.0.xml which + the channel service provides directly.
+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.
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.
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.
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.
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.
+