Index: help/html/config_apps.html ================================================================== --- help/html/config_apps.html +++ help/html/config_apps.html @@ -15,10 +15,12 @@
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 by a generic player, like vlc.
+A few common applications and invocation strings to use are:
Audacious |
audacious |
audio |
@@ -135,10 +137,72 @@
it. This format retains the maximum of station infos (such as
homepages etc.), and thus often makes for better bookmarking directly
in your player.
+
+
Placeholder |
+As variable |
+Field content |
+
%title |
+$title |
+Station title |
+
%genre |
+$genre |
+Stream category or genre list |
+
%playing |
+$playing |
+Currently playing song, or geographic location |
+
- |
+$url |
+Unfiltered stream url (may contain internal urn:xx:id) |
+
%format |
+$format |
+The MIME type ("audio/mpeg") |
+
%bitrate |
+$bitrate |
+Known stream bitrate, if any |
+
%extra |
+$extra |
+Comments or timer settings |
+
%favourite |
+$favourite |
+If bookmarked |
+
Not all fields are used in all channels. Sometimes they're repurposed (like playing + often doubles as Location: field). And some channels may even use custom internal names.
+You often want to use such placeholders if you have a player or recording shell script, such as + contrib/cmdline/streamripper_addgenre + to handle them. Or if you define a mini-toolbar specbutton + with custom commands.
Here a few other configuration examples for other @@ -155,15 +219,38 @@ mpc clear mpc load $1 mpc play
Save it as mpc-pls script and configure it in streamtuner as - mpc-pls %pls for example. + mpc-pls %pls for example. You can find an extended + version in the contrib/cmdline/ directory.
There's a few gothchas when running streamtuner2 on +Windows.
You will often have to quote command paths (e.g. to + "C:/Program Files/Mozilla Firefox/firefox.exe" or + vlc.exe) in double quotes. In particular if those paths + contain spaces.
If you're using streamripper.exe it's best to put it into a directory + without spaces. For some reason quoting the full exe path will not pass on + parameters.
If you want to be extra safe, just extend your system %PATH variable + to include all relevant directories. Then just specify the basenames, like + firefox.exe for browsing, or vlc.exe as + player.
As reported by Oliver in the sourceforge Discussion +board.
Since this is still rather experimental, you may disable all associated features by starting ST2 via:
streamtuner2 -d pluginmanager2
DreamBox plugin
Musicbox (Android)
Gradio
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.
Instead of browsing by genres, you can switch to languages or @@ -43,10 +46,17 @@ countries.
Note that you'll have to use Channel ▸ Reload Category Tree (F5) again to update the catogory view.
With RadioDroid + there's a mobile version to access and play from radio-browser.info + directly. Get it on F-Droid + or the Play store.