frodovdr/vdr
1
0
Fork 0
mirror of https://github.com/vdr-projects/vdr.git synced 2025-03-01 10:50:46 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated VDR manual (MANUAL) (markdown)

Manuel Reimer 2023-09-18 16:29:09 +02:00
parent 8c5aabbeb9
commit 0fd3e87885
1 changed files with 394 additions and 394 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

788
VDR-manual-(MANUAL).md

@ -9,20 +9,20 @@
possible, several keys have different meanings in the various possible, several keys have different meanings in the various
modes: modes:
Key Normal VDR Channels Timers Edit/New Recordings Replay Audio 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 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 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 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 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 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 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 Back - Menu off VDR menu VDR menu Discard VDR menu Recordings menu Close
Red - Record Edit On/Off ABC/abc Play/Commands(1) Jump - Red - Record Edit On/Off ABC/abc Play/Commands(1) Jump -
Green - Audio New New Ins/Ovr Rewind Skip -60s - Green - Audio New New Ins/Ovr Rewind Skip -60s -
Yellow - Pause live Delete Delete Delete Delete Skip +60s - Yellow - Pause live Delete Delete Delete Delete Skip +60s -
Blue - Stop/Resume Mark Info - Info Stop - Blue - Stop/Resume Mark Info - Info Stop -
0..9 Ch select - Sort(2) Day(3) Numeric inp. Sort/Exec cmd(1) Editing - 0..9 Ch select - Sort(2) Day(3) Numeric inp. Sort/Exec cmd(1) Editing -
In a numerical input field (like the response to a CAM enquiry) the keys 0..9 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 are used to enter the data, and the Left key can be used to delete the last
@ -35,50 +35,50 @@
If your remote control provides additional keys, they can be used for the If your remote control provides additional keys, they can be used for the
following functions: following functions:
Info display information on the currently viewed programme or recording, Info display information on the currently viewed programme or recording,
or on the current item in a menu or on the current item in a menu
Play/Pause combined key to resume or pause replay, or pause live video Play/Pause combined key to resume or pause replay, or pause live video
Play resume normal replay Play resume normal replay
Pause pause replay or live video Pause pause replay or live video
Stop stop replay Stop stop replay
Record instant recording Record instant recording
FastFwd fast forward FastFwd fast forward
FastRew fast rewind FastRew fast rewind
Next Next/previous channel group (in live tv mode) Next Next/previous channel group (in live tv mode)
Prev or next/previous editing mark (in replay mode) Prev or next/previous editing mark (in replay mode)
Channel+ channel up Channel+ channel up
Channel- channel down Channel- channel down
PrevChannel previous channel PrevChannel previous channel
Power shutdown Power shutdown
Volume+ volume up Volume+ volume up
Volume- volume down Volume- volume down
Mute mute Mute mute
Audio select audio track Audio select audio track
Subtitles select subtitles Subtitles select subtitles
Schedule \ Schedule \
Channels | Channels |
Timers | directly access the VDR Timers | directly access the VDR
Recordings | main menu functions Recordings | main menu functions
Setup | Setup |
Commands / Commands /
User1...9 additional user defined keys for macro functions User1...9 additional user defined keys for macro functions
(defined in 'keymacros.conf') (defined in 'keymacros.conf')
Note that in normal viewing mode (no OSD active) the color keys can have user Note that in normal viewing mode (no OSD active) the color keys can have user
defined functionality, as configured in 'keymacros.conf'. defined functionality, as configured in 'keymacros.conf'.
The default assignment is The default assignment is
Red Recordings menu Red Recordings menu
Green Schedule menu Green Schedule menu
Yellow Info Yellow Info
Blue Timers menu Blue Timers menu
(1) See "Sort Recordings" and "Processing Recordings" below. (1) See "Sort Recordings" and "Processing Recordings" below.
(2) In the "Channels" menu the '0' key switches the sort mode through "by number", (2) In the "Channels" menu the '0' key switches the sort mode through "by number",
@ -174,12 +174,12 @@
The following markers in these menus give additional information about the The following markers in these menus give additional information about the
status of the events: 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 only part of the event
T there is a timer defined for this event which covers the entire 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 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 * this event is currently running (the validity of this marker depends on
whether there is currently a DVB card receiving the transponder this channel whether there is currently a DVB card receiving the transponder this channel
is on). is on).
Pressing '0' in the "Schedule" menu rotates through displaying "This event 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 channel", "This event on all channels" and "All events on all channels".
@ -324,70 +324,70 @@
The following keys have the listed meaning in Replay mode: The following keys have the listed meaning in Replay mode:
- Up Resumes normal replay from any "pause", "forward" or "backward" - Up Resumes normal replay from any "pause", "forward" or "backward"
mode. mode.
- Down Halts playback at the current position. Press again to continue - Down Halts playback at the current position. Press again to continue
playback. playback.
- Blue Stops playback and stores the current position, so that - Blue Stops playback and stores the current position, so that
playback can be resumed later at that point. playback can be resumed later at that point.
- Left - Left
Right Runs playback forward or backward at a higher speed; press Right Runs playback forward or backward at a higher speed; press
again to resume normal speed. If in Pause mode, runs forward or again to resume normal speed. If in Pause mode, runs forward or
backward at a slower speed; press again to return to pause mode. backward at a slower speed; press again to return to pause mode.
Pressing and holding down the key performs the function until Pressing and holding down the key performs the function until
the key is released again. the key is released again.
If "Multi Speed Mode" has been enabled in the "Setup" menu, the If "Multi Speed Mode" has been enabled in the "Setup" menu, the
function of these keys changes in a way that gives you three function of these keys changes in a way that gives you three
fast and slow speeds, through which you can switch by pressing fast and slow speeds, through which you can switch by pressing
the respective key several times. the respective key several times.
- Red Jump to a specific location. Enter the time you want to jump to - 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 and then press "Left" or "Right" to jump relative to the current
position, "Up" to jump to an absolute position, and "Down" to position, "Up" to jump to an absolute position, and "Down" to
jump and pause at an absolute position. jump and pause at an absolute position.
- Green - Green
Yellow Skips about 60 seconds back or forward. Yellow Skips about 60 seconds back or forward.
Pressing and holding down the key performs the function until Pressing and holding down the key performs the function until
the key is released again. the key is released again.
- Ok Brings up the replay progress display, which shows the date, - Ok Brings up the replay progress display, which shows the date,
time and title of the recording, a progress bar and the time and title of the recording, a progress bar and the
current and total time of the recording. current and total time of the recording.
Press "Ok" again to turn off the progress display. Press "Ok" again to turn off the progress display.
- Back Stops replaying and brings up the "Recordings" menu. This can be - Back Stops replaying and brings up the "Recordings" menu. This can be
used to easily delete a recording after watching it, or to switch used to easily delete a recording after watching it, or to switch
to a different recording. to a different recording.
## Editing a Recording ## Editing a Recording
While in Replay mode, the following keys can be used to manipulate editing While in Replay mode, the following keys can be used to manipulate editing
marks: marks:
- 0 Toggles an editing mark. If the mark indicator shows a red triangle, - 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 the current mark is deleted. Otherwise a new mark is set at the
current position. current position.
- 1, 3 Move an editing mark back and forward in "adaptive" mode. Pressing - 1, 3 Move an editing mark back and forward in "adaptive" mode. Pressing
either of these keys for the first time moves the mark 120 seconds either of these keys for the first time moves the mark 120 seconds
in the given direction (configurable via "Setup/Replay/Initial in the given direction (configurable via "Setup/Replay/Initial
duration for adaptive skipping"). Further presses of the same key duration for adaptive skipping"). Further presses of the same key
keep moving the mark by the same value. Once the other key is keep moving the mark by the same value. Once the other key is
pressed, the value is divided by 2 (hence the name "adaptive") with pressed, the value is divided by 2 (hence the name "adaptive") with
every further press of either key. Pressing '1' and '3' every further press of either key. Pressing '1' and '3'
alternatingly divides the distance all the way down to a single alternatingly divides the distance all the way down to a single
I-frame. That way a particular place in a recording (for instance I-frame. That way a particular place in a recording (for instance
the beginning or end of a commercial break) can be found very the beginning or end of a commercial break) can be found very
quickly. If none of these two keys is pressed for a while quickly. If none of these two keys is pressed for a while
(configurable via "Setup/Replay/Reset timeout for adaptive (configurable via "Setup/Replay/Reset timeout for adaptive
skipping") the distance falls back to the initial value. skipping") the distance falls back to the initial value.
If replay is not in Pause mode, or if there is no mark at the If replay is not in Pause mode, or if there is no mark at the
current position, the skip is performed without moving any mark. current position, the skip is performed without moving any mark.
- 4, 6 Move an editing mark back and forward by one I-frame. You need to - 4, 6 Move an editing mark back and forward by one I-frame. You need to
first jump to an editing mark for this to work. first jump to an editing mark for this to work.
- 7, 9 Jump back and forward between editing marks. Replay goes into still - 7, 9 Jump back and forward between editing marks. Replay goes into still
mode after jumping to a mark. If the current position is at the mode after jumping to a mark. If the current position is at the
first or last mark, or if there are no marks at all, these keys first or last mark, or if there are no marks at all, these keys
jump to the very beginning or end, respectively, of the recording. jump to the very beginning or end, respectively, of the recording.
- 8 Positions replay at a point 3 seconds before the current or next - 8 Positions replay at a point 3 seconds before the current or next
"begin" mark and starts replay. "begin" mark and starts replay.
- 2 Starts the actual cutting process. - 2 Starts the actual cutting process.
Editing marks are represented by black, vertical lines in the progress display. 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 "begin" A small black triangle at the top of the mark means that this is a "begin"
@ -429,81 +429,81 @@
Use the "Timer" menu to maintain your list of timer controlled recordings. Use the "Timer" menu to maintain your list of timer controlled recordings.
The parameters in the "Edit timer" menu have the following meanings: The parameters in the "Edit timer" menu have the following meanings:
Active: Defines whether the timer will be processed (set it to 'no' to Active: Defines whether the timer will be processed (set it to 'no' to
temporarily disable a timer). temporarily disable a timer).
Channel: The channel to be recorded (as defined in the "Channels" list). Channel: The channel to be recorded (as defined in the "Channels" list).
Any changes made in the "Channels" list (like renaming or Any changes made in the "Channels" list (like renaming or
reordering channels) will be automatically reflected in the reordering channels) will be automatically reflected in the
timers settings. timers settings.
Day: The day on which this timer shall start. This can be a Day: The day on which this timer shall start. This can be a
date (like 2005-03-19), which allows programming a "single shot" date (like 2005-03-19), which allows programming a "single shot"
timer that hits once and is deleted after it ends. timer that hits once and is deleted after it ends.
Another option here are "repeating timers" which are defined Another option here are "repeating timers" which are defined
by listing the days of the week on which they shall record. by listing the days of the week on which they shall record.
For example, a timer that shall record every Monday and Wednesday For example, a timer that shall record every Monday and Wednesday
would have a Day setting of "M-W----". would have a Day setting of "M-W----".
The '0' key toggles between a single shot and a repeating timer. The '0' key toggles between a single shot and a repeating timer.
If "Day" indicates a repeating timer, the keys '1'...'7' can be If "Day" indicates a repeating timer, the keys '1'...'7' can be
used to toggle the individual days ('1' is Monday). used to toggle the individual days ('1' is Monday).
You can also switch to a set of predefined repeating timer settings 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 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. 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. Start: The start time of the timer in hh:mm as 24 hour ("military") time.
Stop: The stop time of the timer. Stop: The stop time of the timer.
VPS: Defines whether the timer shall use VPS (if available). If this VPS: Defines whether the timer shall use VPS (if available). If this
option is set to 'yes', the start time must exactly match the option is set to 'yes', the start time must exactly match the
programme's VPS time, otherwise nothing will be recorded. If VPS programme's VPS time, otherwise nothing will be recorded. If VPS
is used, the stop time has no real meaning. However, it must be is used, the stop time has no real meaning. However, it must be
different than the start time, and should correspond to the actual 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 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 available at the time of recording, so VDR has to fall back to
normal timer recording. normal timer recording.
Priority: The Priority (0..99) is used to decide which timer shall be 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 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 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 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 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 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 recording needs more space, an existing recording with the lowest
Priority (and which has exceeded its guaranteed Lifetime) will be Priority (and which has exceeded its guaranteed Lifetime) will be
removed. If all available DVB cards are currently occupied, a removed. If all available DVB cards are currently occupied, a
timer with a higher priority will interrupt the timer with the timer with a higher priority will interrupt the timer with the
lowest priority in order to start recording. lowest priority in order to start recording.
Lifetime: The number of days (0..99) a recording made through this timer is Lifetime: The number of days (0..99) a recording made through this timer is
guaranteed to remain on disk before it is automatically removed guaranteed to remain on disk before it is automatically removed
to free up space for a new recording. Note that setting this to free up space for a new recording. Note that setting this
parameter to very high values for all recordings may soon fill up 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 the entire disk and cause new recordings to fail due to low disk
space. The special value 99 means that this recording will live space. The special value 99 means that this recording will live
"forever", and a value of 0 means that this recording can be "forever", and a value of 0 means that this recording can be
deleted any time if a recording with a higher priority needs disk deleted any time if a recording with a higher priority needs disk
space. space.
Pattern: The pattern to use for recordings matching events (only available Pattern: The pattern to use for recordings matching events (only available
for pattern timers). See section "Pattern timers" below. for pattern timers). See section "Pattern timers" below.
File: The name under which a recording created through this timer will 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 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 time, so it is possible to have a "repeating timer" store all its
recordings under the same name; they will be distinguishable by recordings under the same name; they will be distinguishable by
their date and time). their date and time).
If the file name contains the special character '~', the recording If the file name contains the special character '~', the recording
will be stored in a hierarchical directory structure. For instance, will be stored in a hierarchical directory structure. For instance,
a file name of "Sci-Fi~Star Trek~Voyager" will result in a directory a file name of "Sci-Fi~Star Trek~Voyager" will result in a directory
structure "/video/Sci-Fi/Star_Trek/Voyager". The '~' character has structure "/video/Sci-Fi/Star_Trek/Voyager". The '~' character has
been chosen for this since the file system's directory delimiter '/' been chosen for this since the file system's directory delimiter '/'
may be part of a regular programme name. may be part of a regular programme name.
Repeating timers create recordings that contain the 'Episode name' Repeating timers create recordings that contain the 'Episode name'
information from the EPG data in their file name. Typically (on tv information from the EPG data in their file name. Typically (on tv
stations that care about their viewers) this contains the episode 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, 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 separated by a '~' character, so that it results in all recordings
of this timer being collected in a common subdirectory. of this timer being collected in a common subdirectory.
If this field is left blank, the channel name will be used to form If this field is left blank, the channel name will be used to form
the name of the recording. the name of the recording.
First day: The date of the first day when this timer shall start recording First day: The date of the first day when this timer shall start recording
(only available for repeating timers). (only available for repeating timers).
Record on: The name of the remote VDR this timer shall record on (only available Record on: The name of the remote VDR this timer shall record on (only available
if there are any remote VDRs connected to this VDR). If this field if there are any remote VDRs connected to this VDR). If this field
is empty, the timer will record on the local VDR. is empty, the timer will record on the local VDR.
A timer can also be programmed by pressing the "Red" key on the "Schedule", A timer can also be programmed by pressing the "Red" key on the "Schedule",
"Now", "Next" or "Event" menus. "Now", "Next" or "Event" menus.
@ -603,24 +603,24 @@ in the file donerecs.data, so that multiple recordings of the same programme can
avoided. When using this feature, special care must be taken regarding the recording's avoided. When using this feature, special care must be taken regarding the recording's
file name. For instance, with a combination of file name. For instance, with a combination of
pattern file name pattern file name
@Columbo Movies~TITLE @Columbo Movies~TITLE
if the event's title is just "Columbo", this pattern timer would only record once, if the event's title is just "Columbo", this pattern timer would only record once,
and ignore any future events with that title, even if the episode would be different. and ignore any future events with that title, even if the episode would be different.
So you may want to use the episode name, as in So you may want to use the episode name, as in
pattern file name pattern file name
@Columbo Movies~TITLE - EPISODE @Columbo Movies~TITLE - EPISODE
to make the file name unique. If you have several pattern timers for the same show on to make the file name unique. If you have several pattern timers for the same show on
different channels, chances are that the broadcasters handle title and episode different channels, chances are that the broadcasters handle title and episode
differently, as for example in differently, as for example in
TITLE EPISODE pattern file name TITLE EPISODE pattern file name
Columbo Blueprint for Murder @^Columbo$ TITLE - EPISODE Columbo Blueprint for Murder @^Columbo$ TITLE - EPISODE
Columbo - Blueprint for Murder @^Columbo TITLE Columbo - Blueprint for Murder @^Columbo TITLE
Columbo: Blueprint for Murder @^Columbo:_ Columbo - {>} Columbo: Blueprint for Murder @^Columbo:_ Columbo - {>}
(note the '_' in the pattern of the third example; this is just used to visualize (note the '_' in the pattern of the third example; this is just used to visualize
the blank at the end of the pattern) the blank at the end of the pattern)
@ -636,9 +636,9 @@ poses a problem, because everything is in the title, but with a different separa
Here the special macro "{>}" can be used in the file name, which contains everything Here the special macro "{>}" can be used in the file name, which contains everything
following the matching pattern. There are three macros that can be used here: following the matching pattern. There are three macros that can be used here:
{<} everything before the matching pattern {<} everything before the matching pattern
{>} everything after the matching pattern {>} everything after the matching pattern
{=} the matching pattern itself (just for completeness) {=} the matching pattern itself (just for completeness)
As of VDR version 2.5.2, the characters ' ' (blank), ':' and '-' are ignored As of VDR version 2.5.2, the characters ' ' (blank), ':' and '-' are ignored
when checking whether a particular recording has already been made by a pattern when checking whether a particular recording has already been made by a pattern
@ -700,34 +700,34 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
OSD: OSD:
Language = English Defines the language used to display the OSD texts. Language = English Defines the language used to display the OSD texts.
Skin = ST:TNG Panels Defines the "skin" used to display the OSD menus. Skin = ST:TNG Panels Defines the "skin" used to display the OSD menus.
Theme = Default Defines the "theme" to use with the current skin. Theme = Default Defines the "theme" to use with the current skin.
Left = 8 The left and top offset of the OSD, in percent of the Left = 8 The left and top offset of the OSD, in percent of the
Top = 8 total video display width and height, respectively. Top = 8 total video display width and height, respectively.
The valid range is 0...50%. The valid range is 0...50%.
Width = 87 The width and height of the OSD, in percent of the Width = 87 The width and height of the OSD, in percent of the
Height = 84 total video display width and height, respectively. Height = 84 total video display width and height, respectively.
The valid range is 50...100%. The valid range is 50...100%.
Message time = 1 The time (in seconds) how long an informational Message time = 1 The time (in seconds) how long an informational
message shall be displayed on the OSD. The valid range message shall be displayed on the OSD. The valid range
is 1...60. is 1...60.
Use small font = 1 Defines whether the small font shall be used. 0 means never 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 use the small font, 1 means use the small font wherever the
current skin wants to, and 2 means always use the small current skin wants to, and 2 means always use the small
font. font.
Anti-alias = 1 Controls whether the OSD uses "anti-aliasing" to improve Anti-alias = 1 Controls whether the OSD uses "anti-aliasing" to improve
font rendering. To make this work, the OSD must support font rendering. To make this work, the OSD must support
at least 256 colors, and the skin in use has to at least 256 colors, and the skin in use has to
utilize these. If either of these conditions is not met, utilize these. If either of these conditions is not met,
rendering will be done without anti-aliasing. rendering will be done without anti-aliasing.
Default font = Sans Serif:Bold Default font = Sans Serif:Bold
Small font = Sans Serif Small font = Sans Serif
@ -745,8 +745,8 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
The position of the channel info window in the OSD The position of the channel info window in the OSD
(either 'bottom' or 'top'). (either 'bottom' or 'top').
Channel info time = 5 The time (in seconds) after which the channel info display Channel info time = 5 The time (in seconds) after which the channel info display
is removed if no key has been pressed. is removed if no key has been pressed.
Info on channel switch = yes Info on channel switch = yes
Turns the display of the current/next information on Turns the display of the current/next information on
@ -758,20 +758,20 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
Turns the automatic timeout of the channel display (when Turns the automatic timeout of the channel display (when
invoked by a press of the "Ok" key) on or off. invoked by a press of the "Ok" key) on or off.
Scroll pages = yes no = when pressing the "Down" ("Up") key while the cursor Scroll pages = yes no = when pressing the "Down" ("Up") key while the cursor
is on the last (first) line of a list page, the is on the last (first) line of a list page, the
list is scrolled down (up) a single line and the cursor will list is scrolled down (up) a single line and the cursor will
remain at the bottom (top) of that page remain at the bottom (top) of that page
yes = the list is scrolled down (up) a full page and the cursor 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 will be at the top (bottom) of that page (this mode allows
for faster scrolling through long lists). for faster scrolling through long lists).
Scroll wraps = no no = when the end (beginning) of a list is reached while Scroll wraps = no no = when the end (beginning) of a list is reached while
moving the cursor through it, the cursor stays at the moving the cursor through it, the cursor stays at the
last (first) line of the list last (first) line of the list
yes = the cursor "wraps around" and moves from the last yes = the cursor "wraps around" and moves from the last
(first) line of the list directly to the first (last) (first) line of the list directly to the first (last)
one. one.
Menu key closes = no Menu key closes = no
If set to "yes", pressing the "Menu" key while there is If set to "yes", pressing the "Menu" key while there is
@ -810,48 +810,48 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
characters in a text input field. You may want to set this characters in a text input field. You may want to set this
to "no" if you are using an actual keyboard to control VDR. to "no" if you are using an actual keyboard to control VDR.
Color key 0 = 0 By default, VDR assumes that the sequence of the color Color key 0 = 0 By default, VDR assumes that the sequence of the color
Color key 1 = 1 keys on the remote control is red-green-yellow-blue. If Color key 1 = 1 keys on the remote control is red-green-yellow-blue. If
Color key 2 = 2 your remote control has these keys in a different sequence, Color key 2 = 2 your remote control has these keys in a different sequence,
Color key 3 = 3 you can adjust these parameters to reorder the corresponding Color key 3 = 3 you can adjust these parameters to reorder the corresponding
color buttons in the menus accordingly. Note that this does color buttons in the menus accordingly. Note that this does
not change the functionality of the individual keys; it only not change the functionality of the individual keys; it only
changes the sequence in which the color buttons are displayed. changes the sequence in which the color buttons are displayed.
EPG: EPG:
EPG scan timeout = 5 The time (in hours) of user inactivity after which the EPG scan timeout = 5 The time (in hours) of user inactivity after which the
DVB card in a single card system starts scanning channels DVB card in a single card system starts scanning channels
to keep the EPG up-to-date. to keep the EPG up-to-date.
A value of '0' completely turns off scanning on both single A value of '0' completely turns off scanning on both single
and multiple card systems. and multiple card systems.
EPG bugfix level = 3 Some tv stations transmit weirdly formatted EPG data. EPG bugfix level = 3 Some tv stations transmit weirdly formatted EPG data.
VDR attempts to fix these bugs up to the given level: VDR attempts to fix these bugs up to the given level:
0 = no EPG fixing 0 = no EPG fixing
1 = basic fixing of text location (Title, Episode and 1 = basic fixing of text location (Title, Episode and
Extended Description) Extended Description)
2 = removal of excess whitespace and hyphens, mapping of 2 = removal of excess whitespace and hyphens, mapping of
wrongly used characters wrongly used characters
3 = fix stream component descriptions 3 = fix stream component descriptions
Default is '3'. Default is '3'.
Note that after changing the setting of this parameter Note that after changing the setting of this parameter
any EPG data that has already been received will remain any EPG data that has already been received will remain
in its existing format - only newly received data will in its existing format - only newly received data will
be fixed accordingly. Restart VDR if you want to make sure be fixed accordingly. Restart VDR if you want to make sure
all data is fixed. all data is fixed.
EPG linger time = 0 The time (in minutes) within which old EPG information EPG linger time = 0 The time (in minutes) within which old EPG information
shall still be displayed in the "Schedule" menu. shall still be displayed in the "Schedule" menu.
Set system time = no Defines whether the system time will be set according to Set system time = no Defines whether the system time will be set according to
the time received from the DVB data stream. the time received from the DVB data stream.
Note that this works only if VDR is running under a user Note that this works only if VDR is running under a user
id that has permission to set the system time. You also id that has permission to set the system time. You also
need to set the option "Use time from transponder" to a need to set the option "Use time from transponder" to a
channel that you trust to transmit a reliable time base channel that you trust to transmit a reliable time base
(not all channels seem to have access to a correct time (not all channels seem to have access to a correct time
base...). base...).
Use time from transponder = 0 Use time from transponder = 0
The frequency of the transponder that shall be used to The frequency of the transponder that shall be used to
@ -879,13 +879,13 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
different languages, the preferred languages are checked different languages, the preferred languages are checked
in the given order to decide which one to take. in the given order to decide which one to take.
Scan The "Red" key in the "Setup/EPG" menu can be used to 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, force an EPG scan on a single DVB card system. If pressed,
and the primary DVB device is currently not recording or and the primary DVB device is currently not recording or
replaying, it will loop through the transponders once and replaying, it will loop through the transponders once and
then switch back to the original channel. Any user activity then switch back to the original channel. Any user activity
during the EPG scan will also stop the scan and bring back during the EPG scan will also stop the scan and bring back
the original channel. the original channel.
DVB: DVB:
@ -905,8 +905,8 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
1 = ANSI/SCTE 1 = ANSI/SCTE
2 = NORDIG 2 = NORDIG
Video format = 4:3 The video format (or aspect ratio) of the tv set in use Video format = 4:3 The video format (or aspect ratio) of the tv set in use
(4:3 or 16:9). Applies only to SD output devices. (4:3 or 16:9). Applies only to SD output devices.
Video display format = letterbox Video display format = letterbox
The display format to use for playing wide screen video on The display format to use for playing wide screen video on
@ -919,22 +919,22 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
menu. This is useful if you don't have the equipment to menu. This is useful if you don't have the equipment to
replay Dolby Digital audio. replay Dolby Digital audio.
Update channels = 5 Controls the automatic channel update function. '0' means Update channels = 5 Controls the automatic channel update function. '0' means
no update, '1' will only update channel names, '2' will no update, '1' will only update channel names, '2' will
only update PIDs, '3' will update channel names and PIDs, only update PIDs, '3' will update channel names and PIDs,
'4' will perform all updates and also add newly found channels, '4' will perform all updates and also add newly found channels,
and '5' will also add newly found transponders. and '5' will also add newly found transponders.
Note that adding new transponders only works if the "EPG scan" Note that adding new transponders only works if the "EPG scan"
is active. is active.
Audio languages = 0 Some tv stations broadcast various audio tracks in different Audio languages = 0 Some tv stations broadcast various audio tracks in different
languages. This option allows you to define which language(s) languages. This option allows you to define which language(s)
you prefer in such cases. By default, or if none of the you prefer in such cases. By default, or if none of the
preferred languages is broadcast, the first audio track will preferred languages is broadcast, the first audio track will
be selected when switching to such a channel. If this option be selected when switching to such a channel. If this option
is set to a non-zero value, the menu page will contain that is set to a non-zero value, the menu page will contain that
many "Audio language" options which allow you to select the many "Audio language" options which allow you to select the
individual preferred languages. individual preferred languages.
Display subtitles = no If set to 'yes', the first available subtitles in the list Display subtitles = no If set to 'yes', the first available subtitles in the list
of preferred subtitle languages will be turned on when of preferred subtitle languages will be turned on when
@ -949,9 +949,9 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
many "Subtitle language" options which allow you to select the many "Subtitle language" options which allow you to select the
individual preferred languages. individual preferred languages.
Subtitle offset = 0 Allows you to shift the location of the subtitles in the Subtitle offset = 0 Allows you to shift the location of the subtitles in the
vertical direction. The valid range is -100...100. This option vertical direction. The valid range is -100...100. This option
is only available if "Display subtitles" is set to 'yes'. is only available if "Display subtitles" is set to 'yes'.
Subtitle foreground transparency = 0 Subtitle foreground transparency = 0
Subtitle background transparency = 0 Subtitle background transparency = 0
@ -963,12 +963,12 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
LNB: LNB:
Use DiSEqC = no Generally turns DiSEqC support on or off. Use DiSEqC = no Generally turns DiSEqC support on or off.
SLOF = 11700 The switching frequency (in MHz) between low and SLOF = 11700 The switching frequency (in MHz) between low and
high LOF high LOF
Low LNB frequency = 9750 The LNB's low and high local oscillator frequencies 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) High LNB frequency = 10600 (in MHz, these have no meaning for DVB-C receivers)
Device n connected to sat cable = own Device n connected to sat cable = own
Defines whether DVB-S device n has its own satellite cable, Defines whether DVB-S device n has its own satellite cable,
@ -1000,41 +1000,41 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
CAM: CAM:
n CAM Name Shows the CAM slots that are present in this system, where 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 '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 CAM. If a CAM slot is empty, '-' is displayed as name, and
if it is in the process of being reset, its current status if it is in the process of being reset, its current status
is displayed. The "Red" key can be pressed to enter the CAM is displayed. The "Red" key can be pressed to enter the CAM
menu, and the "Green" key triggers a reset of the selected menu, and the "Green" key triggers a reset of the selected
slot. The "Ok" key also opens the CAM menu. The "Yellow" key slot. The "Ok" key also opens the CAM menu. The "Yellow" key
assigns the selected CAM to a device and switches it to the assigns the selected CAM to a device and switches it to the
current channel. The CAM/device combination remains tuned to current channel. The CAM/device combination remains tuned to
the current channel until the smart card in the CAM has been the current channel until the smart card in the CAM has been
activated and thus starts to descramble, or until a recording activated and thus starts to descramble, or until a recording
needs this device. Pressing the "Yellow" key while a CAM is needs this device. Pressing the "Yellow" key while a CAM is
in activation mode cancels the activation. The activation mode in activation mode cancels the activation. The activation mode
remains in effect even if you switch to a different channel remains in effect even if you switch to a different channel
(provided there is more than one device in the system) or (provided there is more than one device in the system) or
watch a recording. To activate your smart card simply switch watch a recording. To activate your smart card simply switch
to the channel you want to watch, open the "Setup/CAM" menu, to the channel you want to watch, open the "Setup/CAM" menu,
select the CAM that contains the smart card (in case you select the CAM that contains the smart card (in case you
have more than one CAM) and press the "Yellow" key. have more than one CAM) and press the "Yellow" key.
Recording: Recording:
Margin at start = 2 Defines how many minutes before the official start time 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 Margin at stop = 10 of a broadcast VDR shall start recording, and how long
after the official end time it shall stop recording. after the official end time it shall stop recording.
These margins are added automatically to timers that These margins are added automatically to timers that
are created from the EPG data. are created from the EPG data.
Note that the actual margins used may be smaller than the Note that the actual margins used may be smaller than the
given values, if the event before and/or after the event given values, if the event before and/or after the event
to be recorded is shorter than the respective margin. to be recorded is shorter than the respective margin.
Default priority = 50 The default Priority and Lifetime values used when Default priority = 50 The default Priority and Lifetime values used when
Default lifetime = 99 creating a new timer event. A Lifetime value of 99 Default lifetime = 99 creating a new timer event. A Lifetime value of 99
means that this recording will never be deleted means that this recording will never be deleted
automatically. automatically.
Record key handling = 2 Record key handling = 2
Defines what happens if the Record key on the remote control Defines what happens if the Record key on the remote control
@ -1051,8 +1051,8 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
2 = pause live video 2 = pause live video
The default is 2. The default is 2.
Pause priority = 10 The Priority and Lifetime values used when pausing live Pause priority = 10 The Priority and Lifetime values used when pausing live
Pause lifetime = 1 video. Pause lifetime = 1 video.
Use episode name = yes Repeating timers use the EPG's 'Episode name' information Use episode name = yes Repeating timers use the EPG's 'Episode name' information
to create recording file names in a hierarchical structure to create recording file names in a hierarchical structure
@ -1062,16 +1062,16 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
no = don't use the 'Episode name' no = don't use the 'Episode name'
yes = use it (and create subdirectories) yes = use it (and create subdirectories)
Use VPS = 0 Defines whether a timer that is created from an EPG entry Use VPS = 0 Defines whether a timer that is created from an EPG entry
(by pressing the "Record" (red) key in the "Schedules" (by pressing the "Record" (red) key in the "Schedules"
or "What's on now/next?" menu) will automatically use VPS or "What's on now/next?" menu) will automatically use VPS
if the event it is created for has a VPS time. if the event it is created for has a VPS time.
VPS margin = 120 Defines how many seconds before a VPS controlled timer is 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 scheduled to start, VDR will make sure that one of the DVB
devices is tuned to the transponder that timer shall record devices is tuned to the transponder that timer shall record
from. This is necessary for the "Running Status" information from. This is necessary for the "Running Status" information
that is broadcast in the EPG data to be seen by VDR. that is broadcast in the EPG data to be seen by VDR.
Mark instant recording = yes Mark instant recording = yes
Defines whether an "instant recording" (started by Defines whether an "instant recording" (started by
@ -1121,12 +1121,12 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
Replay: Replay:
Multi speed mode = no Defines the function of the "Left" and "Right" keys in 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 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 if set to 'yes' there will be three speeds for fast and slow
search, respectively. search, respectively.
Show replay mode = no Turns displaying the current replay mode on or off. Show replay mode = no Turns displaying the current replay mode on or off.
Show remaining time = no Show remaining time = no
Defines whether the replay progress display shows the Defines whether the replay progress display shows the
@ -1205,11 +1205,11 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
respectively. respectively.
The valid range is 5...600. The valid range is 5...600.
Resume ID = 0 Defines an additional ID that can be used in a multi user 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 environment, so that every user has his/her own resume
files for each recording. The valid range is 0...99, with files for each recording. The valid range is 0...99, with
0 resulting in a file named 'resume', and any other 0 resulting in a file named 'resume', and any other
value resulting in 'resume.n'. value resulting in 'resume.n'.
Miscellaneous: Miscellaneous:
@ -1224,29 +1224,29 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
retaining the possibility to manually shutdown the retaining the possibility to manually shutdown the
computer. computer.
SVDRP timeout = 300 The time (in seconds) of inactivity on an open SVDRP SVDRP timeout = 300 The time (in seconds) of inactivity on an open SVDRP
connection after which the connection is automatically connection after which the connection is automatically
closed. Default is 300, a value of 0 means no timeout. closed. Default is 300, a value of 0 means no timeout.
SVDRP peering = off Activates automatic connections between VDRs in the same SVDRP peering = off Activates automatic connections between VDRs in the same
network. If set to "any hosts" this VDR will establish network. If set to "any hosts" this VDR will establish
connections with any available hosts. If set to "only connections with any available hosts. If set to "only
default host" this VDR will only connect to the VDR with default host" this VDR will only connect to the VDR with
the name defined in "SVDRP default host". If no default the name defined in "SVDRP default host". If no default
host has been defined, the behavior is the same as with host has been defined, the behavior is the same as with
"any hosts". To switch from "off" to "only default host", "any hosts". To switch from "off" to "only default host",
you may need to select "any hosts" first and confirm the you may need to select "any hosts" first and confirm the
dialog by pressing "Ok" in order to be able to select a dialog by pressing "Ok" in order to be able to select a
default host. default host.
SVDRP host name The name of this VDR, which is used when connecting VDRs SVDRP host name The name of this VDR, which is used when connecting VDRs
via SVDRP. By default, the machine's host name is used. via SVDRP. By default, the machine's host name is used.
SVDRP default host The name of the VDR to be used by default when creating a SVDRP default host The name of the VDR to be used by default when creating a
new timer. new timer.
Zap timeout = 3 The time (in seconds) until a channel counts as "previous" Zap timeout = 3 The time (in seconds) until a channel counts as "previous"
for switching with '0' for switching with '0'
Channel entry timeout = 1000 Channel entry timeout = 1000
The time (in milliseconds) after the last keypress until The time (in milliseconds) after the last keypress until
@ -1273,26 +1273,26 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
VDR starts. Default is empty, which means that it will VDR starts. Default is empty, which means that it will
tune to the channel that was on before VDR was stopped. tune to the channel that was on before VDR was stopped.
Initial volume = -1 The volume that shall be set when VDR starts. Default Initial volume = -1 The volume that shall be set when VDR starts. Default
is -1, which means that the same volume as before is -1, which means that the same volume as before
VDR was stopped will be used. The valid range is from VDR was stopped will be used. The valid range is from
0 (silent) to 255 (loudest). 0 (silent) to 255 (loudest).
Volume steps = 51 The number of steps the volume will use when moving from Volume steps = 51 The number of steps the volume will use when moving from
the lowest to the highest value. The valid range is from the lowest to the highest value. The valid range is from
5 to 255. 5 to 255.
Volume linearize = 0 How to linearize the volume control. The valid range is Volume linearize = 0 How to linearize the volume control. The valid range is
from -20 to 20. A value of 0 results in no linearization. from -20 to 20. A value of 0 results in no linearization.
The higher this value is, the more fine grained the control The higher this value is, the more fine grained the control
of the volume is for low sound levels. Lower values do the of the volume is for low sound levels. Lower values do the
same for high sound levels. This allows you to adjust the same for high sound levels. This allows you to adjust the
more or less linear volume control of your sound card. more or less linear volume control of your sound card.
Channels wrap = no During zapping with the "Up" and "Down" keys (or the Channels wrap = no During zapping with the "Up" and "Down" keys (or the
"Channel+" and "Channel-" keys) the current channel will "Channel+" and "Channel-" keys) the current channel will
wrap around the beginning or end of the channel list if wrap around the beginning or end of the channel list if
this parameter is set to 'yes'. this parameter is set to 'yes'.
Show channel names with source = off Show channel names with source = off
If this option is turned on, channel names will be displayed If this option is turned on, channel names will be displayed
@ -1300,13 +1300,13 @@ timer, making "TITLE - EPISODE" and "TITLE: EPISODE" the same.
option is set to "type), or "ZDF (S19.2E)" (if it is set to option is set to "type), or "ZDF (S19.2E)" (if it is set to
"full"), where 'S' stands for "Satellite". "full"), where 'S' stands for "Satellite".
Emergency exit = yes If, for some reason, a recording fails because the video Emergency exit = yes If, for some reason, a recording fails because the video
data stream is broken, or the CAM doesn't decrypt etc., data stream is broken, or the CAM doesn't decrypt etc.,
VDR automatically exits in order to allow the surrounding VDR automatically exits in order to allow the surrounding
wrapper script to reload the DVB drivers. If this option wrapper script to reload the DVB drivers. If this option
is set to 'no', the "emergency exit" will be ignored, is set to 'no', the "emergency exit" will be ignored,
hoping that the problem will go away by itself (as, for hoping that the problem will go away by itself (as, for
instance, with bad weather conditions). instance, with bad weather conditions).
## Executing system commands ## Executing system commands