This tab is used to configure operation of the Digital Video Recorder. It is not used for scheduling or administration of individual recordings.

Configuration options:




DVR Behaviour
Media container
Select the container format used to store recordings.
Cache scheme
Select the cache scheme used to store recordings.
System
Standard system caching.
Do not keep
Do not keep the stored data in system's cache.
Sync
Sync the stored data with medium (disk).
Sync + Do not keep
Combination of two above variants.
DVR Log retention time (days)
Time that Tvheadend will keep information about the recording in its internal database. Notice that the actual recorded file will not be deleted when the log entry is deleted.
Extra time before recordings (minutes)
Specify the number of minutes to record before the events scheduled start time. Used to cope with small scheduling errors.
Extra time after recordings (minutes)
Specify the number of minutes to record after the events scheduled stop time. Used to cope with small scheduling errors.
Post-processor command
Command to run after finishing a recording. The command will be run in background and is executed even if a recording is aborted or an error occurred. Use the %e error formatting string to check for errors, the error string is empty if recording finished successfully.

Support format strings:
FormatDescriptionExample value
%fFull path to recording/home/user/Videos/News.mkv
%bBasename of recordingNews.mkv
%cChannel nameBBC world
%CWho created this recordinguser
%tProgram titleNews
%dProgram descriptionNews and stories...
%eError messageAborted by user
%SStart time stamp of recording, UNIX epoch1224421200
%EStop time stamp of recording, UNIX epoch1224426600

Example usage: /path/to/ffmpeg -i %f -vcodec libx264 -acodec copy "/path/with white space/%b"
You need to use quotes or escape white spaces if you want white spaces in an argument.


Recording File Options
Recording system path
Path to where Tvheadend will write recorded events. If components of the path does not exist, Tvheadend will try to create them.
File permissions
The permissions to be set on the resultant recording files. This is useful if you need to manipulate the files after recording under a different user ID, e.g. to chop out commercials.
Common examples:
0644 == rw-r--r--
0664 == rw-rw-r-- (default)
0666 == rw-rw-rw-
Note that your default user umask applies, so 666 with umask 0002 will produce 0664. See also Directory permissions in Subdirectory Options.
Rewrite PAT in passthrough mode
Rewrite the original Program Association Table to only include the active service. When this option is disabled, Tvheadend will write the original PAT as broadcast, which lists all services from the original multiplex.
Rewrite PMT in passthrough mode
Generate a Program Map Table only listing the streams actually in the output transport stream. When this option is disabled, Tvheadend will write the original Program Map Table as broadcast, which may include references to excluded streams such as data and ECMs.
Tag files with metadata
If checked, media containers that support metadata will be tagged with the metadata associated with the event being recorded.
Skip commercials
If checked, commercials will be dropped from the recordings. At the moment, commercial detection only works for the swedish channel TV4.


Subdirectory Options
Directory permissions
The permissions to be set on any sub-directories created for recordings. This is useful if you need to manipulate the files after recording under a different user ID, e.g. to chop out commercials.
Common examples:
0755 == rwxr--r--
0775 == rwxrwxr-- (default)
0777 == rwxrwxrwx
Note that your default user umask applies, so 0777 with umask 0002 will produce 0775. See also File permissions in Recording File Options.
Make sub-directories per day
If checked, create a new directory per day in the recording system path. Only days when anything is recorded will be created. The format of the directory will be 'YYYY-MM-DD' (ISO standard)
Make sub-directories per channel
If checked, create a directory per channel when storing events. If both this and the 'directory per day' checkbox is enabled, the date-directory will be parent to the per-channel directory.
Make sub-directories per title
If checked, create a directory per title when storing events. If the day/channel directory checkboxes are also enabled, those directories will be parents of this directory.


Filename Options
Include channel name in title
If checked, include the name of the channel in the event title. This applies to both the titled stored in the file and to the file name itself.
Include date in title
If checked, include the date for the recording in the event title. This applies to both the titled stored in the file and to the file name itself.
Include time in title
If checked, include the time for the recording in the event title. This applies to both the titled stored in the file and to the file name itself.
Include episode in title
If checked, include the season and episode in the title (if such info is available).
Include subtitle in title
If checked, include the episode subtitle in the title (if such info is available).
Put episode in filename before date and time
If checked, insert the episode number before the data and time rather than after (assumes Include date, Include time and Include episode options are set).
Remove all unsafe characters from filename
If checked, all characters that could possibly cause problems for filenaming will be removed.
Replace whitespace in title with '-'
If checked, all whitespace characters will be replaced with '-'.
Changes to any of these settings must be confirmed by pressing the 'Save configuration' button before taking effect.