VDR Optionen

Aktuelle Version vom 14. April 2019, 10:10 Uhr

[Bearbeiten] Übersicht

Übersicht aller bekannten Kommandozeilen-Parameter, die VDR unterstützt.

Gestartet wird VDR mit: vdr [OPTIONS]

0 = Kein Logbuch
1 = Nur Fehler loggen
2 = Fehler und Infos loggen
3 = Fehler, Infos und Testausgaben loggen

vdr -P "abc -a -b xyz"

vdr -P "*"

[Bearbeiten] Weitere

Diese können zum Beispiel in der der runvdr eingetragen / und zur Laufzeit exportiert werden.

[Bearbeiten] Audio

Wiedergabe von Dolby Digital Audio

Bei "full-featured" DVB-Karte mit S/PDIF-Ausgang kann Dolby Digital Audio direkt ausgegeben werden.

Ebenso kann auch ein externes Programm verwendet werden, diese erhält die DD-Daten per stdin und steuert die Audio-Hardware. Dieses Programm muss zu VDR mit dem '-a' Option angegeben werden.

vdr -a ac3play

[Bearbeiten] Konfiguration

Konfigurationsdateien:
--------------------

There are several configuration files that hold information about
channels, remote control keys, timers etc. By default these files are
assumed to be located in the video directory, but a different directory
can be used with the '-c' option. Plugins assume their configuration files
in a subdirectory called "plugins" of this directory.

For starters just copy all *.conf files from the VDR directory into your
video directory.

The configuration files can be edited with any text editor, or will be written
by the 'vdr' program if any changes are made inside the on-screen menus.
Take a look at man page vdr(5) for information about the file formats.

The files that come with this package contain the author's selections,
so please make sure you adapt these to your personal taste. Also make sure
that the channels defined in 'channels.conf' are correct before attempting
to record anything. Channel parameters may vary and not all of the channels
listed in the default 'channels.conf' file have been verified by the author.

As a starting point you can copy the 'channels.conf' file that comes with the
VDR archive into your video directory (or into your config directory,
respectively, in case you have redirected it with the -c option).

[Bearbeiten] record

Executing commands before and after a recording:
------------------------------------------------

You can use the '-r' option to define a program or script that gets called
before and after a recording is performed, and after an editing process
has finished or a recording has been deleted.

The program will be called with two or three (in case of "editing" and "edited")
string parameters. The first parameter is one of

  before      if this is *before* a recording starts
  started     if this is after a recording has *started*
  after       if this is *after* a recording has finished
  editing     if this is before *editing* a recording
  edited      if this is after a recording has been *edited*
  deleted     if this is after a recording has been *deleted*

and the second parameter contains the full name of the recording's
directory (which may not yet exists at that moment in the "before" case).
In the "editing" and "edited" case it will be the name of the edited version
(second parameter) and the name of the source version (third parameter).
In the "deleted" case the extension of the directory name is ".del"
instead of ".rec".

Within this program you can do anything you would like to do before and/or
after a recording or after an editing process. However, the program must return
as soon as possible, because otherwise it will block further execution of VDR.
Be especially careful to make sure the program returns before the watchdog
timeout you may have set up with the '-w' option! If the operation you want to
perform will take longer, you will have to run it as a background job.

An example script for use with the '-r' option could look like this:

#!/bin/sh
case "$1" in
     before)
            echo "Before recording $2"
            ;;
     started)
            echo "Started recording $2"
            ;;
     after)
            echo "After recording $2"
            ;;
     editing)
            echo "Editing recording $2"
            echo "Source recording $3"
            ;;
     edited)
            echo "Edited recording $2"
            echo "Source recording $3"
            ;;
     deleted)
            echo "Deleted recording $2"
            ;;
     *)
            echo "ERROR: unknown state: $1"
            ;;
     esac 

[Bearbeiten] shutdown

Automatic shutdown:
-------------------

If you define a shutdown command via the '-s' command line option, VDR
will call the given command if there is currently no recording or replay
active, the user has been inactive for at least MinUserInactivity minutes
and the next timer event is at least MinEventTimeout minutes in the future
(see the Setup parameters in MANUAL).

The command given in the '-s' option will be called with five parameters.
The first one is the time (in UTC) of the next timer event (as a time_t
type number), and the second one is the number of seconds from the current
time until the next timer event. Your program can choose which one to use
for programming some sort of hardware device that makes sure the computer
will be restarted in time before the next timer event. Your program must
also initiate the actual shutdown procedure of the computer. After this
your program should return to VDR. VDR will not automatically exit after
calling the shutdown program, but will rather continue normally until it
receives a SIGTERM when the computer is actually shut down. So in case
the shutdown fails, or the shutdown program for some reason decides not to
perform a shutdown, VDR will stay up and running and will call the shutdown
program again after another MinUserInactivity minutes.

If there are currently no timers active, both parameters will be '0'.
In that case the program shall not set the hardware for automatic restart
and only perform the system shutdown. A program that uses the second parameter
to set the hardware for restart must therefore also check whether the first
parameter is '0'.

The third parameter contains the number of the channel that will be recorded
by the next timer (or 0 if no timer is present), and the fourth parameter
contains the file name of the recording as defined in the timer (or an empty
string if no timer is present). These can be used by the shutdown program to
show that information on some display interface etc.

The fifth parameter indicates the reason why the shutdown was requested.
'0' means this is an automatic shutdown due to some timeout, while '1' means
that this is a user requested shutdown (resulting from pressing the "Power"
key). The shutdown program may use this information to decide whether or
not to actually perform the system shutdown.

If a timer is currently recording, the parameters will reflect the start
time of that timer. This means that the first parameter will be a time in
the past, and the second parameter will be a negative number. This only
happens if the user presses the "Power" key while a timer is currently
recording.

Before the shutdown program is called, the user will be prompted to inform
him that the system is about to shut down. If any remote control key is
pressed while this prompt is visible, the shutdown will be cancelled (and
tried again after another MinUserInactivity minutes). The shutdown prompt
will be displayed for 5 minutes, which should be enough time for the user
to react.

A sample shell script to be used with the '-s' option might look like this:

#!/bin/sh
setRTCwakeup $(($1 - 300))
sudo halt

Here 'setRTCwakeup' would be some program that uses the first parameter
(which is the absolute time of the next timer event) to set the Real Time
Clock so that it wakes up the computer 5 minutes (i.e. 300 seconds) before
that event. The 'sudo halt' command then shuts down the computer.
You will have to substitute both commands with whatever applies to your
particular hard- and software environment.

If the '-s' option is present, the VDR machine can be turned off by pressing
the "Power" key on the remote control.

[Bearbeiten] video

Das Verzeichnis der Videodaten:
-------------------------

Alle Aufnahmen werden in Verzeichnisse unterhalb von "/video" geschrieben. 
Stelle bitte sicher, dass das Verzeichnis existiert und dass der Benutzer, 
der das Programm 'vdr' laufen lässt, Lese- und Schreibzugriff auf dieses 
Verzeichnis hat. Wenn du einen anderen Ort für deine Videoaufnahmen bevorzugst, 
kannst du dieses mit der Option '-v' ändern. Stelle bitte sicher, dass der 
Verzeichnisname, den du mit der Option '-v' angegeben hast, ein sauberer, 
absoluter Pfad ist (d.h. keine '..' oder Mehrfachslashes '//' usw.).

Beachte, dass das Dateisystem nicht 64-bit geprüft sein muss, da 'vdr' 
die Videodateien in 2GB große Blöcke aufteilt. Du solltest aber eine Festplatte 
mit mehreren Gigabyte freiem Platz benutzen. Ein Gigabyte kann etwa eine halbe 
Stunde an Videodaten aufnehmen.

Wenn du mehrere Platten hast, diese aber nicht zu einem großen logischem 
Volume zusammenfassen möchtest, kannst du für diese Platten mehrere 
Verzeichnisse als mount points einrichten(*). Alle diese Verzeichnisse müssen 
den gleichen Basisnamen haben und mit einer Zahl enden, wobei das Hauptverzeichnis 
am Ende eine '0' erhält. Die Zahlen der folgenden Verzeichnisse sind dann 
Zahlen in aufsteigender Reihenfolge; also z.B. würde

   /video0
   /video1
   /video2

einen Satz mit drei Verzeichnissen darstellen. Es können auch mehrstellige 
Zahlen sein und die Verzeichnisse brauchen nicht direkt unter '/' zu liegen:


   /mnt/MyVideos/vdr.00
   /mnt/MyVideos/vdr.01
   /mnt/MyVideos/vdr.02
   ...
   /mnt/MyVideos/vdr.11

Dieses würde einen Satz mit 12 Platten darstellen. (Wow, was für eine Maschine!)

Um so eine Multi-Verzeichnisstruktur einzurichten, muss man beim Aufruf des 'vdr' 
die Option '-v' mit dem Namen des Basisverzeichnisses benutzen:


   vdr -v /video0

Beachte, dass du keine nicht-VDR Dateien in die /videoX Verzeichnisse kopierst, 
weil dieses zu einer Menge unnötiger Plattenzugriffe führen könnte, wenn VDR die 
Verzeichnisse aufräumt und sich dort eine große Anzahl von Dateien und /oder 
Unterverzeichnissen befindet.

* Achtung: Diese Funktionalität wurde mit der Entwickler-Version 2.1.2 des VDR entfernt!