dvdbackup

dvdbackup(1)                General Commands Manual               dvdbackup(1)



NAME
       dvdbackup - Tool to backup DVDs

SYNOPSIS
       dvdbackup [OPTION]...

DESCRIPTION
       This manual page documents briefly the dvdbackup command.  This manual
       page was written for the Debian distribution because the original
       program does not have a manual page.  dvdbackup is a tool to extract
       data from video DVDs.  It has the advantages of being small, fast, and
       easy to use.

OPTIONS
       A summary of options is included below.

       -h, --help
              print a brief usage message

       -V, --version
              print version information

       -I, --info
              for information about the DVD

       -M, --mirror
              backup the whole DVD

       -F, --feature
              backup the main feature of the DVD

       -T X, --titleset=X
              backup title set X

       -t X, --title=X
              backup title X

       -s X, --start=X
              backup from chapter X

       -e X, --end=X
              backup to chapter X

       -i DEVICE, --input=DEVICE
              where DEVICE is your DVD device.  This switch only needs to be
              used if your DVD device node is not /dev/dvd

       -o DIRECTORY, --output=DIRECTORY
              where DIRECTORY is your backup target.  If not given, the
              current working directory will be used.

       -v, --verbose
              print more information about progress

       -n NAME, --name=NAME
              (optional) set the title - useful if autodetection fails

       -a 0, --aspect=0
              to get aspect ratio 4:3 instead of 16:9 if both are present

       -r {a,b,m}, --error={a,b,m}
              select read error handling: a=abort, b=skip block, m=skip
              multiple blocks (default)

       -p, --progress
              print progress information while copying VOBs

Option notes
       -a is option to the -F switch and has no effect on other options
       -s and -e should preferably be used together with -t

General backup information
       If your backup directory is /my/dvd/backup/dir/ specified with the -o
       flag, then dvdbackup will create a DVD-Video structure under
       /my/dvd/backup/dir/TITLE_NAME/VIDEO_TS.  If the -o flag is omitted, the
       current directory is used.

       Since the title is "unique" you can use the same directory for all your
       DVD backups. If it happens to have a generic title dvdbackup will exit
       with a return value of 2, and you will need to specify a title name
       with the -n switch.

       dvdbackup will always mimic the original DVD-Video structure. Hence if
       you e.g.  use the -M (mirror) you will get an exact duplicate of the
       original. This means that every file will have the same size as the
       original one. Likewise also for the -F and the -T switch.

       However the -t and (-t -s/-e) switch is a bit different the titles
       sectors will be written to the original file but not at the same offset
       as the original one since there may be gaps in the cell structure that
       we do not fill.

EXAMPLES
       dvdbackup -I
              gathers information about the DVD.  /dev/dvd is the default
              device tried - you need to use -i if your device name is
              different.

       dvdbackup -M
              backups the whole DVD.  This action creates a valid DVD-Video
              structure that can be burned to a DVD-/+R(W) with help of
              genisoimage.

       dvdbackup -F
              backups the main feature of the DVD.  This action creates a
              valid DVD-Video structure of the feature title set.  Note that
              this will not result in an image immediately watchable - you
              will need another program like dvdauthor to help construct the
              IFO files.

              dvdbackup defaults to get the 16:9 version of the main feature
              if a 4:3 is also present on the DVD.  To get the 4:3 version use
              -a 0.

              dvdbackup makes it best to make a intelligent guess what is the
              main feature of the DVD - in case it fails please send a bug
              report.

       dvdbackup -T 2
              backups the title set 2 i.e. all VTS_02_X.XXX files.  This
              action creates a valid DVD-Video structure of the specified
              title set.  Note that this will not result in an image
              immediately watchable - you will need another program like
              dvdauthor to help construct the IFO files.

       dvdbackup -t 1
              backups the title 1.  This action backups all cells that forms
              the specified title. Note that there can be sector gaps in
              between one cell and another. dvdbackup will backup all sectors
              that belongs to the title but will skip sectors that are not a
              part of the title.

       dvdbackup -t 1 -s 20 -e 25
              This action will backup chapter 20 to 25 in title 1, as with the
              backup of a title there can be sector gaps between one chapter
              (cell) and on other.  dvdbackup will backup all sectors that
              belongs to the title 1 chapter 20 to 25 but will skip sectors
              that are not a part of the title 1 chapter 20 to 25.

              To backup a single chapter e.g. chapter 20 do -s 20 -e 20.
              To backup from chapter 20 to the end chapter use only -s 20.
              To backup to chapter 20 from the first chapter use only -e 20.

              You can skip the -t switch and let the program guess the title
              although it is not recommended.

              If you specify a chapter that is higher than the last chapter of
              the title dvdbackup will truncate to the highest chapter of the
              title.

EXIT STATUS
       0      on success

       1      on usage error

       2      on title name error

       -1     on failure

AUTHORS
       dvdbackup was written by Olaf Beck <olaf_sc@yahoo.com>, but is now
       maintained by Benjamin Drung <benjamin.drung@gmail.com> and Stephen
       Gran <sgran@debian.org>.  This manual page was written by Stephen Gran
       <sgran@debian.org>.



0.2                               2008-03-18                      dvdbackup(1)