Like the Xiph plugin this channel provides two/three fetch modes.
+
+ Like the Xiph plugin this channel provides two/three fetch modes.
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.
Internet-Radio.com is a broad alternative to Shoutcast. - It has regained station homepages for most entries again. - Genres are similiar to Shoutcast.
+Internet-Radio.com is a broad alternative to Shoutcast.
+-
+
It has regained station homepages for most entries again.
+ Genres are similiar to Shoutcast.
+ Updating station list is comperatively fast.
+
Note that this plugin has its own setting on how many
+ 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).
MODPlug for XMMS
GModplay
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. While they are - different formats (IT, S3M, XM, etc) they'll all carry a generic - audio/mod+zip type specifier in streamtuner2.
See recording configuration if you + want to enable the download mode.
+ +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.
MyOggRadio also has a neat cross-platform player: JMyOggRadioPlayer.
If you want to upload station infos to MyOggRadio, you need an account there.
Index: help/channel_radionomy.page
==================================================================
--- help/channel_radionomy.page
+++ help/channel_radionomy.page
@@ -3,11 +3,12 @@
id="radionomy">
Radionomy is an internet radio streaming provider, orginally founded in Belgium. It commands a pretty big slice of the worldwide internet radio stuff these days. - It took over Shoutcast.com for instance.
-Their primary directory on Radionomy.com lists only stations - that radionomy itself hosts streaming servers for. It's over 6000 +
Their primary directory on Radionomy.com only lists stations + which radionomy itself hosts streaming servers for. It's over 6000 already. Both listening and station hosting are free (given agreement to autoplay advertisements, and a minimum quota of daily listeners). Radionomy is therefore pretty popular and growing.
The extraction method in streamtuner2 uses a mix of RegExp, DOM traversal, and JSON extraction, with some AJAX updating spiced in. (It closely follows the website scheme to fetch station lists.)
- You can configure the number of pages it'll try (
And the song title updating ("
SomaFM is a small radio station network. It provides its own unique channels. Which streamtuner2 shows in a static list.
+ +SomaFM is a non-commercial and ad-free provider. It + strongly depends on listener donations.
It provides streaming links in different audio formats. Only AAC64 is guaranteed to be available for all. Other bitrates depend on the station.
- +After reconfiguring the bitrate/format, you can Reload the station list to update them. Otherwise refreshing has no effect.
- -SomaFM is a non-commercial and ad-free provider. It - strongly depends on listener donations.
It's both pretty large and rather quick to extract listings from. And it mostly includes station homepage links.
- -The MusicTV and NewsTV sections also return results, but those are mostly - web-based video stations. Some of them are outdated links even.
+The MusicTV and NewsTV sections also return results, but those are mostly + web-based video stations. Some of them are outdated links even.
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
TuneIn hosts a major radio, show and podcast directory. It also provides the RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML lists only for radio stations currently.
+ +You can switch between "music" and "genres" list. The genres
+ list is basically a longer and expanded variant of "music".
+ Use
However, it lacks some essential informations like station homepages and listener numbers.
Xiph also uses the .xspf format, instead of .pls stream links
- -The bitrate of an audio stream determines the music quality. Many Xiph streams have simple and low quality microphone sources. To filter these out, and only leave high quality music stations, you can therefore change this option. OGG starts to sound well with 96 kbit/s (whereas @@ -80,8 +80,9 @@ supported.
Of course you could also just invoke a specific YT video by
opening it in your web browser - click the station
With the country dropdown you can predefine which mostPopular listings are returned.
-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.
-Only influences the video homepage link.
-With the country dropdown you can predefine which mostPopular listings are returned.
+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.
+Only influences the video homepage link.
+The notebook tabs can also be repositioned with
-
If you first select a channel tab, the categories should appear or be loading. Otherwise:
Choose
Pick a category/genre from the overview, left.
Individual channels provide different music/radio information. The table - views are mostly identical in each tab. Some views may rename columns, or remove - them alltogether.
+ views are however mostly identical for each tab. Some views may rename columns, + or remove them alltogether.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 *.py files. These are somewhat readable even to non-programmers, and sometimes contain more information.
The tabs in the main window represent the music directory channels/services. Each lists categories/genres and their associated radios/streams.
The notebook tabs can also be repositioned with - Edit ▸ Channel tab position ▸ Left. - And since 2.1.5 you can directly reorder the channel tabs themselves, - by dragging them around.
+ Edit ▸ Channel tab position ▸ Top. + And you can directly rearrange the channel tabs themselves, + by dragging them within the list.If you first select a channel tab, the categories should appear or be loading. Otherwise:
Select a channel tab
Choose Channel ▸ Reload categories...
Pick a category/genre from the overview, left.
Individual channels provide different music/radio information. The table - views are mostly identical in each tab. Some views may rename columns, or remove - them alltogether.
+ views are however mostly identical for each tab. Some views may rename columns, + or remove them alltogether.Available channels
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 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 - *.py files. These are somewhat readable even to non-programmers, and sometimes contain more information.
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 + *.py files. These are somewhat readable even to non-programmers, and sometimes contain more information.
More Information
filtermusic
//filtermusic.net/
@@ -24,21 +28,28 @@ focused on electro/dance/pop stations. It elects on listener popularity and freshness or something.Which is why there are just a dozen categories with around 20-30 stations each. Still useful if you don't like to browse around a lot.
-Like the Xiph plugin this channel provides two/three fetch modes. +
Configuration
Like the Xiph plugin this channel provides two/three fetch modes.
+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.
Internet-Radio
//internet-radio.com/
Internet-Radio.com is a broad alternative to Shoutcast. - It has regained station homepages for most entries again. - Genres are similiar to Shoutcast.
-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).
Internet-Radio.com is a broad alternative to Shoutcast.
+-
+
It has regained station homepages for most entries again.
+Genres are similiar to Shoutcast.
+Updating station list is comperatively fast.
+
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).
More Information
-
Index: help/html/introduction.html
==================================================================
--- help/html/introduction.html
+++ help/html/introduction.html
@@ -13,24 +13,26 @@
Select a channel tab, like Shoutcast.
Click one of the genres in the left pane. For example Classic.
Now the right pane loads a radio list.
-Double click one of the radio streams or use the play toolbar button.
+Double click one of the radio streams or use the ▶ play toolbar button.
Introduction
Streamtuner2 is a simple browser for internet radios. It aquires its radio lists from various directory services. These are represented as "channel" tabs in the main - window. Below are the category/genre lists (left) and all stations for a genre (right).
+ window. The category/genre lists are in the left pane, and associated stations right + to them.
How to select and play a radio.
Note that some categories can and should be exanded. In a few plugins (modarchive), - the grouping genre/categories are empty, while in other channels they're valid genres themselves.
+Note that some categories are expandable. In a few plugins (modarchive), + the grouping genre/categories are empty, while in other channels they're + filled genre lists themselves.
What else can you do?
Play, Record and Homepage also have buttons in the toolbar.
Radio lists get stale
Refresh radio lists
After some time, stream informations become obsolete. Therefore you should regularily refresh the lists. The Reload button in the toolbar (or F5) is your friend. You can also update the category lists with Channel ▸ Reload Category Tree and load favicons using Channel ▸ Update favicons...
MikMod
MODPlug for XMMS
GModplay
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. While they are - different formats (IT, S3M, XM, etc) they'll all carry a generic - audio/mod+zip type specifier in streamtuner2.
Configuration
See recording configuration if you + want to enable the download mode.
+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.
More Information
-
Index: help/html/myoggradio.html
==================================================================
--- help/html/myoggradio.html
+++ help/html/myoggradio.html
@@ -11,11 +11,13 @@
+Glossary » Additional features » Plugin Manager 2 » Channel and feature plugins and settings »
MyOggRadio
//myoggradio.org/
@@ -41,11 +43,11 @@ Shared entries aren't automatically in the personal list.MyOggRadio also has a neat cross-platform player: JMyOggRadioPlayer.
Channel options.
- Login settings
-
If you want to upload station infos to MyOggRadio, you need an account there. Index: help/html/playing.html ================================================================== --- help/html/playing.html +++ help/html/playing.html @@ -15,23 +15,23 @@
Playing
Simply double click a station entry. It starts with your configured audio player.
+To start playing a station, you can:
+-
+
Just double click an entry.
+Use the ▶ play toolbar button.
+Right click for the context menu and the play action.
+Drag and drop it directly into your audio player.
+Save it (F2) to a playlist file, then start your player with that.
+
In streamtuner2 you can configure different audio players for different audio formats (MP3 or OGG). In the Apps section of the settings dialog, you can associate one player - with each audio file (MIME) type. Per default this is audacious, but you can use any other - media player (like VLC).
-Note however that some audio players will run multiple instances and won't - allow simple station switching. In such situations it might be sensible to write - a wrapper script, or configure special commandline arguments to your favoured audio - player (e.g. "vlc --one-instance").
It's also possible to save a station entry as .m3u or .pls file, and load this manually - in your player. You might even want to collect such .m3u files for archival / backup - purposes.
+ with each audio file (MIME) type. Nowadays you can often configure the same player + for all audio (and even video) types.More Information
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.
+For updating or installing new plugins (extra channels or + features), there's a user plugin manager. It's available as + feature extension itself.
+Once acticated (after a restart) it brings up a new 📦 + Add tab in the configuration window.
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.
+ regular 📻 Channels or 🔌 Feature tabs, and + then enable them. +Configuration
-
+
Alternative download repositories may be configured. (Little + practical value at the moment.)
+-
+
And you can let the plugin manager handle autoactivation + of changed plugin states.
++-
+
After reconfiguring existing channel plugins, they get + automatically instantiated or disabled in the user interface. + (Which avoids the usual restart).
+This currently doesn't work with feature/core + plugins. Plugin deactivation is mostly visual, but does not undo + menu extensions or undefine callback hooks.
+
+
User plugins
Alternative download repositories may be configured. (Little - practical value at the moment and foreseeable future.)
-And you can let the plugin manager handle regular plugins as - well. After reconfiguring existing channel plugins, they get - automatically run, or disabled in the user interface (without - any restart). Which won't work for most feature/core plugins.
+Downloaded plugins are stored in ~/.config/streamtuner2/plugins. + To remove them, delete the individual *.py files there manually.
+Currently system-installed core plugins take + precedence over downloaded updates.
+And you'll have to take care to eventually refresh/delete outdated user plugins, + whenever you install a newer Streamtuner2 version.
+Radionomy
//radionomy.com/
@@ -22,22 +26,22 @@Radionomy is an internet radio streaming provider, orginally founded in Belgium. It commands a pretty big slice of the worldwide internet radio stuff these days. - It took over Shoutcast.com for instance.
-Their primary directory on Radionomy.com lists only stations - that radionomy itself hosts streaming servers for. It's over 6000 +
Their primary directory on Radionomy.com only lists stations + which radionomy itself hosts streaming servers for. It's over 6000 already. Both listening and station hosting are free (given agreement to autoplay advertisements, and a minimum quota of daily listeners). Radionomy is therefore pretty popular and growing.
The extraction method in streamtuner2 uses a mix of RegExp, DOM traversal, and JSON extraction, with some AJAX updating spiced in. (It closely follows the website scheme to fetch station lists.)
config options
Configuration
You can configure the number of pages it'll try (3 by default) to influence the length of station lists.
And the song title updating ("OnAir Updates") can be disabled. Future versions of this channel plugin might poll it automatically, @@ -48,10 +52,11 @@
More Information
SomaFM is a small radio station network. It provides its own unique channels. Which streamtuner2 shows in a static list.
+SomaFM is a non-commercial and ad-free provider. It + strongly depends on listener donations.
Bitrate configuration
It provides streaming links in different audio formats. Only AAC64 is guaranteed to be available for all. Other bitrates depend on the station.
After reconfiguring the bitrate/format, you can Reload the station list to update them. Otherwise refreshing has no effect.
-SomaFM is a non-commercial and ad-free provider. It - strongly depends on listener donations.
More Information
-
Index: help/html/surfmusik.html
==================================================================
--- help/html/surfmusik.html
+++ help/html/surfmusik.html
@@ -11,11 +11,13 @@
+Glossary » Additional features » Plugin Manager 2 » Channel and feature plugins and settings »
SurfMusic
//surfmusic.de/
@@ -24,22 +26,22 @@SurfMusic is a user-collection of internet radios. It's grouped by genres, or locations / countries.
It's both pretty large and rather quick to extract listings from. And it mostly includes station homepage links.
-The MusicTV and NewsTV sections also return results, but those are mostly - web-based video stations. Some of them are outdated links even.
-Channel options.
-
+
The MusicTV and NewsTV sections also return results, but those are mostly + web-based video stations. Some of them are outdated links even.
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.
-
More Information
-
Index: help/html/tunein.html
==================================================================
--- help/html/tunein.html
+++ help/html/tunein.html
@@ -10,10 +10,14 @@
TuneIn
//tunein.com/
@@ -20,16 +24,24 @@TuneIn hosts a major radio, show and podcast directory. It also provides the RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML lists only for radio stations currently.
Configuration
You can switch between "music" and "genres" list. The genres + list is basically a longer and expanded variant of "music". + Use Channel ▸ Reload category tree + to update them thereafter.
Xiph.org
//dir.xiph.org/
@@ -30,13 +32,14 @@This channel is somehwat easy to read for Streamtuner2, because the source data is already provided as <XML> file. (Internally we're using a caching service, which pre-converts that into JSON lists. The Xiph-org JSON API isn't really working yet).
However, it lacks some essential informations like station homepages and listener numbers.
Xiph also uses the .xspf format, instead of .pls stream links
-Channel options.
-
+
Channel options.
- Filter by minimum bitrate
The bitrate of an audio stream determines the music quality. Many Xiph streams have simple and low quality microphone sources. To filter these out, and only leave high quality music stations, you can therefore change this option. OGG starts to sound well with 96 kbit/s (whereas MP3 often requires 128 or 160 kbit/s at least).
@@ -81,13 +84,12 @@
supported.
More Information
-
Index: help/html/youtube.html
==================================================================
--- help/html/youtube.html
+++ help/html/youtube.html
@@ -11,11 +11,13 @@
+Glossary » Additional features » Plugin Manager 2 » Channel and feature plugins and settings »
Youtube
//youtube.com/
@@ -32,27 +34,27 @@Youtube-dl is preconfigued as "recording"/download tool for this channel tab.
Of course you could also just invoke a specific YT video by opening it in your web browser - click the station home button simply.
-Channel options.
-
+
Channel options.
- Region
With the country dropdown you can predefine which mostPopular listings are returned.
- 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 - Channel ▸ Update category tree first.
+ To apply this setting, and have new categories show up in the genre pane, use + Channel ▸ Update category tree first.It's not an exact map, but utilizes the search function to find channels.
- Wadsworth constant
Only influences the video homepage link.
-