Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  pro-
       gram  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/cd0

       -o DIRECTORY, --output=DIRECTORY
	      where DIRECTORY is your backup target.  If not given,  the  cur-
	      rent 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	multi-
	      ple 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 sec-
       tors 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/cd0 is the default de-
	      vice tried - you need to use -i if your device name  is  differ-
	      ent.

       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 re-
	      port.

       dvdbackup -T 2
	      backups  the  title set 2	i.e. all VTS_02_X.XXX files.  This ac-
	      tion 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 be-
	      tween 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 be-
	      longs 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dvdbackup&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help