Index: channels/__init__.py
==================================================================
--- channels/__init__.py
+++ channels/__init__.py
@@ -44,11 +44,11 @@
# Only export plugin classes
__all__ = [
"GenericChannel", "ChannelPlugin", "use_rx",
"entity_decode", "strip_tags", "nl", "unhtml", "to_int"
]
-#__path__.insert(0, conf.plugin_dir)
+#__path__.insert(0, "plugins")#conf.plugin_dir)
# generic channel module ---------------------------------------
class GenericChannel(object):
Index: channels/pluginmanager2.py
==================================================================
--- channels/pluginmanager2.py
+++ channels/pluginmanager2.py
@@ -96,11 +96,11 @@
# Prepare some text
self.add_(uikit.label("\nInstall or update plugins", size=520, markup=1))
self.add_(uikit.label("You can update existing plugins, or install new contrib/ channels. User plugins reside in ~/.config/streamtuner2/plugins/ and can even be modified there (such as setting a custom # color: entry).\n", size=520, markup=1))
self.add_(self.button("Refresh", stock="gtk-refresh", cb=self.refresh), "Show available plugins from repository\nhttp://fossil.include-once.org/streamtuner2/")
- self.add_(gtk.image_new_from_stock("gtk-info", gtk.ICON_SIZE_LARGE_TOOLBAR), "While plugins are generally compatible across releases, newer versions may also require to update the streamtuner2 core setup.\n Please note that plugin installation is rather experimental. It still requires a restart of ST2 to activate them.")
+ self.add_(gtk.image_new_from_stock("gtk-info", gtk.ICON_SIZE_LARGE_TOOLBAR), "While plugins are generally compatible across releases, newer versions may also require to update the streamtuner2 core setup.")
for i in range(1,10):
self.add_(uikit.label(""))
# Append to vbox
ADDED help/channel_dirble.page
Index: help/channel_dirble.page
==================================================================
--- help/channel_dirble.page
+++ help/channel_dirble.page
@@ -0,0 +1,23 @@
+
+
+
+
+
+ Dirble.com
+
+
+ Dirble
+
+
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 configure your own account there.
+
ADDED help/channel_filtermusic.page
Index: help/channel_filtermusic.page
==================================================================
--- help/channel_filtermusic.page
+++ help/channel_filtermusic.page
@@ -0,0 +1,27 @@
+
+
+
+
+
+ Selection of the best radio stations
+
+
+ filtermusic.net
+
+
+
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.
+
+
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.
iCast is another huge collaborative radio station directory.
+ removed
-
Its support in Streamtuner2 is quite robust, as it provides a JSON API.
- It lacks in meta data information though (homepages, currently playing, listeners, etc.)
+
iCast was a collaborative (CC-BY-SA licensed entries) radio
+ station directory.
+
+
As of May 2015 it seems to be down. Which is why the channel
+ plugin got removed. It's still downloadable from contrib/ in the
+ project repository or per Plugin Manager.
Radionomy is an internet radio streaming provider, orginally
+ founded in Belgium. It "owns" a pretty 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 provides the servers for. It's over 6000
+ already. Both listening and station hosting are freegiven agreement
+ to autoplay advertisements, and a minimum quota of daily listeners).
+ It's thus still growing.
+
+
The extraction method in streamtuner2 uses a mix of RegExp,
+ DOM traversal, and JSON extraction, with some AJAX updating spiced
+ in. It follows the scheme of the website to fetch station lists.
+
+
+
+ config options
+
+
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.
SomaFM is a small radio station network. It provides its own
+ unique channels. Which streamtuner2 shows in a static list.
+
+
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.
+
ADDED help/channel_ubuntuusers.page
Index: help/channel_ubuntuusers.page
==================================================================
--- help/channel_ubuntuusers.page
+++ help/channel_ubuntuusers.page
@@ -0,0 +1,25 @@
+
+
+
+
+
+ Wiki list of radio stations
+
+
+ UbuntuUsers
+
+
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.
+
+
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 develops and promotes the OGG audio format.
- It also hosts a list of ICEcast streaming stations (ICEcast is the non-commercial pendant
- to the SHOUTcast server.)
+
Xiph.org is a non-profit organization, which develops and
+ promotes the OGG streaming format, and develops audio compression
+ schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
+ enve. It also hosts a list of ICEcast streaming stations. ICEcast
+ is their non-commercial pendant to the SHOUTcast server.
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).
@@ -31,8 +33,54 @@
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).
+
+ <code>Fetch mode</code>
+
There are now three options to retrieve Xiph directory stations.
+
+
+
+ <code>Cache JSON</code>
+
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.
+
+
+
+ <code>Clunky YP.XML</code>
+
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.
+
+
+
+
+ <code>Forbidden fruits</code>
+
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 like/encourage. 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.
+ And the server search function, or browsing by audio/video format is
+ supported.
+
MIME types are categorzied identifiers for file types. Audio/mpeg for example represents MP3 files,
- and audio/ogg means just OGG. And the player setting dialog simply associates an audio type with a
- playback application:
+
MIME types are categorzied identifiers for file types. Audio/mpeg for
+ example represents MP3 files, and audio/ogg means just OGG. And the player
+ setting dialog simply associates an audio type with a playback application:
Format
Application
audio/mpeg
audacious
audio/ogg
audacious
@@ -61,16 +61,19 @@
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).
+
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).
-
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.)
+
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.)
Recording Apps
@@ -154,29 +157,48 @@
the station title. The found URL is then used/kept as station homepage. (Btw, station titles
like www.mymusicstation.com are automatically mapped to homepage URLs already.)
+
+ Playlist
+
+ Reuse .m3u/.pls files
When converting online station playlists,
+ streamtuner2 creates temporary files like shoutcast.11539398391891.m3u for
+ your audio player. It'll keep those files around in /tmp/streamtuner2 until you quit.
+ That speeds up switching between and reconnecting to a previous station. It's in
+ particular necessary when you use ⏭ or ⏪ directly in your player.
+ For %pls references your player typically usues the online-only playlist
+ files anyway. If you disable this option, then converted pls/m3u/xspf files get
+ recreated repeatedly.
+
+
+ Forgo any playlist conversion
+
Per default all server playlists (be they .pls or .m3u, .xpsf) into whatever
+ format your player/recording apss are configured with (per default %pls).
+ Set this option to disable those placeholders from the Player tab, and avoid
+ streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio player gets passed
+ the literal server/playlist streaming address in any case. Note that this is only
+ a minor speedup, but may trip up some applications. A few channel sources even
+ don't provide standard stream URLs and playlist (Jamendo albums for example really
+ need pre-conversion; no audio player can deal with such custom JSON playlists).
+ In short: you don't normally want to enabled this, unless you run into problems
+ with streamtuner2 taking too long, or accidentially hangs due to downloading streams
+ itself.
+
+
+
System
- Temporary files
-
Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files
- instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory
- for this. In recent versions streamtuner2 will create a /tmp/streamtuner2 directory
- for itself. (You cannot set just `/tmp` anymore, because that will be mapped to the longer name.
- You can trick the old behaviour with `/tmp/.` however. Don't do that unless you have a reason).
-
-
- Reuse .m3u/.pls files
-
When converting online station playlists, streamtuner2 creates temporary files like
- shoutcast.11539398391891.m3u for your audio player. It'll keep those
- files around until you quit streamtuner2. That speeds up switching between and reconnecting to
- a previous station. It's in particular necessary when you use ⏭ or ⏪
- directly in your player. For %pls references your player typically usues the online-only
- playlist files anyway. If you disable this option, then converted pls/m3u/xspf files get recreated
- repeatedly.
+ Temporary files
Streamtuner2 creates temporary .m3u files - for audio
+ players that are configured to use %m3u files instead of %pls or %srv URLs. For
+ archival purposes you might want to set a dedicated directory for this. In recent
+ versions streamtuner2 will create a /tmp/streamtuner2 directory for itself.
+ (You cannot set just `/tmp` anymore, because that will be mapped to the longer name.
+ You can trick the old behaviour with `/tmp/.` however. Don't do that unless you have a
+ reason).
Config directory
Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc.
You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME
@@ -187,22 +209,19 @@
If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
and processing or debug infos. Enable this only for testing, as it might slow down station
rendering.
- Disable threading
-
Now "threading" is a somewhat technical term. It means that an
- application runs different tasks internally at the same time. It's
- used for snappier interfaces. However, it's also difficult to get
- right at times. In Streamtuner2 some concurrent tasks conflict with
- updating the Gtk3 user interface. Which is why the application may
- crash even on reloading station lists or when switching between
- categories too quickly. This is only an issue for Python3 on Gtk3 with
- streamtuner2. In such cases you can disable the concurrent-tasking
- mode. The GUI will appear slower at times, and freeze between fetching
- lists, but remains stable on the upside. There's also a command line
- flag --nt to enable this workaround.
+ Disable threading
Now "threading" is a somewhat technical term. It
+ means that an application runs different tasks internally at the same time. It's used
+ for snappier interfaces. However, it's also difficult to get right at times. In
+ Streamtuner2 some concurrent tasks conflict with updating the Gtk3 user interface.
+ Which is why the application may crash even on reloading station lists or when switching
+ between categories too quickly. This is only an issue for Python3 on Gtk3 with
+ streamtuner2. In such cases you can disable the concurrent-tasking mode. The GUI will
+ appear slower at times, and freeze between fetching lists, but remains stable on the
+ upside. There's also a command line flag --nt to enable this workaround.
MIME types are categorzied identifiers for file types. Audio/mpeg for example represents MP3 files,
- and audio/ogg means just OGG. And the player setting dialog simply associates an audio type with a
- playback application:
+
MIME types are categorzied identifiers for file types. Audio/mpeg for
+ example represents MP3 files, and audio/ogg means just OGG. And the player
+ setting dialog simply associates an audio type with a playback application:
Format
Application
@@ -68,15 +68,18 @@
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).
-
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.)
+
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.)
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. (Btw, station titles
like www.mymusicstation.com are automatically mapped to homepage URLs already.)
+
+
+
Playlist
+
+
Reuse .m3u/.pls files
+
When converting online station playlists,
+ streamtuner2 creates temporary files like shoutcast.11539398391891.m3u for
+ your audio player. It'll keep those files around in /tmp/streamtuner2 until you quit.
+ That speeds up switching between and reconnecting to a previous station. It's in
+ particular necessary when you use ⏭ or ⏪ directly in your player.
+ For %pls references your player typically usues the online-only playlist
+ files anyway. If you disable this option, then converted pls/m3u/xspf files get
+ recreated repeatedly.
+
Forgo any playlist conversion
+
Per default all server playlists (be they .pls or .m3u, .xpsf) into whatever
+ format your player/recording apss are configured with (per default %pls).
+ Set this option to disable those placeholders from the Player tab, and avoid
+ streamtuner2 pre-downloading any m3u/pls/xspf. Instead your audio player gets passed
+ the literal server/playlist streaming address in any case. Note that this is only
+ a minor speedup, but may trip up some applications. A few channel sources even
+ don't provide standard stream URLs and playlist (Jamendo albums for example really
+ need pre-conversion; no audio player can deal with such custom JSON playlists).
+ In short: you don't normally want to enabled this, unless you run into problems
+ with streamtuner2 taking too long, or accidentially hangs due to downloading streams
+ itself.
+
System
Temporary files
-
Streamtuner2 creates temporary .m3u files - for audio players that are configured to use %m3u files
- instead of %pls or %srv URLs. For archival purposes you might want to set a dedicated directory
- for this. In recent versions streamtuner2 will create a /tmp/streamtuner2 directory
- for itself. (You cannot set just `/tmp` anymore, because that will be mapped to the longer name.
- You can trick the old behaviour with `/tmp/.` however. Don't do that unless you have a reason).
-
Reuse .m3u/.pls files
-
When converting online station playlists, streamtuner2 creates temporary files like
- shoutcast.11539398391891.m3u for your audio player. It'll keep those
- files around until you quit streamtuner2. That speeds up switching between and reconnecting to
- a previous station. It's in particular necessary when you use ⏭ or ⏪
- directly in your player. For %pls references your player typically usues the online-only
- playlist files anyway. If you disable this option, then converted pls/m3u/xspf files get recreated
- repeatedly.
+
Streamtuner2 creates temporary .m3u files - for audio
+ players that are configured to use %m3u files instead of %pls or %srv URLs. For
+ archival purposes you might want to set a dedicated directory for this. In recent
+ versions streamtuner2 will create a /tmp/streamtuner2 directory for itself.
+ (You cannot set just `/tmp` anymore, because that will be mapped to the longer name.
+ You can trick the old behaviour with `/tmp/.` however. Don't do that unless you have a
+ reason).
Config directory
Is where streamtuner2 keeps its settings.json and channel caches, favicons, etc.
You can't set this in the config dialog. This is just for display. Set the XDG_CONFIG_HOME
environment variable to adapt.
Enable debug messages
If you start streamtuner2 from a terminal window (xterm/rxvt), you can get a load of state
and processing or debug infos. Enable this only for testing, as it might slow down station
rendering.
Disable threading
-
Now "threading" is a somewhat technical term. It means that an
- application runs different tasks internally at the same time. It's
- used for snappier interfaces. However, it's also difficult to get
- right at times. In Streamtuner2 some concurrent tasks conflict with
- updating the Gtk3 user interface. Which is why the application may
- crash even on reloading station lists or when switching between
- categories too quickly. This is only an issue for Python3 on Gtk3 with
- streamtuner2. In such cases you can disable the concurrent-tasking
- mode. The GUI will appear slower at times, and freeze between fetching
- lists, but remains stable on the upside. There's also a command line
- flag --nt to enable this workaround.
+
Now "threading" is a somewhat technical term. It
+ means that an application runs different tasks internally at the same time. It's used
+ for snappier interfaces. However, it's also difficult to get right at times. In
+ Streamtuner2 some concurrent tasks conflict with updating the Gtk3 user interface.
+ Which is why the application may crash even on reloading station lists or when switching
+ between categories too quickly. This is only an issue for Python3 on Gtk3 with
+ streamtuner2. In such cases you can disable the concurrent-tasking mode. The GUI will
+ appear slower at times, and freeze between fetching lists, but remains stable on the
+ upside. There's also a command line flag --nt to enable this workaround.
iCast is another huge collaborative radio station directory.
-
Its support in Streamtuner2 is quite robust, as it provides a JSON API.
- It lacks in meta data information though (homepages, currently playing, listeners, etc.)
+
iCast was a collaborative (CC-BY-SA licensed entries) radio
+ station directory.
+
As of May 2015 it seems to be down. Which is why the channel
+ plugin got removed. It's still downloadable from contrib/ in the
+ project repository or per Plugin Manager.
MyOggRadio is an open
- source internet radio directory project. Since it provides its station list as
- JSON it's very well supported.
-
To help with populating the directory further,
- streamtuner2 provides an option to share radion station links.
- Use Station ▸ Extensions ▸ Share on MyOggRadio... menu entry to upload the currently
- selected radio (e.g. from your favourite bookmarks).
+source internet radio directory project.
+
Since it provides its station list as JSON it's very well supported.
+
+
+
Sharing is caring
+
To help with populating the directory further,
+ streamtuner2 provides an option to share radion station links.
+ Use the Station ▸ Share on MyOggRadio...
+ context menu entry to upload a selected radio (e.g. from your bookmarks).
+
+
+
Personal
+
The personal section is empty per default. You need to specify an user account
- in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
- Shared entries aren't automatically in the personal list.
+ in the settings dialog, and actually bookmark stations in the MyOggRadio web site.
+ Shared entries aren't automatically in the personal list.
MyOggRadio also has a neat cross-platform player:
- JMyOggRadioPlayer.
If you want to upload station infos to MyOggRadio, you need an account there.
Registration is free and doesn't require personal information nor email address.
- Specify it as username: separated with a : colon in this field.
+ Specify it as username:password separated with a : colon in this field.
Alternatively you can store your account settings in the central
- ~/.netrc config file. Or in ~/.config/netc even.
+ ~/.netrc config file. Or in ~/.config/netrc even.
Your entry for MyOggRadio should follow the common format:
Which is useful because it's a standard format, and prevents
leaking authorization data into per-application config stores.
- Note that a user:pw setting in streamtuner takes precedence
- though.
+ Note that a user:pw setting in streamtuner still takes precedence
+ however.
stream URL format
-
When uploading stations, the streaming URL can be converted into RAW format. You
- can however leave it as .PLS link file.
-
+
When uploading stations, the streaming URL can be converted into
+ raw/direct server address. When undefined, station URLs are left as
+ .M3U/.PLS link.
+
-
More Information
Index: help/html/timer.html
==================================================================
--- help/html/timer.html
+++ help/html/timer.html
@@ -20,20 +20,24 @@
Technical information » Additional features »
Timer
-
+
+
+
+
You can programm play/recording events with the timer plugin. Simply select a station
and choose Station ▸ Extensions ▸ Add timer....
A small popup will ask for a data/time string. If you press OK the station
and the programmed time will be stored in the bookmarks channel in the "timer" category.
-
+
Note that streamtuner2 must be running for the programmed timer events to work.
(In a future version there might be the option to have it handled by the system cron
daemon.)
-
+
+
Time specification strings
The time and date specificators follow a simple scheme. It's always one or more day names
followed by a clock range, and finally the action.
Xiph.org is a non-profit organization, which develops and promotes the OGG audio format.
- It also hosts a list of ICEcast streaming stations (ICEcast is the non-commercial pendant
- to the SHOUTcast server.)
+
Xiph.org is a non-profit organization, which develops and
+ promotes the OGG streaming format, and develops audio compression
+ schemes such as Vorbis, FLAC, Opus, or the Theora video encoding
+ enve. It also hosts a list of ICEcast streaming stations. ICEcast
+ is their non-commercial pendant to the SHOUTcast server.
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
@@ -33,10 +35,53 @@
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
+
+
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 like/encourage. 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.
+ And the server search function, or browsing by audio/video format is
+ supported.
+
You can get additional help from the online forum. See HelpForum.
This documentation was last updated for available functions in streamtuner2
- version 2.1.7, as of April 2015.
+ version 2.1.8, as of May 2015.
Index: help/introduction.page
==================================================================
--- help/introduction.page
+++ help/introduction.page
@@ -34,12 +34,12 @@
or access the context menu with a right click.
Play
Starts the radio in a configured audio player
Record
Opens a terminal window and streamripper, which cuts the radio broadcast into individual mp3 songs.
Bookmarks
Copy radio entry over into the bookmarks channel.
-
Homepage
Most radio stations have a homepage. Open this in a web browser.
-
Saving
A radio entry can be exported as .m3u or .pls file.
+
Homepage
Most radio stations have a homepage, which you can start a web browser for.
+
Saving
A radio entry can be exported as .pls, .xspf, .m3u, .desktop, or .json file.
Extensions
Some plugins add other features in this submenu.
Editing
This command is in the Edit and context menu, allows to inspect and modify radio descriptions.
Searching
You can get a radio list according to search criteria.
Play, Record and Homepage also have buttons in the toolbar.
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.
+
+
Install dialog for user plugins
+
+
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.
+
+
+ Configuration
+
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.
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
and the programmed time will be stored in the bookmarks channel in the "timer" category.
- Timer
+
Timer
Note that streamtuner2 must be running for the programmed timer events to work.
(In a future version there might be the option to have it handled by the system cron
daemon.)
-
+Time specification strings
The time and date specificators follow a simple scheme. It's always one or more day names
followed by a clock range, and finally the action.
