Index: help/action_recording.page
==================================================================
--- help/action_recording.page
+++ help/action_recording.page
@@ -2,31 +2,54 @@
type="guide"
id="recording">
Most stations that stream MP3 or OGG music can be recorded. This is accomplished by - the commandline tool "streamripper". If you select a station a press the [record] button, - a console window should appear. Within that streamripper outputs its current activity.
- -Per default recorded streams are written into the current directory. Often this is your - home directory. And streamripper automatically creates a directory with the recorded - radio station title as name. Within that directory the individual music titles are split - into separate .mp3 files.
- -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 - for recording ICEcast/SHOUTcast streaming servers.
+Most stations that stream MP3 or OGG music can be recorded. This is accomplished through +the commandline tool "streamripper". If you select a station a press the [record] button, +a console window should appear, where streamripper shows its progress.
+ + +The
Format | Application |
audio/* |
To configure a default download directory, use the
As alternative to streamripper, check out fIcy/fPls +for recording ICEcast/SHOUTcast streaming servers.
+ +It can be configured with
The recording settings have a specific entry for "video/youtube" URLs. To configure a specific download
+directory, use
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.
audio |
Format | Application |
audio/mpeg | |
audio/ogg | |
audio/* | |
video/* | |
video/youtube |
Application names are always lowercase binary names. Double click an entry to edit it.
+ +After the application name, you can use a placeholder like "%pls" (which is the default, + and returns a direct URL often) or "%m3u" (where streamtuner creates local MP3 playlist file first) + and "%src" (a direct streaming server link, e.g. for VLC).
+ +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).
+ +The second block of entries in the 'Apps' section specifies recording applications. + Here streamripper is preconfigured for audio streams, and youtube-dl for Youtube videos for instance.
+ +audio/* | |
video/youtube |
To define a target directory, you can 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.)
+Most options here a self-explanatory. The options for the favicons define if station entries should + show little icons. Not all stations have one, so you might as well turn this off to conserve a little + memory.
+ +The number of stations setting 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.
+ +"Retain deleted stations" keeps old entries, when you reload a category/genre. Shoutcast often + forgets stations or throws them out. If you keep this option enabled, these entries are kept in + streamtuner2. Browse down in the stations list to still see them.
+ +It's possible to select a Gtk+ theme. But not all themes work with all Gtk display engines, and + not all themes work with streamtuner2. You'll have to try.
+ +Remembering window states allows streamtuner2 to reconstruct which channel and category was last + selected. You can however disable this option, and instead manually save the window states/layout + in the edit menu, if you want.
+ +Setting another temporary directory might be useful, if you want to keep the temporary .m3u cache + files. They are created whenever you hit play. For archival or speed-up porposes you might want to keep + them elsewhere. They don't take a lot of space.
+Each channel plugin can bring its own list of configuration settings. These are collected here.
+ +The heading for each plugin allows to enable or disable it. To apply changed states you need to restart + streamtuner2 however.
+ +If you want to find out more about the short option descriptions (most settings are checkboxes), + please have a look into the channels directory /usr/share/streamtuner2/channels/ and corresponding + *.py files. These are readable, and sometimes contain more information.
+