tvheadend/docs/html/config_dvr.html

<div class="hts-doc-text">

 <img src="docresources/configdvrtab.png">

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

 <p>
 Configuration options:
 <dl>
  <dt>Recording system path
  <dd>Path to where Tvheadend will write recorded events. If components of
      the path does not exist, Tvheadend will try to create them.

  <dt>DVR Log retention time (days)
  <dd>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.

  <dt>Make subdirectories per day
  <dd>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)

  <dt>Make subdirectories per channel
  <dd>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.

  <dt>Include channel name in title
  <dd>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 filename itself.

  <dt>Include date in title
  <dd>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 filename itself.

  <dt>Include time in title
  <dd>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 filename itself.
  <dt>Post-processor command
  <dd>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.
      <br><br>
      Support format strings:<br>
      <table class="hts-doc-text" border="0">
        <tr><th>Format</th><th>Description</th><th>Example value</th></tr>
        <tr><td>%f</td><td>Full path to recoding</td><td>/home/user/Videos/News.mkv</td></tr>
        <tr><td>%b</td><td>Basename of recoding</td><td>News.mkv</td></tr>
        <tr><td>%c</td><td>Channel name</td><td>BBC world</td></tr>
        <tr><td>%C</td><td>Who created this recoding</td><td>user</td></tr>
        <tr><td>%t</td><td>Program title</td><td>News</td></tr>
        <tr><td>%c</td><td>Program description</td><td>News and stories...</td></tr>
        <tr><td>%S</td><td>Start timestmap of recoding, UNIX epoch</td><td>1224421200</td></tr>
        <tr><td>%E</td><td>Stop timestamp of recoding, UNIX epoch</td><td>1224426600</td></tr>
      </table>
      <br>
      Example usage: /path/to/ffmpeg -i %f -vcodec libx264 -acodec copy "/path/with white space/%b"
 </dl>
 Changes to any of these settings must be confirmed by pressing the
 'Save configuration' button before taking effect.
</div>