You probably won't need this often. But there's an
Most radio stations are listed with a homepage URL. Use the
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.)
-You can also visit channel homepages (Shoutcast.com, Xiph.org, etc).
Either from the
To start playing a station, you can:
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.
-Most stations that stream MP3 or OGG music can be recorded. This is
accomplished through the command-line tool
You can configure the recording tool according to audio types again.
-There's already a default entry for recording radio stations:
Index: help/action_saving.page ================================================================== --- help/action_saving.page +++ help/action_saving.page @@ -6,11 +6,10 @@You can export the currently selected stream using
You can also save in
Streamtuner2 allows to bookmark favourite streams/stations.
Once bookmarked the station is listed under
Additionally every appearance of the station in other channel tabs gets a ★ star icon.
-Entries can be removed from the bookmark list again. Use
Dirble.com is another radio station directory, based on
user-contributed entries and automatic streaming server polling. 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. For the dirble plugin each station entry may contain a stream
status icon. They often just represent a heuristic check or general
Index: help/channel_filtermusic.page
==================================================================
--- help/channel_filtermusic.page
+++ help/channel_filtermusic.page
@@ -7,11 +7,10 @@
Filtermusic summarizes all the common genres, but is primarily
focused on electro/dance/pop stations. 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. 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,11 +7,10 @@
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. 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. Jamendo is a Creative Comments licensing oriented music distributor. It
hosts audio files for individual musicians and artists. It allows to list
@@ -23,11 +22,10 @@
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. MikMod MODPlug for XMMS GModplay VLC (built-in support) See recording configuration if you
Index: help/channel_myoggradio.page
==================================================================
--- help/channel_myoggradio.page
+++ help/channel_myoggradio.page
@@ -7,19 +7,17 @@
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.
Index: help/channel_radiobrowser.page
==================================================================
--- help/channel_radiobrowser.page
+++ help/channel_radiobrowser.page
@@ -7,11 +7,10 @@
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
@@ -30,11 +29,10 @@
Since v0.3 / streamtuner2.2.0 you can now also share your favorite
stations directly. There's a new 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,11 +7,10 @@
Radionomy is an internet radio streaming provider, orginally
founded in Belgium. It commands a pretty big slice of the worldwide
@@ -25,11 +24,10 @@
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. SHOUTcast is the name of a MP3 streaming server software. It automatically collects all
station lists on shoutcast.com.
@@ -24,9 +23,8 @@
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. It provides streaming links in different audio formats. Only
@@ -27,7 +25,8 @@
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. SurfMusic is a user-collection of
internet radios. It's grouped by genres, or locations / countries. 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. TuneIn hosts a major radio, show and podcast directory. It also provides the
RadioTime/AIR interface for listener feedback or something. ST2 queries the OPML
lists only for radio stations currently. You can switch between "music" and "genres" list. The genres
list is basically a longer and expanded variant of "music".
Index: help/channel_ubuntuusers.page
==================================================================
--- help/channel_ubuntuusers.page
+++ help/channel_ubuntuusers.page
@@ -6,11 +6,10 @@
There's a manually curated list of radio stations in the
UbuntuUsers.de Wiki. 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. 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. 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
@@ -26,12 +25,10 @@
tab. Of course you could also just invoke a specific YT video by
opening it in your web browser - click the station The tabs in the main window represent the music directory
channels/services. Each lists categories/genres and their associated radios/streams. 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. 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. 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
application for all audio formats. But at least the */* media type should be handled
@@ -38,11 +37,10 @@
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.) Listed audio players get run with a streaming server address (URL).
Index: help/configuration.page
==================================================================
--- help/configuration.page
+++ help/configuration.page
@@ -7,11 +7,10 @@
There are various options for streamtuner2, available under 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
@@ -105,7 +104,6 @@
See also the list of
available
plugins in the project wiki. Extra functionality and behaviour changes are available in
the Some channels provide lower-quality audio streams. In particular
Index: help/global_key.page
==================================================================
--- help/global_key.page
+++ help/global_key.page
@@ -5,11 +5,10 @@
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. 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. 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,23 +1,20 @@
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.
@@ -31,33 +28,32 @@
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,30 +1,27 @@
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. 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. 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. 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: 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.) 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,29 +1,26 @@
There are various options for streamtuner2, available under Edit ▸ Preferences or via F12.
Associates media formats to audio player applications or recording tools. Another class of plugins enables internal functions, or adds extra menu
entries, or further configuration options. The Plugin Manager 2 adds another
+ The Plugin Manager 2 adds another
tab for updating or installing new plugins. MIME types are abstract identifiers for media types. Audio/mpeg for
example represents MP3 files, and audio/ogg means OGG Vorbis. And the player
@@ -91,11 +87,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.) xterm -e "youtube-dl %srv" 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. 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. Radio.net is a European radio directory. It nicely catalogues
stations into genres as usual. The primary list is ordered by
@@ -85,27 +82,26 @@
won't receive any. See also the list of
available
plugins in the project wiki. Extra functionality and behaviour changes are available in
-the 🔌 Feature configuration
-section. Extra functionality and behaviour changes are available in
+the 🔌 Feature configuration
+section. Some channels provide lower-quality audio streams. In particular
Xiph lists some awful radio stations. And this plugin helps filtering
@@ -88,24 +84,24 @@
The "search",
- "configwin" and
- "streamedit" plugins are considered
+ "configwin" and
+ "streamedit" plugins are considered
built-ins and cannot be disabled. The Plugin Manager lists other
+ The Plugin Manager lists other
available feature plugins in the 📦 Add tab. Enables playback of soundcloud.com links in the Reddit plugin.
@@ -137,15 +133,15 @@
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. For the dirble plugin each station entry may contain a stream
status icon. They often just represent a heuristic check or general
Index: help/html/edit.html
==================================================================
--- help/html/edit.html
+++ help/html/edit.html
@@ -1,27 +1,24 @@
You probably won't need this often. But there's an
▸ Edit/Details context menu
which brings up a station editor:
Bookmarks
Bookmarks
Editing
Channels
Channels
Available channels
Channel service homepage
CLI (command line interface)
CLI (command line interface)
Examples
Examples
GUI options
Audio players
Audio players
@@ -70,12 +67,11 @@
For VLC there's however also the --one-instance option, which sometimes
works better. (And sometimes not.)
URL placeholders
Configuration / Settings dialog
Configuration / Settings dialog
It's grouped into:
It's grouped into:
Player application settings
Recording Apps
Display/GUI options
→ Contrib/Extra Channels
→ Contrib/Extra Channels
→ Feature plugins
→ Feature plugins
Filter Bitrate
Other feature plugins
Downloadable contrib/ feature plugins
More Information
-
See Also
Station status indicators
Edit
Edit