Main
Development
Information
Community
Social media
Other
  1. Manuals
  2. Leap-15.6
  3. runvdr-extreme-systemd
  4. runvdr(5)

Scroll to navigation

RUNVDR.CONF(5) runvdr RUNVDR.CONF(5)

NAME

runvdr.conf - Configuration file for runvdr-extreme

SYNOPSIS

 /etc/runvdr.conf

DESCRIPTION

The file runvdr.conf configures the runvdr-extreme VDR startup script.

OPTIONS

 VDRPRG=

The VDR binary to run

 VIDEODIR=

Use VIDEODIR as video directory.

 CONFIGDIR=

Read config files from directory CONFIGDIR

 LOCALEDIR=

Location of locale files for VDR.

 LIBDIR=

Search for plugins in directory LIBDIR.

 CACHEDIR=

Location where VDR and plugins save cache files

 RESDIR=

Location from where plugins read resource files

 USER=

Run as user VDRUSER in case vdr was started as user 'root'. Starting vdr as 'root' is necessary if the system time shall be set from the transponder data, but for security reasons vdr can switch to a lesser privileged user id during normal operation.

 EPGFILE=

Write the EPG data into EPGFILE. Use EPGFILE=- to disable this. If EPGFILE is a directory, the file epg.data will be created in that directory.

 RECORDCMD=

Call RECORDCMD before and after a recording.

 SHUTDOWN=

Call SHUTDOWN to shutdown the computer.

 AUDIO=

Send Dolby Digital audio to stdin of the command AUDIO

 DVBDEVICE=()

Use only the given DVB device. Set one or more DVB device numbers like this: (0 1 2). Defaults to all devices.

 LOGLEVEL=

Set logging to level. 0 = no logging, 1 = errors only, 2 = errors and info, 3 = errors, info and debug. The default logging level is 3. If logging should be done to LOG_LOCALn instead of LOG_USER, add '.n' to LEVEL, as in 3.7 (n=0..7).

 MUTE=

Mute audio of the primary DVB device at startup. Set to anything to mute, keep clear for not.

 SVDRPPORT=

Use SVDRPPORT port for SVDRP. A value of 0 turns off SVDRP. The default SVDRP port is 6419. You need to edit the file svdrphosts.conf in order to enable access to the SVDRP port.

 WATCHDOG=

Activate the watchdog timer with a timeout of sec seconds. A value of 0 (default) disables the watchdog.

 DAEMON=

Run in daemon mode (implies NOKBD=1). Set to anything to activate.

 GRAB=

Write images from the SVDRP command GRAB into the given directory. GRAB must be the full path name of an existing directory, without any "..", double '/' or symlinks. By default, or if GRAB=- is given, grabbing images to disk is disabled.

 LIRC=

Use a LIRC remote control device. If set to 1, vdr uses /var/run/lirc/lircd. If not set, or set to 0, don't use LIRC.

 NOKBD=

Don't use the keyboard as an input device. Set to anything.

 VFAT=

encode special characters in recording names to avoid problems with VFAT file systems for backwards compatibility (same as DIRNAMES=250,40,1)

 DIRNAMES=PATH[,NAME[,ENC]]

Set the maximum directory path length to PATH; if NAME is also given, it defines the maximum directory name length; the optional ENC can be 0 or 1, and controls whether special characters in directory names are encoded as hex values (default: 0); if PATH or NAME are left empty (as in ",,1" to only set ENC), the defaults apply

 USERDUMP="1"

Allow coredumps if USER= is given (debugging)

 RUNVDRPID=/var/run/runvdr.pid

Store PID of runvdr into a file?

 TERMINAL=

Set the controlling terminal. For example, /dev/tty8

 SWITCHTERMINAL=

Switch console to some terminal? Needs terminal number. For example, SWITCHTERMINAL=8

 LANGUAGE="de_DE@euro"

Set language for locale to run VDR on. This affects sort options in recordings.

 VDR_CHARSET_OVERRIDE="ISO-8859-15"

Set character set that VDR should use

 MAXRESTARTS=

If VDR restarts automatically, only do this number of restarts before giving up. Setting this to 0 will cancel any restart attempt of VDR. Default is 5.

 RESTARTTIME=

Only count restart attempts where VDR did not run longer than # seconds Setting this to 0 will never count restarts, and VDR can restart forever. Default is 10.

 DVBUNLOADONEXIT=

Should we unload the DVB driver when finally exiting runvdr? If not set, or set to 0, exit without unloading drivers

 WRAPPER=

Command wrapper. Will be placed in front of the VDR command. Example:
WRAPPER="gdb --args"
WRAPPER="valgrind"

 TERMTIMEOUT=
 KILLTIMEOUT=

Timeouts for SIGTERM and SIGKILL when stopping VDR. TERMTIMEOUT defaults to 20 secods, KILLTIMEOUT to 5 seconds.

PLUGIN LOADING

 AddPlugin hello -b -a "A B C"

The command "AddPlugin" is used to load a plugin, defined by the given options. The first word in options must be the name of an existing vdr plugin, optionally followed by a blank separated list of command line options for that plugin. If options contains any blanks, you need to enclose it in quotes, like for example

X SERVER HANDLING

 XSERVER="/usr/bin/X -nolisten tcp -config /etc/X11/xorg-runvdr.conf :0"

Fire up own X server as output device

 function XSTARTUP() {
   while true ; do sleep 5; vdr-sxfe; done &
   SXFEPID=$!
 }

X startup commands, called within the X server. Please not, that commands, entered here, are called with root privileges! Be sure to use "su $USER -c" where applicable.

 function XSHUTDOWN() {
   kill $SXFEPID
 }

X shutdown commands, called within the X server. Again, as with XSTARTUP, commands are executed with root privileges!

DVB DRIVER LOADING/RELOADING

 function DVBLOAD() {
   modprobe ....
 }

Command to load the DVB drivers. DVBLOAD will be launched before VDR starts and whenever the drivers need to be reloaded.

 function DVBUNLOAD() {
   rmmod ....
 }

Command to unload the DVB drivers. DVBUNLOAD will be launched whenever the drivers need to be reloaded.

ADDITIONAL PARAMETERS

 AddParams --whatever --you --need

Additional parameters to pass to VDR directly, without parsing: Add them without extra quoting, like AddParams -a -b -c "Some Parameter"
2014-07-25 runvdr