vdr/MANUAL

Video Disk Recorder User's Manual
---------------------------------

Version 1.6
-----------

* Remote Control Keys

  The following remote control keys are used to control the VDR
  operation. To keep the number of different keys as small as
  possible, several keys have different meanings in the various
  modes:

  Key     Normal      VDR          Channels   Timers     Edit/New      Recordings        Replay           Audio

  Up      Ch up       Crsr up      Crsr up    Crsr up    Crsr up       Crsr up           Play             Sel. track
  Down    Ch down     Crsr down    Crsr down  Crsr down  Crsr down     Crsr down         Pause            Sel. track
  Left    Prev group  -            Page up    Page up    Decrement     Page up           Search back      Sel. channel
  Right   Next group  -            Page down  Page down  Increment     Page down         Search forward   Sel. channel
  Ok      Ch display  Select       Switch     Edit       Accept        Play              Progress disp.   Switch & Close
  Menu    Menu on     Menu off     Menu off   Menu off   Menu off      Menu off          Menu off         Menu off
  Back    -           Menu off     VDR menu   VDR menu   Discard       VDR menu          Recordings menu  Close
  Red     -           Record       Edit       On/Off     ABC/abc       Play/Commands(1)  Jump             -
  Green   -           Audio        New        New        Ins/Ovr       Rewind            Skip -60s        -
  Yellow  -           Pause live   Delete     Delete     Delete        Delete            Skip +60s        -
  Blue    -           Stop/Resume  Mark       Info       -             Info              Stop             -
  0..9    Ch select   -            Sort(2)    Day(3)     Numeric inp.  Exec cmd(1)       Editing          -

  In a numerical input field (like the response to a CAM enquiry) the keys 0..9
  are used to enter the data, and the Left key can be used to delete the last
  entered digit.

  In a text input field (like, e.g., the file name of a recording) the characters
  can be entered by pressing the numeric keys, the same way as on a telephone
  keypad.

  If your remote control provides additional keys, they can be used for the
  following functions:

  Info        display information on the currently viewed programme or recording,
              or on the current item in a menu
  Play        resume normal replay
  Pause       pause replay or live video
  Stop        stop replay
  Record      instant recording
  FastFwd     fast forward
  FastRew     fast rewind

  Next        Next/previous channel group (in live tv mode)
  Prev        or next/previous editing mark (in replay mode)

  Channel+    channel up
  Channel-    channel down
  PrevChannel previous channel

  Power       shutdown

  Volume+     volume up
  Volume-     volume down
  Mute        mute

  Audio       select audio track
  Subtitles   select subtitles

  Schedule    \
  Channels    |
  Timers      | directly access the VDR
  Recordings  | main menu functions
  Setup       |
  Commands    /

  User1...9   additional user defined keys for macro functions
              (defined in 'keymacros.conf')

  Note that in normal viewing mode (no OSD active) the color keys can have user
  defined functionality, as configured in 'keymacros.conf'.
  The default assignment is

  Red       Recordings menu
  Green     Schedule menu
  Yellow    Info
  Blue      Timers menu

  (1) See "Processing Recordings" below.
  (2) In the "Channels" menu the '0' key switches the sort mode through "by number",
      "by name" and "by provider". Other numeric input positions the cursor to
      the channel with the number entered so far. If there is no channel with that
      number, nothing happens. While entering a channel number, the '0' key will
      be treated as part of that number, not as a sort mode toggle. If no numeric
      key has been pressed for more than one second, the number is reset and '0'
      functions as sort mode toggle again.
  (3) In the "Timers" menu, when on the "Day" item, the '0' key toggles between
      a single shot and a repeating timer. If "Day" indicates a repeating timer,
      the keys '1'...'7' can be used to toggle the individual days ('1' is Monday).

* Navigating through the On Screen Menus

  The "VDR" menu can be called up with the "Menu" key of your remote
  control unit. The "Up" and "Down" keys are used to select a specific
  item. The "Left" and "Right" keys can be used to change options, and
  the numeric keys allow direct input of numeric data. The "Ok" key
  confirms any changes (or switches to a channel in the "Channels" menu).
  The "Back" key goes back one level in the menu structure, discarding
  any changes that might have been made in the current menu.

  In the "Timers" menu, the current timer can be enabled or disabled with
  the "Red" key. Enabled timers are marked with '>', timers
  that are currently recording are marked with '#'. If a timer has the
  "First day" set so that it will start recording only on the given date,
  it is marked with '!'. The "Red" key toggles through the "enabled" and
  "disabled" states, and for repeating timers that are currently recording
  also a state that ends this recording prematurely and sets the "First day"
  date so that it will record again the next time the timer hits.
  "Ok" here opens the "Edit timer" menu.

  Textual options, like channel names or recording file names, can be edited
  by pressing the "Right" key (which puts brackets around the current
  character as in "[R]TL"), selecting the desired character position with
  "Left" and "Right", and changing the character with the "Up" and "Down"
  keys. "Ok" then confirms the changes. The "Red" key toggles between
  upper- and lowercase characters, while the "Green" key switches between
  insert and overwrite mode. The "Yellow" key deletes the current character
  (or the one to the right of the cursor in insert mode).

  The "Red", "Green", "Yellow" and "Blue" keys have special meanings
  in various menus and are listed at the bottom of the on-screen-display.

  At any point in the menu system, pressing the "Menu" key again will
  immediately leave the menu system (discarding any pending changes).

* The "Schedule" Menu

  The "Schedule" menu implements VDR's "Electronic Program Guide" (EPG).

  Select "Schedule" from the "VDR" menu and you get a list of all upcoming
  broadcasts on the current channel.

  "Up" and "Down" can be used to scroll through this list, and pressing "Ok"
  displays detailed information about the selected programme. Pressing "Ok"
  again (or pressing "Back") gets you back into the "Schedule" menu.

  From the "Schedule" menu, the "Green" key opens the "What's on now?"
  menu, which displays all programmes that are currently running on all
  channels that broadcast their programme information on the current
  transponder, or from channels that have been current lately (VDR stores
  all information it gathers in an internal list). The more channels you
  have been switching through lately, the longer this list will be.
  The "Yellow" key opens the "What's on next?" menu, which lists all
  programmes that will start next on all channels.

  Inside the "What's on now/next?" menus the "Green" key toggles between
  the "Now" and "Next" display, and the "Yellow" key takes you to the
  "Schedule" menu of the current channel in the list.

  The "Red" key allows you to instantly program a timer to record the
  selected programme. After pressing this key, the current event will
  be marked with 'T', and the function of the "Red" key will change from
  "Record" to "Timer". Pressing "Red" on an event marked with 'T' will open
  the "Edit timer" menu for this timer, where you can make any modifications
  you may want to apply. Note that the Start and Stop time are offset by the
  MarginStart and MarginStop parameters (see Setup) in order to make sure the
  entire programme is recorded in case it doesn't exactly adhere to its
  published start/stop times. Of course, no guarantee can be given that the
  default margin values will be sufficient, so in case this recording is
  really important you may want to add an extra margin ;-). VPS recordings
  will use the exact Start (or VPS) and Stop times as given in the event.
  If a timer is newly created from within the "Schedule" menu, and its event is
  already running or has its start time within the next two minutes, it goes
  directly into the "Edit timer" menu in order to allow the user to make further
  changes to timer parameters before the actual recording starts.

  The "Blue" key can be pressed to switch to the channel with the selected
  programme.

  The following markers in these menus give additional information about the
  status of the events:

  t  there is a timer defined for this event which covers only part of the event
  T  there is a timer defined for this event which covers the entire event
  V  this event has a VPS time that's different than its start time
  *  this event is currently running (the validity of this marker depends on
     whether there is currently a DVB card receiving the transponder this channel
     is on).

  Pressing '0' in the "Schedule" menu rotates through displaying "This event on
  this channel", "This event on all channels" and "All events on all channels".
  This can be used to find reruns of a given show, or the episodes of a series.
  Note that if there are many channels in your channels.conf, displaying the
  "All events on all channels" page may take a while.

* Selecting a Channel

  There are four ways to select a channel:

  1. With no On Screen Menu displayed press the "Up" or "Down" key to switch
     to the next higher or lower channel.
  2. Press the "Menu" key to bring up the On Screen Menu, select "Channels"
     and browse through the list with the "Up" and "Down" key; to switch to the
     selected channel press "Ok".
  3. Directly type in the channel number with the numeric keys ('0'..'9');
     if no key is pressed for about one second, the digits collected so
     far will define the channel number.
  4. From the "Now", "Next" and "Event" menus (accessible through the "Schedule"
     menu) by pressing the "Blue" key.

  Pressing the '0' key in normal viewing mode toggles between the current and
  the previous channel. A channel is considered "previous" if it has been
  selected for at least 3 seconds.

  After switching to a different channel the channel number and name, as well
  as the current time are displayed in the OSD. If available, the
  'current/next' information will be displayed below this line. This display
  automatically goes away after about five seconds, or if any key is pressed.
  To bring up the channel display without switching channels you can press
  the "Ok" key.

* Selecting audio tracks

  If the current channel or recording provides different audio tracks (for
  different languages or Dolby Digital), the "Green" key in the "VDR" menu can
  be pressed to bring up the "Audio" menu. Within this menu, the "Up" and "Down"
  keys can be used to switch between the audio tracks. If your remote control has
  a dedicated "Audio" key, the first press of that key brings up the "Audio"
  menu, and every further press switches to the next available audio track.

  The "Left" and "Right" keys can be used to switch between "mono left", "stereo"
  and "mono right" for channels that broadcast different audio tracks in the
  left and right stereo channels.

  The "Ok" key explicitly switches to the selected track (in case the device
  for some reason doesn't play it) and closes the "Audio" menu.

  The "Audio" menu will automatically disappear after 5 seconds of user inactivity,
  or if any key other than the ones described above is pressed.

  Once a Dolby Digital track has been selected on any channel, further channel
  switches will first search for a Dolby Digital track of one of the preferred
  audio languages. If no such track can be found, a normal audio track will
  be selected. Note that this only works if the broadcasters use actual language
  codes in their PID data, not things like "dd" or "2ch".

* Switching through channel groups

  If the 'channels.conf' file contains "group separators" you can switch
  through these groups by pressing the "Left" and "Right" key while no
  menu is being displayed. The channel display will show the name of the
  group, and if you press the "Ok" key while the group name is being
  displayed, you will switch to the first channel of that group.

  Channel groups can be whatever you decide them to be. You can either
  group your channels by "Bouquet", by language, genre or whatever your
  preferences may be.

* Instant Recording

  You can start recording the current channel by pressing the "Red" key
  in the "VDR" menu. This will create a timer event named "@channelname" that
  starts at the current time and by default records for 3 hours.
  If you want to modify the recording time you need to edit the timer.
  Stop instant recording by pressing the "Menu" key and selecting
  "Stop Recording", or by disabling the timer. The default priority, lifetime
  and recording time can be defined in the "Setup/Recording" menu.

* Pausing live video

  If you want to pause the live programme you are just watching, simple press
  "Menu/Yellow" or "Pause" on your remote control. VDR will start an instant
  recording of the current channel (just as if you had pressed "Menu/Red" or
  "Record") and immediately begin replaying that recording. Replay will be
  put into "pause" mode, so you can attend to whatever it was that disturbed
  your live viewing session. Once you're back, simply press the "Up" or "Play"
  key and you'll be watching the current channel in time shift mode, right
  from the point where you left off. The instant recording VDR has started
  will use the parameters for "Pause priority" and "Pause lifetime" as defined
  in the "Setup/Recording" menu. Recording time will be the same as for
  any other instant recording, so by default it will record 3 hours (which
  should be enough for any normal broadcast).

* Replaying a Recording

  All recordings are listed in the "Recordings" menu. Browse through the
  list with the "Up" and "Down" key and press "Ok" (or the "Red" key)
  to start playback. New recordings are marked with an '*'.
  If the Setup parameter RecordingDirs has been set and there are recordings
  from repeating timers organized in a subdirectory structure, only the
  directory is displayed and it can be opened by pressing "Ok" (or the "Red"
  key). A directory entry displays the total number of recordings within
  that directory (and any possible subdirectory thereof) as well as the total
  number of new recordings (as opposed to a recording's entry, which displays
  the date and time of the recording).

  If the setup parameter "Use episode name" was turned on when a recording took place,
  VDR adds the "Episode name" (which is usually the name of the episode in case of
  a series) to the recording's name. The "Recordings" menu then displays all
  recordings of a repeating timer in chronological order, since these are
  usually the individual episodes of a series, which you may want to view in
  the order in which they were broadcast.

  Playback can be stopped via the "VDR" menu by selecting "Stop replaying",
  or by pressing the "Blue" key outside the menu.
  A previously stopped playback session can be resumed by pressing the "Blue"
  key in the "VDR" menu.

* Processing Recordings

  The configuration file 'reccmds.conf' can be used to define system commands
  that can be applied to the recording that is currently highlighted in the
  "Recordings" menu. The "Red" key in the "Recordings" menu opens the "Recording
  commands" menu if there are commands defined in the file 'reccmds.conf'. Pressing
  one of the keys '1'..'9' in the "Recordings" menu executes the corresponding
  command from 'reccmds.conf' (see also "Executing system commands" below).

* Replay Control

  The following keys have the listed meaning in Replay mode:

  - Up      Resumes normal replay from any "pause", "forward" or "backward"
            mode.
  - Down    Halts playback at the current position. Press again to continue
            playback.
  - Blue    Stops playback and stores the current position, so that
            playback can be resumed later at that point.
  - Left
    Right   Runs playback forward or backward at a higher speed; press
            again to resume normal speed. If in Pause mode, runs forward or
            backward at a slower speed; press again to return to pause mode.
            Pressing and holding down the key performs the function until
            the key is released again.
            If "Multi Speed Mode" has been enabled in the "Setup" menu, the
            function of these keys changes in a way that gives you three
            fast and slow speeds, through which you can switch by pressing
            the respective key several times.
  - Red     Jump to a specific location. Enter the time you want to jump to
            and then press "Left" or "Right" to jump relative to the current
            position, "Up" to jump to an absolute position, and "Down" to
            jump and pause at an absolute position.
  - Green
    Yellow  Skips about 60 seconds back or forward.
            Pressing and holding down the key performs the function until
            the key is released again.
  - Ok      Brings up the replay progress display, which shows the date,
            time and title of the recording, a progress bar and the
            current and total time of the recording.
            Press "Ok" again to turn off the progress display.
  - Back    Stops replaying and brings up the "Recordings" menu. This can be
            used to easily delete a recording after watching it, or to switch
            to a different recording.

* Editing a Recording

  While in Replay mode, the following keys can be used to manipulate editing
  marks:

  - 0       Toggles an editing mark. If the mark indicator shows a red triangle,
            the current mark is deleted. Otherwise a new mark is set at the
            current position.
  - 4, 6    Move an editing mark back and forward. You need to first jump to
            an editing mark for this to work.
  - 7, 9    Jump back and forward between editing marks. Replay goes into still
            mode after jumping to a mark.
  - 8       Positions replay at a point 3 seconds before the current or next
            "start" mark and starts replay.
  - 2       Start the actual cutting process.

  Editing marks are represented by black, vertical lines in the progress display.
  A small black triangle at the top of the mark means that this is a "start"
  mark, and a triangle at the bottom means that this is an "end" mark.
  The cutting process will save all video data between "start" and "end" marks
  into a new file (the original recording remains untouched). The new file will
  have the same name as the original recording, preceded with a '%' character
  (imagine the '%' somehow looking like a pair of scissors ;-). Red bars in the
  progress display indicate which video sequences will be saved by the cutting
  process.

  The video sequences to be saved by the cutting process are determined by an
  "even/odd" algorithm. This means that every odd numbered editing mark (i.e.
  1, 3, 5,...) represents a "start" mark, while every even numbered mark (2, 4,
  6,...) is an "end" mark. Inserting or toggling a mark on or off automatically
  adjusts the sequence to the right side of that mark.

  Use the keys described under "Replay Control" to position to, e.g., the
  beginning and end of commercial breaks and press the '0' key to set the
  necessary editing marks. After that you may want to use the '7' and '9'
  keys to jump to each mark and maybe use the '4' and '6' keys to fine tune
  them. Once all marks are in place, press '2' to start the actual cutting
  process, which will run as a background process. When replaying the edited
  version of the recording you can use the '8' key to jump to a point just
  before the next cut and have a look at the resulting sequence.

  Currently editing marks can only be set at I-frames, which typically is
  every 12th frame. So editing can be done with a resolution of roughly half
  a second. A "start" mark marks the first frame of a resulting video
  sequence, and an "end" mark marks the last frame of that sequence.

  An edited recording (indicated by the '%' character) will never be deleted
  automatically in case the disk runs full (no matter what "lifetime" it has).

* Programming the Timer

  Use the "Timer" menu to maintain your list of timer controlled recordings.
  The parameters in the "Edit timer" menu have the following meanings:

  Active:    Defines whether the timer will be processed (set it to 'no' to
             temporarily disable a timer).
  Channel:   The channel to be recorded (as defined in the "Channels" list).
             Any changes made in the "Channels" list (like renaming or
             reordering channels) will be automatically reflected in the
             timers settings.
  Day:       The day on which this timer shall start. This can be a
             date (like 2005-03-19), which allows programming a "single shot"
             timer that hits once and is deleted after it ends.
             Another option here are "repeating timers" which are defined
             by listing the days of the week on which they shall record.
             For example, a timer that shall record every Monday and Wednesday
             would have a Day setting of "M-W----".
             The '0' key toggles between a single shot and a repeating timer.
             If "Day" indicates a repeating timer, the keys '1'...'7' can be
             used to toggle the individual days ('1' is Monday).
             You can also switch to a set of predefined repeating timer settings
             by pressing the "Left" key when the day is the present day. To return
             to the single shot mode just press "Right" until a date is displayed.
  Start:     The start time of the timer in hh:mm as 24 hour ("military") time.
  Stop:      The stop time of the timer.
  VPS:       Defines whether the timer shall use VPS (if available). If this
             option is set to 'yes', the start time must exactly match the
             programme's VPS time, otherwise nothing will be recorded. If VPS
             is used, the stop time has no real meaning. However, it must be
             different than the start time, and should correspond to the actual
             stop time of the programme, just in case there is no real VPS data
             available at the time of recording, so VDR has to fall back to
             normal timer recording.
  Priority:  The Priority (0..99) is used to decide which timer shall be
             started in case there are two or more timers with the exact same
             start time. The first timer in the list with the highest Priority
             will be used. This value is also stored with the recording and is
             later used to decide which recording to remove from disk in order
             to free space for a new recording. If the disk is full and a new
             recording needs more space, an existing recording with the lowest
             Priority (and which has exceeded its guaranteed Lifetime) will be
             removed. If all available DVB cards are currently occupied, a
             timer with a higher priority will interrupt the timer with the
             lowest priority in order to start recording.
  Lifetime:  The number of days (0..99) a recording made through this timer is
             guaranteed to remain on disk before it is automatically removed
             to free up space for a new recording. Note that setting this
             parameter to very high values for all recordings may soon fill up
             the entire disk and cause new recordings to fail due to low disk
             space. The special value 99 means that this recording will live
             "forever", and a value of 0 means that this recording can be
             deleted any time if a recording with a higher priority needs disk
             space.
  File:      The name under which a recording created through this timer will
             be stored on disk (the actual name will also contain the date and
             time, so it is possible to have a "repeating timer" store all its
             recordings under the same name; they will be distinguishable by
             their date and time).
             If the file name contains the special character '~', the recording
             will be stored in a hierarchical directory structure. For instance,
             a file name of "Sci-Fi~Star Trek~Voyager" will result in a directory
             structure "/video/Sci-Fi/Star_Trek/Voyager". The '~' character has
             been chosen for this since the file system's directory delimiter '/'
             may be part of a regular programme name.
             Repeating timers create recordings that contain the 'Episode name'
             information from the EPG data in their file name. Typically (on tv
             stations that care about their viewers) this contains the episode
             title of a series. The episode name is appended to the timer's file name,
             separated by a '~' character, so that it results in all recordings
             of this timer being collected in a common subdirectory.
             If this field is left blank, the channel name will be used to form
             the name of the recording.
  First day: The date of the first day when this timer shall start recording
             (only available for repeating timers).

  A timer can also be programmed by pressing the "Red" key on the "Schedule",
  "Now", "Next" or "Event" menus.

* Parameters in the "Setup" menu

  Select "Setup" from the "VDR" menu to enter the setup menu. From there you can
  modify the following system parameters (note that "boolean" values will be
  displayed as "no" and "yes" in the "Setup" menu, while in the setup file they
  are stored as '0' and '1', respectively):

  OSD:

  Language = English     Defines the language used to display the OSD texts.

  Skin = ST:TNG Panels   Defines the "skin" used to display the OSD menus.

  Theme = Default        Defines the "theme" to use with the current skin.

  Left = 54              The top and left offset of the OSD.
  Top = 45               The valid ranges are left=0...672, top=0...567.

  Width = 624            The width and height of the OSD.
  Height = 486           The valid ranges are width=480...672, height=324...567.
                         The Width must be a multiple of 8.

  Message time = 1       The time (in seconds) how long an informational
                         message shall be displayed on the OSD. The valid range
                         is 1...60.

  Use small font = 1     Defines whether the small font shall be used. 0 means never
                         use the small font, 1 means use the small font wherever the
                         current skin wants to, and 2 means always use the small
                         font.

  Anti-alias = 1         Controls whether the OSD uses "anti-aliasing" to improve
                         font rendering. To make this work, the OSD must support
                         at least 256 colors, and the skin in use has to
                         utilize these. If either of these conditions is not met,
                         rendering will be done without anti-aliasing.

  Default font = Sans Serif:Bold
  Small font = Sans Serif
  Fixed font = Courier:Bold
                         The names of the various fonts to use.

  Default font size = 22
  Small font size = 18
  Fixed font size = 20
                         The sizes (in pixel) of the various fonts. Valid range is
                         10...64.

  Channel info position = bottom
                         The position of the channel info window in the OSD
                         (either 'bottom' or 'top').

  Channel info time = 5  The time (in seconds) after which the channel info display
                         is removed if no key has been pressed.

  Info on channel switch = yes
                         Turns the display of the current/next information on
                         or off when switching the channel. The information is
                         always displayed when pressing the "Ok" key in
                         normal viewing mode.

  Timeout requested channel info = yes
                         Turns the automatic timeout of the channel display (when
                         invoked by a press of the "Ok" key) on or off.

  Scroll pages = yes     no  = when pressing the "Down" ("Up") key while the cursor
                               is on the last (first) line of a list page, the
                               list is scrolled down (up) a single line and the cursor will
                               remain at the bottom (top) of that page
                         yes = the list is scrolled down (up) a full page and the cursor
                               will be at the top (bottom) of that page (this mode allows
                               for faster scrolling through long lists).

  Scroll wraps = no      no  = when the end (beginning) of a list is reached while
                               moving the cursor through it, the cursor stays at the
                               last (first) line of the list
                         yes = the cursor "wraps around" and moves from the last
                               (first) line of the list directly to the first (last)
                               one.

  Menu key closes = no
                         If set to "yes", pressing the "Menu" key while there is
                         anything displayed on the OSD will close the OSD. If set
                         to "no", the "Menu" key will open the main menu after
                         closing a temporary display, like, for instance, the channel
                         display.

  Recording directories = yes
                         Turns displaying the Recordings menu as a hierarchical
                         directory structure on or off.

  EPG:

  EPG scan timeout = 5   The time (in hours) of user inactivity after which the
                         DVB card in a single card system starts scanning channels
                         to keep the EPG up-to-date.
                         A value of '0' completely turns off scanning on both single
                         and multiple card systems.

  EPG bugfix level = 3   Some tv stations transmit weirdly formatted EPG data.
                         VDR attempts to fix these bugs up to the given level:
                         0 = no EPG fixing
                         1 = basic fixing of text location (Title, Episode and
                             Extended Description)
                         2 = removal of excess whitespace and hyphens, mapping of
                             wrongly used characters
                         3 = fix stream component descriptions
                         Default is '3'.
                         Note that after changing the setting of this parameter
                         any EPG data that has already been received will remain
                         in its existing format - only newly received data will
                         be fixed accordingly. Restart VDR if you want to make sure
                         all data is fixed.

  EPG linger time = 0    The time (in minutes) within which old EPG information
                         shall still be displayed in the "Schedule" menu.

  Set system time = no   Defines whether the system time will be set according to
                         the time received from the DVB data stream.
                         Note that this works only if VDR is running under a user
                         id that has permission to set the system time. You also
                         need to set the option "Use time from transponder" to a
                         channel that you trust to transmit a reliable time base
                         (not all channels seem to have access to a correct time
                         base...).

  Use time from transponder = 0
                         The frequency of the transponder that shall be used to
                         set the system time. The Setup menu will offer the full
                         list of channels, even if several of them are on the
                         same transponder. Also, when selecting a channel, saving
                         the Setup and opening the Setup menu again, there may be
                         a different channel listed here, since the first one
                         in 'channels.conf' that is on the given transponder will
                         be taken. Note that in order to set the system time from
                         the transponder data the option "Set system time" must also
                         be enabled.

  Preferred languages = 0
                         Some tv stations broadcast their EPG data in various
                         different languages. This option allows you to define
                         which language(s) you prefer in such cases. By default,
                         or if none of the preferred languages is broadcast, any
                         language will be accepted and the EPG data will be
                         displayed in the first language received from the data
                         stream. If this option is set to a non-zero value, the
                         menu page will contain that many "Preferred language"
                         options which allow you to select the individual preferred
                         languages. If an actual EPG data record is received in
                         different languages, the preferred languages are checked
                         in the given order to decide which one to take.

  Scan                   The "Red" key in the "Setup/EPG" menu can be used to
                         force an EPG scan on a single DVB card system. If pressed,
                         and the primary DVB device is currently not recording or
                         replaying, it will loop through the transponders once and
                         then switch back to the original channel. Any user activity
                         during the EPG scan will also stop the scan and bring back
                         the original channel.

  DVB:

  Primary DVB interface = 1
                         Defines the primary DVB interface (i.e. the one that
                         will display the menus and will react on input through
                         the remote control). Valid values range from '1' to the
                         number of installed DVB cards. If more than one DVB card
                         is installed and a recording is to be started, the
                         program will try to use a free DVB card that is different
                         from the primary DVB interface, so that the viewer will
                         be disturbed as little as possible.

  Video format = 4:3     The video format (or aspect ratio) of the tv set in use
                         (4:3 or 16:9).

  Video display format = letterbox
                         The display format to use for playing wide screen video on
                         a 4:3 tv set ("pan & scan", "letterbox" or "center cut out").
                         This option is only available if "Video format" is set to
                         4:3.

  Use Dolby Digital = yes
                         Turns recording of the Dolby Digital audio channels on
                         or off. This may be useful if you don't have the equipment
                         to replay Dolby Digital audio and want to save disk space.
                         If turned off, Dolby Digital tracks also don't appear in the
                         "Audio" menu.

  Update channels = 5    Controls the automatic channel update function. '0' means
                         no update, '1' will only update channel names, '2' will
                         only update PIDs, '3' will update channel names and PIDs,
                         '4' will perform all updates and also add newly found channels,
                         and '5' will also add newly found transponders.

  Audio languages = 0    Some tv stations broadcast various audio tracks in different
                         languages. This option allows you to define which language(s)
                         you prefer in such cases. By default, or if none of the
                         preferred languages is broadcast, the first audio track will
                         be selected when switching to such a channel. If this option
                         is set to a non-zero value, the menu page will contain that
                         many "Audio language" options which allow you to select the
                         individual preferred languages.

  Display subtitles = no If set to 'yes', the first available subtitles in the list
                         of preferred subtitle languages will be turned on when
                         switching to a channel that provides subtitles.

  Subtitle languages = 0 Some tv stations broadcast various subtitle tracks in different
                         languages. This option allows you to define which language(s)
                         you prefer in such cases. By default, or if none of the
                         preferred languages is broadcast, no subtitles will
                         be selected when switching to such a channel. If this option
                         is set to a non-zero value, the menu page will contain that
                         many "Subtitle language" options which allow you to select the
                         individual preferred languages.

  Subtitle offset = 0    Allows you to shift the location of the subtitles in the
                         vertical direction. The valid range is -50...50. This option
                         is only avialable if "Display subtitles" is set to 'yes'.

  Subtitle foreground transparency = 0
  Subtitle background transparency = 0
                         These define an additional level of transparency for the
                         foreground and background color of subtitles. Valid ranges
                         are 0...9 for foreground transparency, and 0...10 for
                         background transparency. By default the values as broadcast
                         are used.

  LNB:

  SLOF               = 11700  The switching frequency (in MHz) between low and
                              high LOF
  Low LNB frequency  =  9750  The LNB's low and high local oscillator frequencies
  High LNB frequency = 10600  (in MHz, these have no meaning for DVB-C receivers)

  Use DiSEqC = no        Generally turns DiSEqC support on or off.

  CAM:

  n CAM Name             Shows the CAM slots that are present in this system, where
                         'n' is the number of the slot, followed by the name of the
                         CAM. If a CAM slot is empty, '-' is displayed as name, and
                         if it is in the process of being reset, its current status
                         is displayed.  The "Red" key can be pressed to enter the CAM
                         menu, and the "Green" key triggers a reset of the selected
                         slot. The "Ok" key also opens the CAM menu.

  Recording:

  Margin at start = 2    Defines how many minutes before the official start time
  Margin at stop = 10    of a broadcast VDR shall start recording, and how long
                         after the official end time it shall stop recording.
                         These margins are added automatically to timers that
                         are created from the EPG data.

  Primary limit = 0      The minimum priority a timer must have to be allowed to
                         use the primary DVB interface, or to force another timer
                         with higher priority to use the primary DVB interface.
                         This is mainly useful for recordings that should take
                         place only when there is nothing else to do, but should
                         never keep the user from viewing stuff on the primary
                         interface. On systems with only one DVB card, timers
                         with a priority below PrimaryLimit will never execute.

  Default priority = 50  The default Priority and Lifetime values used when
  Default lifetime = 99  creating a new timer event. A Lifetime value of 99
                         means that this recording will never be deleted
                         automatically.

  Pause priority = 10    The Priority and Lifetime values used when pausing live
  Pause lifetime = 1     video.

  Use episode name = yes Repeating timers use the EPG's 'Episode name' information
                         to create recording file names in a hierarchical structure
                         (for instance to gather all episodes of a series in a
                         common subdirectory). This parameter can be used to
                         control this.
                         no  = don't use the 'Episode name'
                         yes = use it (and create subdirectories)

  Use VPS = 0            Defines whether a timer that is created from an EPG entry
                         (by pressing the "Record" (red) key in the "Schedules"
                         or "What's on now/next?" menu) will automatically use VPS
                         if the event it is created for has a VPS time.

  VPS margin = 120       Defines how many seconds before a VPS controlled timer is
                         scheduled to start, VDR will make sure that one of the DVB
                         devices is tuned to the transponder that timer shall record
                         from. This is necessary for the "Running Status" information
                         that is broadcast in the EPG data to be seen by VDR.

  Mark instant recording = yes
                         Defines whether an "instant recording" (started by
                         pressing the "Red" key in the "VDR" menu) will be
                         marked with a '@' character to make it distinguishable
                         from timer recordings in the "Recordings" menu.

  Name instant recording = TITLE EPISODE
                         Defines how to name an instant recording. If the keywords
                         TITLE and/or EPISODE are present, they will be replaced
                         with the title and episode information from the EPG data
                         at the time of recording (if that data is available).
                         If this parameter is empty, the channel name will be used
                         by default.

  Instant rec. time = 180
                         Defines the duration of an instant recording in minutes.
                         Default is 180 minutes (3 hours). The stop time of an
                         instant recording can be modified at any time by editing
                         the respective timer in the "Timers" menu.

  Max. video file size = 2000
                         The maximum size of a single recorded video file in MB.
                         The valid range is 100...2000. Default is 2000, but
                         you may want to use smaller values if you are planning
                         on archiving a recording to CD.

  Split edited files = no
                         During the actual editing process VDR writes the result
                         into files that may grow up to MaxVideoFileSize. If you
                         prefer to have each marked sequence stored in a separate
                         file (named 001.vdr, 002.vdr, ...) you can set this
                         option to 'yes'.

  Replay:

  Multi speed mode = no  Defines the function of the "Left" and "Right" keys in
                         replay mode. If set to 'no', one speed will be used, while
                         if set to 'yes' there will be three speeds for fast and slow
                         search, respectively.

  Show replay mode = no  Turns displaying the current replay mode on or off.

  Resume ID = 0          Defines an additional ID that can be used in a multi user
                         environment, so that every user has his/her own resume
                         files for each recording. The valid range is 0...99, with
                         0 resulting in a file named 'resume.vdr', and any other
                         value resulting in 'resume.n.vdr'.

  Miscellaneous:

  Min. event timeout = 30
  Min. user inactivity = 300
                         If the command line option '-s' has been set, VDR will
                         automatically shutdown the computer if the next timer
                         event is at least MinEventTimeout minutes in the future,
                         and the user has been inactive for at least
                         MinUserInactivity minutes. Setting MinUserInactivity
                         to 0 disables the automatic shutdown, while still
                         retaining the possibility to manually shutdown the
                         computer.

  SVDRP timeout = 300    The time (in seconds) of inactivity on an open SVDRP
                         connection after which the connection is automatically
                         closed. Default is 300, a value of 0 means no timeout.

  Zap timeout = 3        The time (in seconds) until a channel counts as "previous"
                         for switching with '0'

  Channel entry timeout = 1000
                         The time (in milliseconds) after the last keypress until
                         a numerically entered channel number is considered
                         complete, and the channel is switched. Default is 1000,
                         a value of 0 turns this off, so a numerically entered
                         channel number then needs to be confirmed with the "Ok"
                         key. Note that the total maximum is also limited by
                         the "OSD/Channel info time" parameter.

  Initial channel = 0    The number of the channel that shall be tuned to when
                         VDR starts. Default is 0, which means that it will
                         tune to the channel that was on before VDR was stopped.

  Initial volume = -1    The volume that shall be set when VDR starts. Default
                         is -1, which means that the same volume as before
                         VDR was stopped will be used. The valid range is from
                         0 (silent) to 255 (loudest).

  Emergency exit = yes   If, for some reason, a recording fails because the video
                         data stream is broken, or the CAM doesn't decrypt etc.,
                         VDR automatically exits in order to allow the surrounding
                         wrapper script to reload the DVB drivers. If this option
                         is set to 'no', the "emergency exit" will be ignored,
                         hoping that the problem will go away by itself (as, for
                         instance, with bad weather conditions).

* Executing system commands

  The "VDR" menu option "Commands" allows you to execute any system commands
  defined in the configuration file 'commands.conf' (see vdr(5) for details).
  The "Commands" option will only be present in the "VDR" menu if a valid
  'commands.conf' file containing at least one command definition has been
  found at program start.

  This feature can be used to do virtually anything, like checking for new
  mail, displaying the CPU temperature - you name it! All you need to do is
  enter the necessary command definition into 'commands.conf' and implement
  the actual command that will be called. Such a command can typically be a
  shell script or a Perl program. Anything that command writes to stdout will
  be displayed on a result screen after executing the command. This screen will
  use a 'fixed' font so that you can generate formatted output. In order to
  avoid error messages going to stderr, command definitions should redirect
  stderr to stdout (see vdr(5)).

  WARNING: THE COMMANDS DEFINED IN 'commands.conf' WILL BE EXECUTED UNDER THE
  =======  SAME USER ID THAT VDR IS RUNNING WITH. BE VERY CAREFUL WHEN
           DEFINING THESE COMMANDS AND MAKE SURE THEY DON'T HARM YOUR SYSTEM,
           ESPECIALLY IF YOU ARE RUNNING VDR UNDER A HIGH PRIVILEGED USER ID
           (LIKE 'root').