path: root/runvdr.conf.example

# runvdr.conf
#
#      Sample configuration file for the runvdr vdr-launcher script.
#
#      by Udo Richter <udo_richter(a)gmx.de>
#      http://projects.vdr-developer.org/projects/runvdr-extreme
#
#


# Include other configuration file for defaults
# Must be first, or will override all previous settings.
# You can also use wildcards to load several files in lexicographic order:
# INCLUDE /etc/runvdr/plugins.d/*
# You may want to use this in ~/.runvdr.conf if you also want to load
# /etc/runvdr.conf. DO NOT create infinite loops with this!
#
# INCLUDE /etc/runvdr.conf
#
# For use with runvdr-conf.d, un-comment this line:
# INCLUDE /etc/runvdr/conf.d/*



##### -------------------------
#####   Common config options
##### -------------------------

# The VDR binary to run:
VDRPRG="/usr/local/bin/vdr"

# Command to load the DVB drivers
# DVBLOAD will be launched before VDR starts and whenever the drivers
# need to be reloaded.
#function DVBLOAD() {
#    modprobe ....
#}

# Command to unload the DVB drivers
# DVBUNLOAD will be launched whenever the drivers need to be reloaded.
#function DVBUNLOAD() {
#    rmmod ....
#}

# Use VIDEODIR as video directory. The default is /video.
VIDEODIR="/video"

# Read config files from directory CONFIGDIR (default is to read them
# from the video directory).
CONFIGDIR="/video"

# Location of locale files for VDR 1.5.14 and newer. Default is to use
# the builtin "./locale" or whatever was compiled as LOCDIR into VDR.
#
# LOCALEDIR="/usr/src/vdr/locale"

# Location where VDR and plugins save cache files
CACHEDIR=

# Location from where plugins read resource files
RESDIR=

##### -----------
#####   Plugins
##### -----------

# 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
#
#   AddPlugin hello -b -a "A B C"
#
# which would load a plugin named "hello", giving it the three
# command line options "-b", "-a" and "A B C"
#
# Note: Using the command line option --plugin and -P requires additional
# quoting. The corresponding command line would be:
#
#   runvdr --plugin "hello -b -a \"A B C\""
#
# Add as many plugins as you want here:
AddPlugin
AddPlugin
AddPlugin
AddPlugin
AddPlugin

# Search for plugins in directory LIBDIR. Default is ./PLUGINS/lib.
LIBDIR=""

# If you use PluginSetup: Where is the the plugin_setup_runvdr.conf file?
# PLUGINSETUPCONF="$CONFIGDIR/plugins/plugin_setup_runvdr.conf"

# If you use Setup-Plugin: Where is the the sysconfig file?
# SETUPPLUGINCONF="$CONFIGDIR/sysconfig"

##### -----------------------
#####   More config options
##### -----------------------

# 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.
USER=""

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

# Call RECORDCMD before and after a recording.
RECORDCMD=""

# Call SHUTDOWN to shutdown the computer.
SHUTDOWN=""

# Send Dolby Digital audio to stdin of the command AUDIO:
AUDIO=""

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

# 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).
LOGLEVEL=3

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

# 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.
SVDRPPORT=

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

# Run in daemon mode (implies NOKBD=1)
# Set to anything to activate:
DAEMON=

# 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.
GRAB=

# 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.
LIRC=

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

# Use a serial port remote control device. If set to 1, vdr uses /dev/ttyS1.
# If not set, or set to 0, don't use rcu.
RCU=

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

# 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
DIRNAMES=

# Allow coredumps if USER= is given (debugging)
# USERDUMP="1"

# Fire up own X server as output device
# XSERVER="/usr/bin/X -nolisten tcp -config /etc/X11/xorg-runvdr.conf :0"

# X startup commands, called within the X server
#function XSTARTUP() {
#    while true ; do sleep 5; vdr-sxfe; done &
#    SXFEPID=$!
#}

# X shutdown commands, called within the X server
#function XSHUTDOWN() {
#    kill $SXFEPID
#}

# Store PID of runvdr into a file?
# RUNVDRPID=~/.runvdr.pid
RUNVDRPID=/var/run/runvdr.pid

# Set the controlling terminal. For example, /dev/tty8
TERMINAL="/dev/tty8"

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

# Set language for locale to run VDR on.
# This affects sort options in recordings.
# LANGUAGE="de_DE@euro"

# Set character set that VDR should use
# VDR_CHARSET_OVERRIDE="ISO-8859-15"

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

# 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
RESTARTTIME=10

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

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

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

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