Index: NEWS
==================================================================
--- NEWS
+++ NEWS
@@ -6,13 +6,15 @@
- A new channel plugin for "Radio-Browser.info" has been bundled.
- Another plugin for interfacing with "RadioTray" was introduced, to
share bookmarks via DBUS once RadioTray implements it.
- Notebook tabs are now on the left per default, and can be rearranged
directly in the GUI.
+- The configuration dialog now indicates the availability of selected
+ audio players. Default audio players are now automatically configured
+ during the first startup.
- Gtk properties are now utilized more over internal UI state vars.
- And the GtkBuilder UI file is now compressed.
-- The Gtk2 fallback file became redundant.
+- The the GtkBuilder UI file is now compressed, the Gtk2 fallback removed.
- The former channel icon PNGs are now embedded.
- Theme configuration was removed.
- Category retrieval became more resilient.
- HTTP timeouts have been added.
- The bookmarks tab, settings window, search dialog, stream inspector/editor
@@ -20,11 +22,11 @@
- The packaging layout has been slightly restructured - to support
relocatable installations (for PyZIP package).
- Minor fixes to youtube, internet_radio, punkcast, timer and other plugins.
- Help pages have been updated further, as well as CREDITS, README and
general PACKAGING infos, and most plugin short descriptions.
-- The project fossil wiki now contains a more details on plugin APIs.
+- The project wiki now contains a more details on plugin APIs.
2.1.4 (2015-03-25)
- Fixed Internet-Radio extraction.
- Added basic TuneIn channel.
- Removed Dirble and MusicGoal channels.
ADDED help/action_edit.page
Index: help/action_edit.page
==================================================================
--- help/action_edit.page
+++ help/action_edit.page
@@ -0,0 +1,34 @@
+ You probably don't often need this. But there's an
+ You can see the standard title and genre fields here. But also a
+ few internally kept infos. For example the "url" field contains the
+ actual pls/m3u/server address. While the "format" can list a
+ non-standard audio compression type. This dialog is primarily useful for your personal bookmarks.
+ It allows to shorten or rename things. You can even use
+
Note however that some audio players will run multiple instance and won't
+ Note however that some audio players will run multiple instances and won't
allow simple station switching. In such situations it might be sensible to write
a wrapper script, or configure special commandline arguments to your favoured audio
player (e.g. "vlc --one-instance").
It's also possible to save a station entry as .m3u or .pls file, and load this manually
Index: help/action_recording.page
==================================================================
--- help/action_recording.page
+++ help/action_recording.page
@@ -20,11 +20,11 @@
The Format Application audio/* You can export the currently selected stream using
- The extension of the filename decides on the saved link format. Per
default a .m3u file is created, because that's what most audio players
Index: help/channel_bookmarks.page
==================================================================
--- help/channel_bookmarks.page
+++ help/channel_bookmarks.page
@@ -12,12 +12,12 @@
Streamtuner2 allows to bookmark favoured streams/stations.
Which is what the Use the right click a stations Use right click for a stations Once bookmarked the station is listed under
Entries can be removed from the bookmark list again. Use
You can also manually adapt an entry via You can also manually adapt an entry via Internet-Radio.com is a broad alternative to Shoutcast. It
- has regained station homepages for most entries again.
+ Internet-Radio.com is a broad alternative to Shoutcast.
+ It has regained station homepages for most entries again.
Genres are similiar to Shoutcast. Note that this plugin has its own setting on how many
links to retrieve. Instead of stream numbers, it only counts pages
(which however speeds up processing now). There's an English and a German variant of this radio directory. Genres are
- also localized. 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 148 or 192 at least). With the country dropdown you can predefine which mostPopular listins are returned. With the country dropdown you can predefine which mostPopular listings are returned. You can edit the list of YT channel names to fetch some of your favourite artists/uploaders.
To apply this setting, and have new categories show up in the genre pane, use
Index: help/channels.page
==================================================================
--- help/channels.page
+++ help/channels.page
@@ -10,14 +10,16 @@
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
- If you first select a channel tab, the categories should appear or be loading.
Otherwise: Opens a webbrowser with the current channels website. Opens the website of the currently selected channel
+ in your configured web browser. Updates the current category and displays fresh station lists. Some applications, like Rhythmbox or Banshee, are primarily audio browsers, not players,
+ Some applications, like Rhythmbox or Banshee, are primarily playlist managers, not players,
and cannot be invoked with a play URL by other apps. This makes them less suitable for use with
- streamtuner2. Any listed application can be invoked with a different kind of
- URL or filename.be invoked with a play URL by other apps. Which to
- use often depends on the application. Placeholder Alternatives URL/Filename type %m3u %f %g %m Provides a local .m3u file for the streaming station %pls %url %u %r Either a remote .pls resource, or a local .pls file (if converted)
There are various options for streamtuner2, available under Lists audio formats and the audio player applications, or recording tools below.
It's a file type to application table. Double click an entry for editing. Every channel tab can have specific options. These are configured here.
Also you can disable channels you don't need. audio/* video/* video/youtube Application names are always lowercase binary names. Double click an entry to edit it. Application names are most always lowercase binary names. Double click an entry to edit it.
+ After editing the icon next to the application name will be updated. If it stays green, it's
+ likely to work. If it turns red / into a stop symbol, then the entered name is likely incorrect. After the application name, you can use a placeholder like "%pls" (default),
or "%m3u" and "%src". 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 psdeudo 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.) audio/* video/youtube To define a target directory, you can add commandline arguments to each. Also it's typically
+ 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. (Alternatively to
xterm there is x-terminal-emulator, or rxvt, gnome-terminal, xfce4-terminal, etc.) Bookmarked stations will be marked with a ★ star in all other station lists / categories.
That doesn't often work for the same station entry from two different channel services / tabs though. Be careful. While Gtk allows to select a different theme per application, not all themes
- work right away. Switching the theme might hang streamtuner2. Just restart if that happens. Automatically remember window size, selected channel tab, categories, or selected station.
Also keeps the width of station list columns. If disabled, you can manually save the current
layout/selections via Some channels provide proper APIs to fetch station lists. Others are just websites, that
+ Some channels provide proper APIs to fetch station lists. Others are just websites that
require scraping listings out. Most channel tabs provide two alternative methods for that.
- The DOM/HTML selection method is sometimes more reliable. As fallback streamtuner2 plugins
- often use a regex to match text. Occassionally the regex method is actually more reliable,
+ The DOM/HTML selection method is sometimes slower, but more reliable. As fallback streamtuner2
+ plugins often use a regex to match text. Occassionally the regex method is surprisingly more exact,
because directory services often use frightful unstructured HTML. If available, both methods
- are tried. You can influence the order with this setting. Constraints the length of station lists per category.
- The number of stations setting is not honored by all channel plugins. Often it's not possible to
+ The number of stations option is not honored by all channel plugins. Often it's not possible to
load more or fewer station entries. Some plugins have own settings (in the 'Plugins' section) even.
- For the major plugins this however limits how much scroll text appears in the stream lists. When enabled, keeps old station entries when
updating/reloading a category/genre. Services often forget stations or throws them out when inavailable.
With this option enabled, these entries are kept in streamtuner2 as strikethrough entries (often
@@ -178,10 +182,12 @@
This tab lists all available channel and feature plugins. Mark checkboxes for those plugins
you want to enable. You have to restart Streamtuner2 for any changes here to take effect. Each channel plugin may come with its own set of addition configuration settings
below. If you want to find out more about the short option descriptions (most settings are checkboxes),
Index: help/global_key.page
==================================================================
--- help/global_key.page
+++ help/global_key.page
@@ -8,11 +8,11 @@
Using the global_key extension you can define a keyboard shortcut for switching within
- a list of favourite radio stations. Per default it uses your bookmarks list, but it can be
+ 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. To define another channel as source, enter its module name in the according field. Also
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. 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.
Index: help/action_saving.page
==================================================================
--- help/action_saving.page
+++ help/action_saving.page
@@ -9,11 +9,11 @@
Language
Filter by minimum bitrate
Region
My Channels
pkill vlc ; vlc %u
instead,
which ends the previous player process and starts it anew.
For VLC there's however also the --one-instance
option, which sometimes
works better. (And sometimes not.)
-
-
Index: help/configuration.page
==================================================================
--- help/configuration.page
+++ help/configuration.page
@@ -12,13 +12,14 @@
-
Station information can get stale. Especially Shoutcast invalidates old information
- frequently. Therefore you have to
Favicons aren't loaded automatically. There is a menu entry in Channels for that, which works in the background and doesn't display the new icons automatically either. Simply reselect the category/genre in the left pane. Or again, use the station reload button.
Index: help/search.page ================================================================== --- help/search.page +++ help/search.page @@ -25,10 +25,12 @@You can get to the search dialog via
It either will search in all channels, or just the last active channel/service.
Then there are two search methods. You mostly want to use Index: help/timer.page ================================================================== --- help/timer.page +++ help/timer.page @@ -11,12 +11,13 @@
You can programm play/recording events with the timer plugin. Simply select a station
and choose
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.)