Dirble.com is another radio station directory, made up of
- user-contributed content, and automatic streaming server polling.
-
-
It provides a JSON API, which as of v2 has a lot of unneeded meta
- information and internal ids. But it's actually nicer to scan, and
- contains even station homepages now.
-
-
The config option for a custom API key is perhaps
- redundant. Should streamtuner2 -D however reveal an error, you
- can however configure your own account there.
+
+
Dirble.com is another radio station directory, based on
+ user-contributed entries and automatic streaming server polling.
+
+
+
Provides a JSON API, which in v2 is easy to extract from.
+
List contain even station homepages mostly.
+
And the channel plugin selects among the available
+ streaming URLs based on format (Ogg, AAC, preferred over MP3) and
+ maximum bitrate.
+
+
+
There's a hidden config option for a custom API key.
+ It's perhaps redundant. Should streamtuner2 -D however reveal an error,
+ you can however configure your own account in settings.json.
+
Filtermusic summarizes all the common genres, but is primarily
- focused on electro/dance/pop stations. It elects on listener
- popularity and freshness or something.
+ focused on electro/dance/pop stations.
+
+
+
There's around a dozen categories with 20-30 radios each.
+
Prioritizes stations on listener popularity and freshness or something.
+
The plugin fetches a XML list of stations, or extracts from the homepage.
+
-
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.
+
Most useful if you don't like to browse around, and want to
+ listen to most popular stations.
Configuration
Like the Xiph plugin this channel provides two/three fetch modes.
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 lists is comperatively fast.
+
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).
+ links to retrieve. Instead of stream numbers, it only counts pages.
+ Which however speeds up processing now.
Index: help/channel_jamendo.page
==================================================================
--- help/channel_jamendo.page
+++ help/channel_jamendo.page
@@ -10,22 +10,22 @@
Jamendo//jamendo.com/
-
Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio
-files for individual musicians and artists. Tracks and albums can thus be downloaded
-free of charge. Yeah, imagine that.
-
-
The new Jamendo v3.0 is now utilized. It allows to list albums,
-playlists, and individual tracks by genre. The radio list is static
-(they're looping over randomized songs from each genre.)
-
-
Instead of favicons, streamtuner2 can fetch album or track
-covers. Thus the images are a bit larger, and retrieving them all
-via ChannelLoad favicons...
-takes a while longer.
+
Jamendo is a Creative Comments licensing oriented music distributor. It
+hosts audio files for individual musicians and artists. It allows to list
+albums, playlists, and individual tracks by genre.
+
+
+
The new Jamendo v3.0 is now utilized, which is JSON based and easy to extract.
+
Its radio list is static. It loops over randomized songs from each genre.
+
There's a custom JSON playlist extractor (JAMJSON), to avoid preloading stream URLs for feeds/albums. While tracks/genre lists contain direct streaming addresses already.
+
Instead of favicons, streamtuner2 can fetch slightly larger album or track covers.
+
+
+
Tracks and albums can be downloaded free of charge (Creative Commons). Yeah, imagine that.
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 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.
- Instead of favicons smaller station logos are displayed (25px
- in contrast to the usual 16px).
-
-
-
- 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,
- and keep the station list auto-updated.
-
-
+Radionomy
+//radionomy.com/
+
+
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.
+
+
+
Its directory contains over 6000 stations already, all of them hosted by Radionomy directly.
+
This plugin uses a mixture of RegExp/DOM extraction, JSON reading, and simulated AJAX queries to fetch station lists.
+
Station logos are 25x25px large, and directly fetched from radionomy.com as well.
+
+
+
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.
+
+
+
+ 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,
+ and keep the station list auto-updated.
+
+
Index: help/channel_shoutcast.page
==================================================================
--- help/channel_shoutcast.page
+++ help/channel_shoutcast.page
@@ -15,11 +15,11 @@
station lists on shoutcast.com.
Station entries usually provide current playing information.
-
Stream links are plain PLS files.
+
Stream links are plain PLS files.
Genres are subcategorized, so the main groups in the category
list must be expanded to see the interesting entries.
Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
Index: help/channel_somafm.page
==================================================================
--- help/channel_somafm.page
+++ help/channel_somafm.page
@@ -3,11 +3,11 @@
id="somafm">
-
+
Set of radio stations
There's a manually curated list of radio stations in the
- UbuntuUsers.de Wiki. Like the origin website, most entries are
- German or European stations.
-
-
So this is more of an example plugin, as it's not a huge list
- of course. It's just here really, because the Wiki markup is
- pretty well-written and easy to parse.
+ UbuntuUsers.de Wiki.
+
+
Like the origin website, most entries are German or European stations.
+
So this is more of an example plugin, as it's not a huge list.
+
RegExp are used for extraction, because the Wiki markup is rather well-maintained and consistent.
+
+
There's also a small streaming TV list. But most entries
aren't really accessible (anymore) without command line tools.
(Which that very Wiki page covers in detail.)
Xiph.org is a non-profit organization, which maintains and
- promotes the OGG streaming format, and develops audio compression
- schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
- format. It also hosts a list of ICEcast streaming stations. ICEcast
- is their non-commercial pendant to the SHOUTcast server.
-
-
There are different ways for streamtuner2 to retrieve the station
- lists available on dir.xiph.org. That's because this is a primary
- plugin, and fallback solutions therefore important. Each fetching
- mode has its own advantages and drawbacks though.
-
-
Xiph also uses the .xspf playlist format, instead of just the
- more ancient Shoutcast .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
- MP3 often requires 128 or 160 kbit/s at least).
-
-
- Fetch mode
-
There are now three options to retrieve Xiph directory stations.
-
-
-
- Cache JSON
-
There's a caching server specifically for streamtuner2. It fixes
- Xiphs quirky JSON API, and provides a simpler interface. It can't
- correct the invalid encodings however, which is why you see ????
- question marks a lot. This method does not reveal station homepages,
- but enables the channel/server search.
-
-
-
- Clunky YP.XML
-
The "yellow pages" YP.XML contains the full list of all known
- ICEcast streaming servers. It's however quite bulky and super slow
- to download. It furthermore clogs up a lot of memory, and requires
- manual searching (only cache search works). Which is why streamtuner2
- is trying hard to avoid it. It doesn't contain station homepages either.
-
-
It's only still an option, because it's likely to remain accessible
- after Xiph.org rewrites their directory service. (Which though is
- getting delayed since a few years already.)
- You can set the special "buffy" mode in your settings.json
- to keep the whole YP.XML in memory. Which avoids the
- slow station list download/unpacking.
-
-
-
-
- Forbidden fruits
-
As new alternative, you can let ST2 directly scrape the station
- lists from dir.xiph.org (like it does for other channels). This is
- something which Xiph doesn't approve of. But the drawbacks of their
- alternative offerings are too severe and user-unfriendly; which is
- why there's this raw HTML extraction mode now.
-
The website listings contain full station homepages and a few
- more extras. In this mode we can even acceess the XSPF playlist
- formats directly. Both, the server search function, or browsing by
- audio/video format are supported.
-
A miximum of 100 entries get fetched in this mode however
- (which is 5 pages á 20 entries).
-
-
-
-
+Xiph.org
+//dir.xiph.org/
+
+
Xiph.org is a non-profit organization which develops and maintains
+various audio- and video-related standards.
+
+
+
For example the OGG streaming/multiplexing format.
+
Audio compression schemes like Vorbis, Speex, FLAC, Opus.
+
Video encoding formats like Theora, Tarkin, Dirac.
+
The ICEcast streaming server is an alternative to SHOUTcast.
+
And the more modern .xspf (and .jspf) playlist format, which is used by all channel entries.
+
+
+
There are different ways for streamtuner2 to retrieve the station
+lists available on dir.xiph.org. That's because this is a primary
+plugin, and fallback solutions therefore important. Each fetching
+mode has its own advantages and drawbacks though.
+
+
+
+ Channel fetch mode option
+
There are now three options to retrieve Xiph directory stations.
+
+
+ Cache JSON
+
There's a caching server specifically for streamtuner2. It fixes
+ Xiphs quirky JSON API, and provides a simpler interface. It can't
+ correct the invalid encodings however, which is why you see ????
+ question marks a lot. This method does not reveal station homepages,
+ but enables the channel/server search.
+
+
+ Clunky YP.XML
+
The "yellow pages" YP.XML contains the full list of all known
+ ICEcast streaming servers. It's however quite bulky and super slow
+ to download. It furthermore clogs up a lot of memory, and requires
+ manual searching (only cache search works). Which is why streamtuner2
+ is trying hard to avoid it. It doesn't contain station homepages either.
+
+
It's only still an option, because it's likely to remain accessible
+ after Xiph.org rewrites their directory service. (Which though is
+ getting delayed since a few years already.)
+ You can set the special "buffy" mode in your settings.json
+ to keep the whole YP.XML in memory. Which avoids the
+ slow station list download/unpacking.
+
+
+
+ Forbidden fruits
+
As new alternative, you can let ST2 directly scrape the station
+ lists from dir.xiph.org (like it does for other channels). This is
+ something which Xiph doesn't approve of. But the drawbacks of their
+ alternative offerings are too severe and user-unfriendly; which is
+ why there's this raw HTML extraction mode now.
+
The website listings contain full station homepages and a few
+ more extras. In this mode we can even acceess the XSPF playlist
+ formats directly. Both, the server search function, or browsing by
+ audio/video format are supported.
+
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.
Besides the standard channels, there are a few more plugins available
+for download. See the Plugin Manager
+and its 📦 Add tab.
+
+
+
+
Reddit
+
Reddit is a social media site. Among its various sections is a large
+ /r/Music subreddit group. Most of them link popular or novel Youtube
+ music videos, or user-produced content etc. Radioreddit.com even provides
+ streaming servers. This plugin can also list Soundcloud/Mixcloud/Bandcamp
+ links. But those would require a custom audio player. There's an extra
+ Soundcloud plugin however, which makes those streams readily playble.
+
+
+
Di.fm
+
"Digitally Imported" are mostly electronic music radio stations.
+ The freely available stations stream with 64kbit/s AAC+ only.
+
+
+
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 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.com hosts a huge lists of worldwide radio stations.
+ This plugin displays just the genre list though.
+
+
+
WindowsMedia
+
Is actually a Windows-specific streaming directory. Station entries
+ are converted from ASX into standard playlist formats by ST2.
+
+
+
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 is also an Europe-centric radio directory.
+
+
+
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 howeever). 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 browser 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
+ other channel list. It has no specific file management features, and
+ won't get any.
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
+//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 menuExtensionsExport 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.
The Plugin Manager lists further
+feature pluginsand in the 📦 Add tab.
+
+
+
+
Soundcloud streaming
+
Enables playback of soundcloud.com links in the Reddit plugin.
+ Homepage links are transformed into direct MP3 streaming addresses
+ on playback. This plugin registers a "audio/soundcloud" pseudo
+ type. Alternatively you could use soundcli of course.
+
+
+
dev_faulthandler
+
This is a pure development plugin, meant to debug ST2 crashes.
There's an "Export All" plugin available. It adds an entry under
- Main menuExtensionsExport 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).
-
-
- Configuration option
-
You can set the default export format in the settings dialog
- F12.
-
It supports all common export formats now, with .PLS being the
- default.
Per default you'll get a small logo / icon for any station
with a homepage link. They're automatically fetched and displayed
as soon as you play a radio entry.
-
This functionality meanwhile resides in a plugin. It's available in the
-🔌 Features configuration tab.
-You can disable it as whole if unneeded. Most configuration options are now
-collected there.
+
+
This functionality meanwhile resides in a plugin.
+
It's available in the 🔌 Features configuration tab.
+
Most configuration options are now collected there.
+
Some channels (Jamendo or Radionomy) provide small album previews
-or banners (Punkcast) even. Whereas normal favicons are just 16x16
-pixel images.
+or banners even. Whereas normal favicons are just 16x16 pixel images.
-
Downloaded image files are meanwhile all sanitized (internally
+
Downloaded image files are meanwhile all sanitized (internally
converted to ensure they're really image files).
Albeit that's not strictly necessary for modern Gtk versions. (But
better safe than sorry).
Images are kept in the ~/.config/streamtuner2/icons directory.
-
Dirble.com is another radio station directory, made up of
- user-contributed content, and automatic streaming server polling.
-
It provides a JSON API, which as of v2 has a lot of unneeded meta
- information and internal ids. But it's actually nicer to scan, and
- contains even station homepages now.
-
The config option for a custom API key is perhaps
- redundant. Should streamtuner2 -D however reveal an error, you
- can however configure your own account there.
+
Dirble.com is another radio station directory, based on
+ user-contributed entries and automatic streaming server polling.
+
+
Provides a JSON API, which in v2 is easy to extract from.
+
List contain even station homepages mostly.
+
And the channel plugin selects among the available
+ streaming URLs based on format (Ogg, AAC, preferred over MP3) and
+ maximum bitrate.
+
+
There's a hidden config option for a custom API key.
+ It's perhaps redundant. Should streamtuner2 -D however reveal an error,
+ you can however configure your own account in settings.json.
+
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).
-
-
-
Configuration option
-
-
You can set the default export format in the settings dialog
- F12.
-
It supports all common export formats now, with .PLS being the
- default.
Per default you'll get a small logo / icon for any station
with a homepage link. They're automatically fetched and displayed
as soon as you play a radio entry.
-
This functionality meanwhile resides in a plugin. It's available in the
-🔌 Featuresconfiguration tab.
-You can disable it as whole if unneeded. Most configuration options are now
-collected there.
Most configuration options are now collected there.
+
Some channels (Jamendo or Radionomy) provide small album previews
-or banners (Punkcast) even. Whereas normal favicons are just 16x16
-pixel images.
-
Downloaded image files are meanwhile all sanitized (internally
+or banners even. Whereas normal favicons are just 16x16 pixel images.
+
Downloaded image files are meanwhile all sanitized (internally
converted to ensure they're really image files).
Albeit that's not strictly necessary for modern Gtk versions. (But
better safe than sorry).
Images are kept in the ~/.config/streamtuner2/icons directory.
-
Filtermusic summarizes all the common genres, but is primarily
- 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.
+ focused on electro/dance/pop stations.
+
+
There's around a dozen categories with 20-30 radios each.
+
Prioritizes stations on listener popularity and freshness or something.
+
The plugin fetches a XML list of stations, or extracts from the homepage.
+
+
Most useful if you don't like to browse around, and want to
+ listen to most popular stations.
Configuration
Like the Xiph plugin this channel provides two/three fetch modes.
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 lists is comperatively fast.
+
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).
+ links to retrieve. Instead of stream numbers, it only counts pages.
+ Which however speeds up processing now.
Jamendo is a Creative Comments licensing oriented music distributor. It hosts audio
-files for individual musicians and artists. Tracks and albums can thus be downloaded
-free of charge. Yeah, imagine that.
-
The new Jamendo v3.0 is now utilized. It allows to list albums,
-playlists, and individual tracks by genre. The radio list is static
-(they're looping over randomized songs from each genre.)
-
Instead of favicons, streamtuner2 can fetch album or track
-covers. Thus the images are a bit larger, and retrieving them all
-via Channel ▸ Load favicons...
-takes a while longer.
+
Jamendo is a Creative Comments licensing oriented music distributor. It
+hosts audio files for individual musicians and artists. It allows to list
+albums, playlists, and individual tracks by genre.
+
+
The new Jamendo v3.0 is now utilized, which is JSON based and easy to extract.
+
Its radio list is static. It loops over randomized songs from each genre.
+
There's a custom JSON playlist extractor (JAMJSON), to avoid preloading stream URLs for feeds/albums. While tracks/genre lists contain direct streaming addresses already.
+
Instead of favicons, streamtuner2 can fetch slightly larger album or track covers.
+
+
Tracks and albums can be downloaded free of charge (Creative Commons). Yeah, imagine that.
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 📻 Channels or 🔌 Feature tabs, and
then enable them.
-
Updated plugins will not be automatically loaded if they
- were enable already. That requires either a restart, or disabling +
- saving once, then reenabling them.
Updated plugins will not be automatically loaded if they've
+ been active already. That requires either a restart. (Or disabling +
+ saving once, then reenabling them.)
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 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.
- Instead of favicons smaller station logos are displayed (25px
- in contrast to the usual 16px).
-
+founded in Belgium. It commands a pretty big slice of the worldwide
+internet radio stuff these days. - It took over Shoutcast.com for
+instance.
+
+
Its directory contains over 6000 stations already, all of them hosted by Radionomy directly.
+
This plugin uses a mixture of RegExp/DOM extraction, JSON reading, and simulated AJAX queries to fetch station lists.
+
Station logos are 25x25px large, and directly fetched from radionomy.com as well.
+
+
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.
Configuration
You can configure the number of pages it'll try (3 by
- default) to influence the length of station lists.
+ 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,
- and keep the station list auto-updated.
+ Future versions of this channel plugin might poll it automatically,
+ and keep the station list auto-updated.
Genres are subcategorized, so the main groups in the category
list must be expanded to see the interesting entries.
Since being sold from AOL to Radionomy, the directory got cut down. There are no longer
entries for currently played songs, and homepage links are largely gone. Hencewhy the
Index: help/html/somafm.html
==================================================================
--- help/html/somafm.html
+++ help/html/somafm.html
@@ -10,10 +10,24 @@
There's a manually curated list of radio stations in the
- UbuntuUsers.de Wiki. Like the origin website, most entries are
- German or European stations.
-
So this is more of an example plugin, as it's not a huge list
- of course. It's just here really, because the Wiki markup is
- pretty well-written and easy to parse.
+ UbuntuUsers.de Wiki.
+
+
Like the origin website, most entries are German or European stations.
+
So this is more of an example plugin, as it's not a huge list.
+
RegExp are used for extraction, because the Wiki markup is rather well-maintained and consistent.
+
There's also a small streaming TV list. But most entries
aren't really accessible (anymore) without command line tools.
(Which that very Wiki page covers in detail.)
Xiph.org is a non-profit organization, which maintains and
- promotes the OGG streaming format, and develops audio compression
- schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
- format. It also hosts a list of ICEcast streaming stations. ICEcast
- is their non-commercial pendant to the SHOUTcast server.
+
Xiph.org is a non-profit organization which develops and maintains
+various audio- and video-related standards.
+
+
For example the OGG streaming/multiplexing format.
+
Audio compression schemes like Vorbis, Speex, FLAC, Opus.
+
Video encoding formats like Theora, Tarkin, Dirac.
+
The ICEcast streaming server is an alternative to SHOUTcast.
+
And the more modern .xspf (and .jspf) playlist format, which is used by all channel entries.
+
There are different ways for streamtuner2 to retrieve the station
- lists available on dir.xiph.org. That's because this is a primary
- plugin, and fallback solutions therefore important. Each fetching
- mode has its own advantages and drawbacks though.
-
Xiph also uses the .xspf playlist format, instead of just the
- more ancient Shoutcast .pls stream links.
+lists available on dir.xiph.org. That's because this is a primary
+plugin, and fallback solutions therefore important. Each fetching
+mode has its own advantages and drawbacks though.
-
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).
-
Fetch mode
-
+
Channel fetch mode option
+
There are now three options to retrieve Xiph directory stations.
-
Cache JSON
There's a caching server specifically for streamtuner2. It fixes
- Xiphs quirky JSON API, and provides a simpler interface. It can't
- correct the invalid encodings however, which is why you see ????
- question marks a lot. This method does not reveal station homepages,
- but enables the channel/server search.
+ Xiphs quirky JSON API, and provides a simpler interface. It can't
+ correct the invalid encodings however, which is why you see ????
+ question marks a lot. This method does not reveal station homepages,
+ but enables the channel/server search.
Clunky YP.XML
The "yellow pages" YP.XML contains the full list of all known
- ICEcast streaming servers. It's however quite bulky and super slow
- to download. It furthermore clogs up a lot of memory, and requires
- manual searching (only cache search works). Which is why streamtuner2
- is trying hard to avoid it. It doesn't contain station homepages either.
-
+ ICEcast streaming servers. It's however quite bulky and super slow
+ to download. It furthermore clogs up a lot of memory, and requires
+ manual searching (only cache search works). Which is why streamtuner2
+ is trying hard to avoid it. It doesn't contain station homepages either.
+
It's only still an option, because it's likely to remain accessible
- after Xiph.org rewrites their directory service. (Which though is
- getting delayed since a few years already.)
- You can set the special "buffy" mode in your settings.json
- to keep the whole YP.XML in memory. Which avoids the
- slow station list download/unpacking.
-
+ after Xiph.org rewrites their directory service. (Which though is
+ getting delayed since a few years already.)
+ You can set the special "buffy" mode in your settings.json
+ to keep the whole YP.XML in memory. Which avoids the
+ slow station list download/unpacking.
+
Forbidden fruits
As new alternative, you can let ST2 directly scrape the station
- lists from dir.xiph.org (like it does for other channels). This is
- something which Xiph doesn't approve of. But the drawbacks of their
- alternative offerings are too severe and user-unfriendly; which is
- why there's this raw HTML extraction mode now.
+ lists from dir.xiph.org (like it does for other channels). This is
+ something which Xiph doesn't approve of. But the drawbacks of their
+ alternative offerings are too severe and user-unfriendly; which is
+ why there's this raw HTML extraction mode now.
The website listings contain full station homepages and a few
- more extras. In this mode we can even acceess the XSPF playlist
- formats directly. Both, the server search function, or browsing by
- audio/video format are supported.
+ more extras. In this mode we can even acceess the XSPF playlist
+ formats directly. Both, the server search function, or browsing by
+ audio/video format are supported.
A miximum of 100 entries get fetched in this mode however
- (which is 5 pages á 20 entries).
+ (which is 5 pages á 20 entries).
-
-
+
The filter by bitrate option is now a generic plugin.
You can programm play/recording events with the timer plugin. Simply select a station
and choose StationExtensionsAdd timer....
A small popup will ask for a data/time string. If you press OK the station