Index: help/action_edit.page
==================================================================
--- help/action_edit.page
+++ help/action_edit.page
@@ -6,10 +6,11 @@
Edit or inspect a station entry.
+ Edit
You probably won't need this often. But there's an
Edit/Details context menu
which brings up a station editor:
@@ -28,8 +29,9 @@
new to add new entries this way.
(Which doesn't make sense in regular channel categories, because
changes will be lost once you hit Reload). A proper "Add station..."
dialog is planned though.
+
Index: help/action_homepage.page
==================================================================
--- help/action_homepage.page
+++ help/action_homepage.page
@@ -6,22 +6,24 @@
Start a web browser for a station.
+ Radio homepages
Most radio stations are listed with a homepage URL. Use the house symbol in the
toolbar or right clickhomepage to open it in a web browser.
Some homepage links are guessed, because some channels (e.g. Shoutcast) don't provide them (anymore).
If you play a station without homepage URL, it automatically gets googled. (The link will be visible
once you reselect the genre/category.)
+ Channel homepages
You can also visit channel homepages (Shoutcast.com, Xiph.org, etc).
Either from the Channel menu, or via double clicking the channel tab.
Index: help/action_playing.page
==================================================================
--- help/action_playing.page
+++ help/action_playing.page
@@ -7,10 +7,11 @@
Double click a station to start it in your audio player.
+ Playing
To start playing a station, you can:
@@ -30,8 +31,9 @@
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. Nowadays you can often configure the same player
for all audio (and even video) types.
+
Index: help/action_recording.page
==================================================================
--- help/action_recording.page
+++ help/action_recording.page
@@ -7,18 +7,20 @@
Save radio songs as MP3 files via streamripper.
+Recording
Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool streamripper. If you
select a station and press ● record, a console
window should appear, where streamripper shows its progress.
You can configure the recording tool according to audio types again.
+Streamripper
There's already a default entry for recording radio stations:
Index: help/action_saving.page
==================================================================
--- help/action_saving.page
+++ help/action_saving.page
@@ -6,10 +6,11 @@
Export a station entry as .m3u/.pls file.
+ Saving
You can export the currently selected stream using
StationSave or by pressing
F2. A file dialog opens, where you can adapt the title.
@@ -21,8 +22,9 @@
You can also save in .pls or .xspf
or .asx or .smil format. In current
releases the file extension is automatically adapted when changing
the filter dropdown (bottom right corner in the file dialog).
Streamtuner2 allows to bookmark favourite streams/stations.
@@ -22,10 +23,11 @@
Once bookmarked the station is listed under bookmarksfavourite.
Additionally every appearance of the station in other channel
tabs gets a ★ star icon.
+ Editing
Entries can be removed from the bookmark list again. Use
EditDelete or the DEL
Index: help/channel_dirble.page
==================================================================
--- help/channel_dirble.page
+++ help/channel_dirble.page
@@ -6,10 +6,11 @@
Dirble.com
+ Dirble//dirble.com/
Dirble.com is another radio station directory, based on
user-contributed entries and automatic streaming server polling.
@@ -19,13 +20,14 @@
Station lists 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.
+
- Station status indicators
+ Station status indicators
For the dirble plugin each station entry may contain a stream
status icon. They often just represent a heuristic check or general
reachability statistic. You can usually start playback without
paying attention to the status icons:
Index: help/channel_filtermusic.page
==================================================================
--- help/channel_filtermusic.page
+++ help/channel_filtermusic.page
@@ -7,10 +7,11 @@
Selection of the best radio stations
+ filtermusic//filtermusic.net/
Filtermusic summarizes all the common genres, but is primarily
focused on electro/dance/pop stations.
@@ -21,10 +22,11 @@
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.
Index: help/channel_internetradioorguk.page
==================================================================
--- help/channel_internetradioorguk.page
+++ help/channel_internetradioorguk.page
@@ -7,10 +7,11 @@
Large radio directory from the UK.
+ Internet-Radio//internet-radio.com/
Internet-Radio.com is a broad alternative to Shoutcast.
@@ -18,14 +19,15 @@
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.
Index: help/channel_jamendo.page
==================================================================
--- help/channel_jamendo.page
+++ help/channel_jamendo.page
@@ -7,10 +7,11 @@
Creative Commons music and artist hub.
+Jamendo//jamendo.com/
Jamendo is a Creative Comments licensing oriented music distributor. It
hosts audio files for individual musicians and artists. It allows to list
@@ -22,10 +23,11 @@
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.
MODArchive is a collection of module/tracker files. It's a community project, and
categorizes individual audio files. You'll need a MOD-capable audio player.
@@ -19,11 +20,12 @@
MikMod
MODPlug for XMMS
GModplay
VLC (built-in support)
-
+
+
Configuration
See recording configuration if you
want to enable the download mode.
MyOggRadio is an open
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.
Index: help/channel_radiobrowser.page
==================================================================
--- help/channel_radiobrowser.page
+++ help/channel_radiobrowser.page
@@ -7,10 +7,11 @@
Community-driven streaming directory
+Radio-Browser//radio-browser.info/
Radio-Browser is an ambitious community project. It collects as many
public internet radio stations as possible. It's free to use, has a well
@@ -29,10 +30,11 @@
Since v0.3 / streamtuner2.2.0 you can now also share your favorite
stations directly. There's a new context menuShare in
Radio-Browser.
+Configuration
Instead of browsing by genres, you can switch to languages or
Index: help/channel_radionomy.page
==================================================================
--- help/channel_radionomy.page
+++ help/channel_radionomy.page
@@ -7,10 +7,11 @@
Large internet streaming provider
+Radionomy//radionomy.com/
Radionomy is an internet radio streaming provider, orginally
founded in Belgium. It commands a pretty big slice of the worldwide
@@ -24,10 +25,11 @@
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
Index: help/channel_shoutcast.page
==================================================================
--- help/channel_shoutcast.page
+++ help/channel_shoutcast.page
@@ -6,10 +6,11 @@
Probably still the largest radio station list.
+ Shoutcast//shoutcast.com/
SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
station lists on shoutcast.com.
@@ -23,8 +24,9 @@
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
Shoutcast channel is no longer considered a primary feature.
+
Index: help/channel_somafm.page
==================================================================
--- help/channel_somafm.page
+++ help/channel_somafm.page
@@ -7,18 +7,20 @@
Set of radio stations
+ SomaFM//somafm.com/
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
Index: help/channel_surfmusik.page
==================================================================
--- help/channel_surfmusik.page
+++ help/channel_surfmusik.page
@@ -7,10 +7,11 @@
International radio listings.
+ SurfMusic//surfmusic.de/
SurfMusic is a user-collection of
internet radios. It's grouped by genres, or locations / countries.
@@ -21,10 +22,11 @@
This channel plugin uses raw RegExp extraction.
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.
Index: help/channel_tunein.page
==================================================================
--- help/channel_tunein.page
+++ help/channel_tunein.page
@@ -7,16 +7,18 @@
Radio and Podcast directory.
+ TuneIn//tunein.com/
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".
Index: help/channel_ubuntuusers.page
==================================================================
--- help/channel_ubuntuusers.page
+++ help/channel_ubuntuusers.page
@@ -6,10 +6,11 @@
Wiki list of radio stations
+ UbuntuUsers//ubuntuusers.de/
There's a manually curated list of radio stations in the
UbuntuUsers.de Wiki.
@@ -21,7 +22,8 @@
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 maintains
various audio- and video-related standards.
@@ -25,10 +26,11 @@
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.
Googles Youtube provides a quirky JSON API that makes browsing
channels and genres feasible. This beta plugin provides a little
@@ -25,10 +26,11 @@
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.
Index: help/channels.page
==================================================================
--- help/channels.page
+++ help/channels.page
@@ -5,10 +5,11 @@
Switching through the channel tabs, different radio directory services.
+ Channels
The tabs in the main window represent the music directory
channels/services. Each lists categories/genres and their associated radios/streams.
@@ -29,10 +30,11 @@
Individual channels provide different music/radio information. The table
views are however mostly identical for each tab. Some views may rename columns,
or remove them alltogether.
Streamtuner2 is a graphical tool. But it also has a limited commandline interface,
which can be used to query station information. This is useful for interfacing with
other applications.
@@ -45,10 +46,11 @@
Specifying a channel name is often optional. If you add one, it should be all-lowercase.
You can also give a list, like "shoutcast,xiph" which would be searched then.
+ GUI options
There are also a few command line flags, which influence the
graphical runtime.
Index: help/config_apps.page
==================================================================
--- help/config_apps.page
+++ help/config_apps.page
@@ -6,10 +6,11 @@
Common applications to use as players.
+ Audio players
On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
configure most of them as target application. Mostly it makes sense to use a single
application for all audio formats. But at least the */* media type should be handled
@@ -37,10 +38,11 @@
works better. (And sometimes not.)
Some applications, like Rhythmbox or Banshee, are primarily playlist managers, not players,
and cannot be invoked with a station URL. This makes them less suitable for use with streamtuner2.
(Same goes for streamtuner2 itself. It's not a player, but just a playlist browser.)
+ URL placeholders
Listed audio players get run with a streaming server address (URL).
Index: help/configuration.page
==================================================================
--- help/configuration.page
+++ help/configuration.page
@@ -7,10 +7,11 @@
F12 brings up the options window with the Player, Display, System and Plugin sections.
+Configuration / Settings dialog
There are various options for streamtuner2, available under EditPreferences or via F12.
@@ -18,35 +19,35 @@
It's grouped into:
- 🔊 Player
+ 🔊 Player
Associates media formats to audio player applications or recording tools.
- ☑ Options
+ ☑ Options
Influences the display of all stream/station lists, and contains some
behaviour and system settings.
- 📻 Channel Plugins
+ 📻 Channel Plugins
Allows to enable or disable channel tabs. Each can have specific
options, which can be configured here.
- 🔌 Feature Plugins
+ 🔌 Feature Plugins
Another class of plugins enables internal functions, or adds extra menu
entries, or further configuration options.
- 📦 Add
+ 📦 Add
The Plugin Manager 2 adds another
tab for updating or installing new plugins.
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.
-
- 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.
@@ -46,15 +38,19 @@
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.
+ page requests. Works reliably still.
ListenLive.eu
-
ListenLive is also an Europe-centric radio directory.
+
ListenLive is also an Europe-centric radio directory.
+
+
+ Liveradio.ie
+
Is an Ireland-based radio station directory.
RadioSure
Station database that's readily available as CSV list. You'll
currently need the tmp_clean_multiurl plugin as well, as most entries
@@ -109,6 +105,7 @@
See also the list of
available
plugins in the project wiki.
Extra functionality and behaviour changes are available in
the 🔌 Feature configuration
section.
+Filter Bitrate
Some channels provide lower-quality audio streams. In particular
Index: help/global_key.page
==================================================================
--- help/global_key.page
+++ help/global_key.page
@@ -5,10 +5,11 @@
Global keyboard shortcut for radio switching.
+Global_key
Using the global_key extension you can define a keyboard shortcut for switching within
a list of favourited radio stations. Per default it uses your bookmarks list, but it can be
configured to alternate in any other channel.
@@ -33,6 +34,8 @@
If the configured keyboard shortcut conflicts
with another application, it won't work. And if you choose it too
generic, you won't be able to type longer documents. Also found
out: key names are case sensitive.
Streamtuner2 allows to bookmark favourite streams/stations.
Use right click for a stations context menu ▸ bookmark
Or just press F8 on a selected radio.
Else use the main menu Station ▸ bookmark
Once bookmarked the station is listed under bookmarks ▸ favourite.
Additionally every appearance of the station in other channel
tabs gets a ★ star icon.
-
+
+
Editing
Entries can be removed from the bookmark list again. Use
Edit ▸ Delete or the DEL
Index: help/html/channels.html
==================================================================
--- help/html/channels.html
+++ help/html/channels.html
@@ -1,20 +1,23 @@
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 ▸ Top.
@@ -28,31 +31,33 @@
Pick a category/genre from the overview, left.
Individual channels provide different music/radio information. The table
views are however mostly identical for each tab. Some views may rename columns,
or remove them alltogether.
You can dobule click the channel tab to visit the channel/directory homepage.
Index: help/html/cli.html
==================================================================
--- help/html/cli.html
+++ help/html/cli.html
@@ -1,27 +1,30 @@
Streamtuner2 is a graphical tool. But it also has a limited commandline interface,
which can be used to query station information. This is useful for interfacing with
other applications.
Open a terminal and call streamtuner2 help to get an overview over
available commands.
-
Examples
+
Examples
streamtuner2 play "station"
This command looks through all channel plugins, and finds a station containing the
mentioned title. You must put the station title in quotes in shell calls, if it contains
e.g. spaces. You can optionally specify a channelname before the station title.
@@ -37,11 +40,12 @@
Fetches the current list of available categories/genres for a channel service.
Specifying a channel name is often optional. If you add one, it should be all-lowercase.
You can also give a list, like "shoutcast,xiph" which would be searched then.
-
+
+
GUI options
There are also a few command line flags, which influence the
graphical runtime.
On BSD/Linux systems there are a plethora of audio players. In streamtuner2 you can
- configure most of them as target application. Mostly it makes sense to use a single
+ configure most of them as target application. Mostly it makes sense to use a single
application for all audio formats. But at least the */* media type should be handled
by a generic player, like vlc.
A few common applications and invocation strings to use are:
@@ -67,11 +70,12 @@
For VLC there's however also the --one-instance option, which sometimes
works better. (And sometimes not.)
Some applications, like Rhythmbox or Banshee, are primarily playlist managers, not players,
and cannot be invoked with a station URL. This makes them less suitable for use with streamtuner2.
(Same goes for streamtuner2 itself. It's not a player, but just a playlist browser.)
-
+
+
URL placeholders
Listed audio players get run with a streaming server address (URL).
These can either be direct MP3/Ogg servers (http://example.org:7843/)
Index: help/html/configuration.html
==================================================================
--- help/html/configuration.html
+++ help/html/configuration.html
@@ -1,44 +1,53 @@
The Plugin Manager 2 adds another
tab for updating or installing new plugins.
-
+
+
Player application settings
MIME types are abstract identifiers for media types. Audio/mpeg for
example represents MP3 files, and audio/ogg means OGG Vorbis. And the player
@@ -82,14 +91,11 @@
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.)
To define a target directory, you can often add commandline arguments to each. Also it's typically
helpful to leave the xterm prefix on, so you can follow the processing state.
@@ -218,47 +224,47 @@
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.
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
+ 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.
Besides the standard channels, there are a few more plugins available
-for download. See the Plugin Manager
+for download. See the Plugin Manager
and its 📦 Add tab.
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.
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.
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.
Extra functionality and behaviour changes are available in
-the 🔌 Featureconfiguration
-section.
+
+
+
→ Feature plugins
+
Extra functionality and behaviour changes are available in
+the 🔌 Featureconfiguration
+section.
+
Filter Bitrate
Some channels provide lower-quality audio streams. In particular
Xiph lists some awful radio stations. And this plugin helps filtering
@@ -84,24 +88,24 @@
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.
Station lists 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.
-
+
+
-
Station status indicators
+
Station status indicators
For the dirble plugin each station entry may contain a stream
status icon. They often just represent a heuristic check or general
reachability statistic. You can usually start playback without
paying attention to the status icons:
You probably won't need this often. But there's an
▸ Edit/Details context menu
which brings up a station editor:
@@ -30,11 +33,12 @@
It allows to shorten or rename things. You can even use
new to add new entries this way.
(Which doesn't make sense in regular channel categories, because
changes will be lost once you hit Reload). A proper "Add station..."
dialog is planned though.
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.
Using the global_key extension you can define a keyboard shortcut for switching within
a list of favourited radio stations. Per default it uses your bookmarks list, but it can be
configured to alternate in any other channel.
This is useful if you don't want to keep streamtuner2 atop your
desktop all the time, but still want to switch radios easily.
@@ -53,11 +56,12 @@
add a category separated by : colon here.
If the configured keyboard shortcut conflicts
with another application, it won't work. And if you choose it too
generic, you won't be able to type longer documents. Also found
out: key names are case sensitive.
Most radio stations are listed with a homepage URL. Use the house symbol in the
toolbar or right click ▸ homepage to open it in a web browser.
Some homepage links are guessed, because some channels (e.g. Shoutcast) don't provide them (anymore).
If you play a station without homepage URL, it automatically gets googled. (The link will be visible
once you reselect the genre/category.)
-
+
+
Channel homepages
You can also visit channel homepages (Shoutcast.com, Xiph.org, etc).
Either from the Channel menu, or via double clicking the channel tab.
-Audio players — Common applications to use as players.
+ — Common applications to use as players.
-Streams / Stations — Radio streams lists, station information columns, entry actions.
+ — Radio streams lists, station information columns, entry actions.
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.
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. The category/genre lists are in the left pane, and associated stations right
to them.
-
+
+
How to select and play a radio.
Select a channel tab, like Shoutcast.
@@ -39,19 +43,19 @@
Double clicking an entry row in the radio list starts your audio player. But there are
other functions available. Either go to the ▸ Station menu,
or access the context menu with a right click.
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.
@@ -30,13 +33,14 @@
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 switch between MP3 and Ogg Vorbis audio streams for Jamendo.
Index: help/html/json.html
==================================================================
--- help/html/json.html
+++ help/html/json.html
@@ -6,11 +6,11 @@
JSON is a data representation format derived from Javascript (the browser embedded
Index: help/html/m3u.html
==================================================================
--- help/html/m3u.html
+++ help/html/m3u.html
@@ -6,11 +6,11 @@
MODArchive is a collection of module/tracker files. It's a community project, and
categorizes individual audio files. You'll need a MOD-capable audio player.
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 is an open
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...
Index: help/html/playing.html
==================================================================
--- help/html/playing.html
+++ help/html/playing.html
@@ -1,40 +1,44 @@
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
+ formats (MP3 or OGG). In the Apps section of the
+ settings dialog, you can associate one player
with each audio file (MIME) type. Nowadays you can often configure the same player
for all audio (and even video) types.
For updating or installing new plugins (extra channels or
features), there's a user plugin manager. It's available as
feature extension itself.
See the F12 config dialog 🔌 Feature section.
@@ -30,16 +37,12 @@
regular 📻 Channels or 🔌 Feature tabs, and
then enable them.
Updated plugin versions won't be instantiated right away
if they've been active already. That requires either a restart.
Or disabling + saving once, then reenabling them.
Alternative download repositories may be configured. (Little
practical value at the moment.)
@@ -55,11 +58,11 @@
menu extensions or undefine callback hooks.
-
+
User plugins
Downloaded plugins are stored in ~/.config/streamtuner2/plugins.
To remove them, delete the individual *.py files there manually. But
keep the __init__.py stub.
Radio-Browser is an ambitious community project. It collects as many
public internet radio stations as possible. It's free to use, has a well
documented API, with a simple JSON interface.
It's now the backend in many open source music players:
@@ -36,11 +39,12 @@
Kodi/XBMC
Since v0.3 / streamtuner2.2.0 you can now also share your favorite
stations directly. There's a new context menu ▸ Share in
Radio-Browser.
-
+
+
Configuration
Instead of browsing by genres, you can switch to languages or
countries.
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.
@@ -32,11 +35,12 @@
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.
Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool streamripper. If you
select a station and press ● record, a console
window should appear, where streamripper shows its progress.
Reddit (AKA "the frontpage of the internet") is a social media website.
+Among its various sections is a large group of music subreddits.
+Most of them link popular or novel Youtube music/videos, or user-produced
+content etc.
+
+
Around 620 subreddits are queried. That's just a selected part
+ though. Most others do not see as many audio posts / or are just for
+ discussion and news.
+
Besides youtube/mp3 files, this channel may also
+ list Soundcloud/Mixcloud/Bandcamp links.
+
Radioreddit.com
+ even provides streaming servers. Its categories are: main, random,
+ rock, metal, indie, electronic, hiphop, talk, festival.
+
Thumbnails are slightly larger (32x26) than regular favicons.
+
All entries also show poster name and user votes.
+
+
See the config options if you want to keep regular webpage posts - instead
+of just showing playable content.
+
+
+
+
Status icons
+
+
Channel entries contain a custom status icon leftmost (to the genre).
+It's quick indicator of what type of content is linked:
Just a web-link. Those are kept with the ☒ keep all option.
+
+
+
+
+
Configuration
+
+
There's a few options for the reddit plugin:
+
+
Number of pages to fetch
+
Influences how many JSON requests are made to assemble a list of
+ subreddit posts with playable content.
+
Filter walled gardens
+
+
Many music posts on reddit meanwhile point to one of Soundcloud,
+ Spotify, Bandcamp, Mixcloud. Those are basically just links you had
+ open in your browser. --
+ Now those are labeled "walled gardens" here, because they're hording
+ user content behind a paywall/registration-wall, fiddly NIH APIs,
+ non-standard audio formats, web-only players and sessioning.
+
There's a few players or tools for those better-known hosters. But
+ smaller services fall under the radar. Which is why I think it's unfair
+ to provide out-of-the-box support for just those four services.
+ -- But anyway, you can disable filtering them, if you like. And then
+ configure a custom player:
Obviously you want to pipe youtube-dl to an actual audio player
+ again. VLC also supports a few services directly or via plugins.
+
+
Keep all web links
+
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.
+
+
To utilize Soundcloud links, there's an extra url_soundcloud plugin.
+ It overrides the audio/soundcloud player config, and
+ resolves such streams to MP3 urls (session typically times out
+ quickly, so no bookmarking/export possible etc).
Station information can get stale. Especially Shoutcast invalidates old information
Index: help/html/saving.html
==================================================================
--- help/html/saving.html
+++ help/html/saving.html
@@ -1,24 +1,27 @@
You can export the currently selected stream using
Station ▸ Save or by pressing
F2. A file dialog opens, where you can adapt the title.
The extension of the filename decides on the saved link format. Per
@@ -26,11 +29,12 @@
understand.
You can also save in .pls or .xspf
or .asx or .smil format. In current
releases the file extension is automatically adapted when changing
the filter dropdown (bottom right corner in the file dialog).
SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
station lists on shoutcast.com.
Station entries usually provide current playing information.
@@ -30,11 +33,12 @@
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
Shoutcast channel is no longer considered a primary feature.
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
Index: help/html/specbuttons.html
==================================================================
--- help/html/specbuttons.html
+++ help/html/specbuttons.html
@@ -5,18 +5,12 @@
Radio stations are listed in the right pane. Usually they have a title and a
description. The description is often the last played song. (This isn't updated
automatically to conserve bandwidth and because live information is seldomly available.)
You can double click a station line to get it to play. Alternatively there are the
play and record buttons in the menubar. You can also invoke a stations homepage, if it
has one.
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.
Pretty much all entries already contain station homepages.
This channel plugin uses raw RegExp extraction.
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
Index: help/html/technical.html
==================================================================
--- help/html/technical.html
+++ help/html/technical.html
@@ -6,11 +6,11 @@
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.
+ 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
Index: help/html/ubuntuusersm.html
==================================================================
--- help/html/ubuntuusersm.html
+++ help/html/ubuntuusersm.html
@@ -1,27 +1,30 @@
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.
@@ -28,11 +31,12 @@
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 develops and maintains
various audio- and video-related standards.
For example the OGG streaming/multiplexing format.
Audio compression schemes like Vorbis, Speex, FLAC, Opus.
@@ -33,11 +36,12 @@
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.
Googles Youtube provides a quirky JSON API that makes browsing
channels and genres feasible. This beta plugin provides a little
overview, and usually retrieves recent video uploads.
VLC can directly play Youtube URLs. For other players one can use
youtube-dl as wrapper.
@@ -32,11 +35,12 @@
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.
Region
With the country dropdown you can predefine which mostPopular listings are returned.
Streamtuner2 shows internet radio stations for easy browsing, playing, recording.
+ Browsing channels and radio stations
Index: help/introduction.page
==================================================================
--- help/introduction.page
+++ help/introduction.page
@@ -5,18 +5,20 @@
Basic usage instructions. Selecting a channel, category, and playing a radio.
+ 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. The category/genre lists are in the left pane, and associated stations right
to them.
For updating or installing new plugins (extra channels or
features), there's a user plugin manager. It's available as
feature extension itself.
@@ -33,10 +31,11 @@
then enable them.
Updated plugin versions won't be instantiated right away
if they've been active already. That requires either a restart.
Or disabling + saving once, then reenabling them.
+ Configuration
Alternative download repositories may be configured. (Little
@@ -53,11 +52,11 @@
-
+ User plugins
Downloaded plugins are stored in ~/.config/streamtuner2/plugins.
To remove them, delete the individual *.py files there manually. But
keep the __init__.py stub.
Core plugins (those which are installed
Index: help/specbuttons.page
==================================================================
--- help/specbuttons.page
+++ help/specbuttons.page
@@ -2,12 +2,10 @@
type="guide"
id="specbuttons">
-
-
Toolbar application short cuts.
Special extra/mini buttons
Index: help/streams.page
==================================================================
--- help/streams.page
+++ help/streams.page
@@ -6,10 +6,11 @@
Radio streams lists, station information columns, entry actions.
+Streams / Stations
Radio stations are listed in the right pane. Usually they have a title and a
description. The description is often the last played song. (This isn't updated
automatically to conserve bandwidth and because live information is seldomly available.)
@@ -17,11 +18,11 @@
Station list
You can double click a station line to get it to play. Alternatively there are the
play and record buttons in the menubar. You can also invoke a stations homepage, if it
has one.