vdr − the -Video Disk Recorder
- -vdr -[options]
- -vdr -implements a complete digital Set-Top Box and Video -Recorder. It can work with signals received from satellites -(DVB-S) as well as cable (DVB-C) and terrestrial (DVB-T) -signals.
- -At least one -DVB card is required to run vdr. With it you can -watch live TV while recording one or more other broadcasts -from the same transponder. It is also possible to start -watching a recorded programme before the live broadcast has -ended (time shifting). In order to record from -different transponders simultaneously two or more DVB cards -are necessary. By default vdr can support up to eight -DVB cards. The primary DVB card (the one your TV set is -connected to) can either be a "full featured" -card, which means it contains an MPEG decoder and provides -audio and video signal outputs, or you can use some third -party plugin that implements software decoding of the MPEG -data and displays it via the system’s graphics -adapter.
- -vdr uses -an On Screen Display (OSD) to display its menus. It can be -controlled by the PC keyboard, the "Linux Infrared -Remote Control" (LIRC), or any other means of remote -control, implemented by a third party plugin.
- -Remote access -is possible via the "Simple Video Disk Recorder -Protocol" (SVDRP), which can be accessed on port 6419, -for instance by telnet.
- -−a cmd, −−audio=cmd
- -Send Dolby Digital audio to -stdin of command cmd.
- - -−−cachedir=dir
- -Save cache files in dir -(default is to save them in the video directory).
- - -−−chartab=character_table
- -Set the character table to use -for strings in the DVB data stream that don’t begin -with a character table indicator, but don’t use the -standard default character table (for instance -ISO-8859-9).
- - -−c dir, −−config=dir
- -Read config files from -directory dir (default is to read them from the video -directory).
- -−d, -−−daemon
- -Run in daemon mode (implies -−−no−kbd).
- - -−D num, −−device=num
- -Use only the given DVB device -(num = 0, 1, 2...). There may be several -−D options (by default all DVB devices will be -used). If −D− is given, no DVB devices -will be used at all, independent of any other −D -options.
- - -−−dirnames=path[,name[,enc]]
- -Set the maximum directory path -length to path (default is the maximum value allowed -on the system). If name is also given, it defines the -maximum directory name length (default is the maximum value -allowed on the system). 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. The length of the video -directory name and that of the actual recording directory is -subtracted from path, to make sure the directory path -will never become too long.
- - -−−edit=rec
- -Edit the given recording. -rec must be the full path name of an existing -recording. The program will return immediately after editing -the recording.
- - -−E file, −−epgfile=file
- -Write the EPG data into the -given file (default is epg.data in the cache -directory). Use −E− to disable this. If -file is a directory, the file epg.data will be -created in that directory.
- - -−−filesize=size
- -Limit video files to -size bytes (default is 2000M). This option is only -useful in conjunction with --edit, and must precede that -option to have an effect. size is an integer number -and may be followed by one of the letters K, M, G or T to -abbreviate Kilo-, Mega-, Giga- or Terabyte, respectively. -The given value is silently limited to the program’s -internal minimum and maximum values.
- - -−−genindex=rec
- -Generate the index file for the -given recording. rec must be the full path name of an -existing recording. The recording must be in TS format. If -the recording already has an index file, it will be deleted -before creating the new one. The program will return -immediately after generating the index. Note that using this -option while another instance of VDR is currently replaying -the given recording, or if the recording has not been -finished yet, may lead to unexpected results.
- - -−g, −−grab=dir
- -Write images from the SVDRP -command GRAB into the given directory dir. dir -must be the full path name of an existing directory, without -any "..", double ’/’ or symlinks. By -default, or if −g− is given, grabbing -images to disk is disabled.
- -−h, -−−help
- -Print a help message and -exit.
- - -−i instance, −−instance=instance
- -Use instance as the id -of this VDR instance (default is 0). In an environment where -several instances of VDR use the same video directory, this -parameter can be set to a positive integer value -that’s unique for each instance, so that they -won’t interfere with each other in case they record -exactly the same broadcast. The number given here will be -part of the directory name in which the recordings will be -stored.
- - -−l level, −−log=level
- -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).
- - -−L dir, −−lib=dir
- -Search for plugins in directory -dir (default is ./PLUGINS/lib). There can be several -−L options with different dir values. -Each of them will apply to the −P options -following it.
- - -−−lirc[=path]
- -Use a LIRC remote control -device. If path is omitted, vdr uses -/var/run/lirc/lircd.
- - -−−localedir=dir
- -Search for locale files in -dir (default is ./locale).
- -−m, -−−mute
- -Mute audio of the primary DVB -device at startup.
- - -−−no−kbd
- -Don’t use the keyboard as -an input device.
- - -−p port, −−port=port
- -Use 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 from hosts other than the localhosts. Note that -this option only changes the TCP port used for SVDRP -commands. The UDP port for discovering peer VDRs in the same -network is always set to 6419 and can’t be -changed.
- - -−P options, −−plugin=options
- -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
- -vdr −P -"abc −a −b xyz"
- -which would -load a plugin named abc, giving it the command line -options −a −b xyz. If you want -to load all available plugins (without any particular -options) you can use
- -vdr −P -"*"
- -(note the -quotes around the asterisk to prevent wildcard -expansion).
- - -−r cmd, −−record=cmd
- -Call cmd before and -after a recording. See the file INSTALL for more -information.
- - -−−resdir=dir
- -Read resource files from -dir (default is to read them from the config -directory).
- - -−−showargs[=dir]
- -Read command line arguments -from dir (default is /etc/vdr/conf.d), display -them to the console and exit.
- - -−s cmd, −−shutdown=cmd
- -Call cmd to shutdown the -computer. See the file INSTALL for more -information.
- -−−split
- -Split edited files at the -editing marks. This option is only useful in conjunction -with --edit, and must precede that option to have an -effect.
- - -−t tty, −−terminal=tty
- -Set the controlling -terminal.
- - -−u user, −−user=user
- -Run as user user 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 can be a user name or a numerical -id.
- - -−−updindex=rec
- -Update the index file for the -given recording. rec must be the full path name of an -existing recording. The recording must be in TS format. If -the recording already has an index file, it will be checked -whether it is complete, and will be updated if it -isn’t. If there is no index file yet, a new one will -be generated. The program will return immediately after -updating the index. Note that using this option while -another instance of VDR is currently replaying the given -recording, or if the recording has not been finished yet, -may lead to unexpected results.
- - -−−userdump
- -Allow coredumps if -u is given -(only for debugging).
- -| - |
-
-
- −−vfat |
-- |
-
-
- For backwards compatibility (same as -−−dirnames= 250,40,1). |
| vdr(1) | +Video Disk Recorder | +vdr(1) | +
−v dir, −−video=dir
- -Use dir as video -directory. The default is /video.
- -−V, -−−version
- -Print version information and -exit.
- - -−w sec, −−watchdog=sec
- -Activate the watchdog timer -with a timeout of sec seconds. A value of 0 -(default) disables the watchdog.
- -If started -without any options, vdr tries to read command line options -from files named ’*.conf’ in the directory -/etc/vdr/conf.d. Files are read in alphabetical order. See -vdr(5) for details.
- -SIGINT, -SIGTERM
- -Program exits with status -0.
- -| - |
-
-
- SIGHUP |
-- |
-
-
- Program exits with status 1. This can be used to force a -reload, for example if an update has been installed. |
| 15 Apr 2018 | +2.4 | +
| - |
-
-
- 0 |
-- |
-
-
- Successful program -execution. |
| - |
-
-
- 1 |
-- |
-
-
- An error has been detected which requires the DVB driver -and vdr to be reloaded. |
| - |
-
-
- 2 |
-- |
-
-
- An non-recoverable error has been detected, vdr -has given up. |
channels.conf
- -Channel configuration.
- -timers.conf
- -Timer configuration.
- -setup.conf
- -User definable setup.
- -commands.conf
- -User definable commands -(executed from the Commands menu).
- -svdrphosts.conf
- -SVDRP host configuration, -defining which hosts or networks are given access to the -SVDRP port.
- -| - |
-
-
- marks |
-- |
-
-
- Contains the editing marks defined for a recording. |
| - |
-
-
- info |
-- |
-
-
- Contains a description of the recording. |
| - |
-
-
- resume |
-- |
-
-
- Contains the index into the recording where the last -replay session left off. |
| - |
-
-
- index |
-- |
-
-
- Contains the file number, offset and type of each frame -of the recording. |
remote.conf
- -Contains the key assignments -for the remote control.
- -keymacros.conf
- -Contains user defined remote -control key macros.
- - -00001.ts ... 65535.ts
- -The actual data files of a -recording.
- -epg.data
- -Contains all current EPG data. -Can be used for external processing and will also be read at -program startup to have the full EPG data available -immediately.
- -.update
- -If this file is present in the -video directory, its last modification time will be used to -trigger an update of the list of recordings in the -"Recordings" menu.
- -vdr(5),svdrpsend(1)
- -Written by -Klaus Schmidinger, with contributions from many others. See -the file CONTRIBUTORS in the vdr source -distribution.
- -Report bugs to -<vdr−bugs@tvdr.de>.
- -Copyright -© 2018 Klaus Schmidinger.
- -This is free -software; see the source for copying conditions. There is NO -warranty; not even for MERCHANTABILITY or FITNESS FOR A -PARTICULAR PURPOSE.
-