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:

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.

Media container

Select the container format used to store recordings.

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.

Make sub-directories per day

If checked, Tvheadend will 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, Tvheadend will 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, Tvheadend will 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.

Include channel name in title

If checked, Tvheadend will 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, Tvheadend will 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, Tvheadend will 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, Tvheadend will include the season and episode in the title (if such info is available).

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 '-'.

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.

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:

Format	Description	Example value
%f	Full path to recording	/home/user/Videos/News.mkv
%b	Basename of recording	News.mkv
%c	Channel name	BBC world
%C	Who created this recording	user
%t	Program title	News
%d	Program description	News and stories...
%e	Error message	Aborted by user
%S	Start time stamp of recording, UNIX epoch	1224421200
%E	Stop time stamp of recording, UNIX epoch	1224426600

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.

Changes to any of these settings must be confirmed by pressing the 'Save configuration' button before taking effect.