Index: help/action_recording.page ================================================================== --- help/action_recording.page +++ help/action_recording.page @@ -23,10 +23,10 @@

You can influence all these behaviours with -arguments to the streamripper program. Please refer to the manpage of streamripper. The options are too broad to list here. You can set default arguments (e.g. another default save directory) in the Config > Apps dialog.

-

As alternative check out fIcy/fPls +

As alternative check out fIcy/fPls for recording ICEcast/SHOUTcast streaming servers.

Index: help/channel_myoggradio.page ================================================================== --- help/channel_myoggradio.page +++ help/channel_myoggradio.page @@ -23,11 +23,11 @@

The personal section is empty per default. You need to specify an user account in the settings dialog, and actually bookmark stations in MyOggRadio web site. Shared entries are not automatically in the MOR favorite list.

-

There's also JMyOggRadioPlayer +

There's also JMyOggRadioPlayer as specific frontend and player for MyOggRadio.

Channel options. Index: help/config_apps.page ================================================================== --- help/config_apps.page +++ help/config_apps.page @@ -13,19 +13,19 @@ 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.

- - - - - - - - - + + + + + + + + +
Audacious audacious %m3u audio
XMMS2 xmms2 %m3u audio
Amarok amarok -l %pls audio
Exaile exaile %m3u audio
Amarok amarok -l %pls audio
mplayer mplayer %srv console
VLC vlc %u video/*
Totem totem %u video/*
Media Player mplayer2.exe %pls Win32

Audacious

audacious %m3u

audio

XMMS2

xmms2 %m3u

audio

Amarok

amarok -l %pls

audio

Exaile

exaile %m3u

audio

Amarok

amarok -l %pls

audio

mplayer

mplayer %srv

console

VLC

vlc %u

video/*

Totem

totem %u

video/*

Media Player

mplayer2.exe %pls

Win32

Some audio players open a second instance when you actually want to switch radios. In this case it's a common workaround to write pkill vlc ; vlc %u instead, which ends the previous player process and starts it anew. @@ -42,17 +42,17 @@

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.

- - - - + + + +
PlaceholderAlternativesURL/Filename type
%m3u%f %g %mProvides a local .m3u file for the streaming station
%pls%url %u %rEither a remote .pls resource, or a local .pls file (if converted)
%srv%d %sDirect link to first streaming address, e.g. http://72.5.9.33:7500

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)

%srv

%d %s

Direct link to first streaming address, e.g. http://72.5.9.33:7500

You sould preferrably use the long forms. Most audio players like %m3u most, while streamripper needs %srv for recording.

Index: help/glossary_json.page ================================================================== --- help/glossary_json.page +++ help/glossary_json.page @@ -12,17 +12,17 @@

JSON is a data representation format derived from Javascript (the browser embedded programming language for websites). Streamtuner2 uses it to store its configuration and radio station data files.

The MIME type of these files is application/json and they often look like:

-

+ [ { "title": "Station title..", "url": "http://1.2.3.4:8000/", "homepage": "http://radio.org/", }, { "title": "second" } ] -

+ Index: help/glossary_m3u.page ================================================================== --- help/glossary_m3u.page +++ help/glossary_m3u.page @@ -10,12 +10,12 @@ .M3U files

M3U files also contain playlists, like .pls files. They're often used by desktop audio players.

The MIME type of these files is audio/x-mpegurl and they often look like:

-

+ #M3U http://123.45.67.189:8222/ http://123.45.67.222:7555/ -

+ Index: help/glossary_pls.page ================================================================== --- help/glossary_pls.page +++ help/glossary_pls.page @@ -13,14 +13,14 @@

It's the primary station stream link format of SHOUTcast.

The MIME type of these files is audio/x-scpls and they often look like:

-

+ [playlist] numberofentries=1 File1=http://123.45.67.189:8222 Title1=(#1 - 555/2000) radio station Xyz - top 100 - all the hitzez Length1=-1 -

+ Index: help/html/bookmarks.html ================================================================== --- help/html/bookmarks.html +++ help/html/bookmarks.html @@ -17,17 +17,17 @@

Bookmarks

-

It's easy to lose the overview when you browse through the various channel tabs, genres - and internet radio stations. Therefore streamtuner2 allows to create bookmarks. This way - you can collect favoured streams in a single place.

+

It's easy to lose oversight when switching across channel tabs, + genres and internet radio stations. Therefore streamtuner2 allows + to bookmark stations to collect favoured streams in a single place.

Just right click a station you want to bookmark, and choose bookmark in the context menu. Alternatively you can use the Streams entry in the application menu. Once bookmarked you can see the station entry in the (!) "bookmarks" tab, under "favourite". That's where - they all go.

+ they go.

Editing

Entries can be removed from the bookmark list again. Use the edit menu for that.

@@ -39,10 +39,11 @@

Subcategories

The bookmarks tab can display other categories besides "favourite". For example the search feature creates a "search", while the "timer" and "links" plugins also display lists here.

+

However the favourite list itself can not yet be categorized further.

Index: help/html/channels.html ================================================================== --- help/html/channels.html +++ help/html/channels.html @@ -11,38 +11,46 @@ ♪ Streamtuner2  › Browsing channels and radio stations »

Channels

-

The tabs in the main window represent the music directory channels. Each lists - categories and streams from a specific radio directory.

+

The tabs in the main window represent the music directory + channels/services. Each lists categories and streams from a + specific radio directory/website.

If you first select a channel tab, the categories should appear or be loading. Otherwise:

  1. Select a channel tab

  2. Choose Channel ▸ Reload categories...

  3. Pick a category/genre from the overview, left.

Individual channels provide different music/radio information. The table - views are however identical in each tab. You could modify the datamap[] - in the plugin files, if you want to adapt this.

+ views are mostly identical in each tab. (You could modify the datamap[] + in the plugin files if you wanted to adapt this.)

Channel service homepage

-

You can dobule click the channel tab to view the website of a directory services. +

You can dobule click the channel tab to visit the channel/directory homepage. Alternatively there is an entry in the Channel menu.

Channel menu options

Index: help/html/cli.html ================================================================== --- help/html/cli.html +++ help/html/cli.html @@ -21,11 +21,11 @@

Examples

streamtuner2 play "station"

This command looks through all channel plugins, and finds a station containing the - mentioned title. In the shell you must put the station title in quotes, if it contains + 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.

streamtuner2 url [channel] "station"

Just looks up the streaming URL for a given station. If no channel name is given, ST2 searches through all available channel plugins again.

streamtuner2 stream shoutcast "station"
@@ -37,10 +37,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 mode: There are also --gtk3 and --gtk2 command line options. Usually the right toolkit + is picked depending on Python version. But you can manually override this.