.\" Process this file with
.\" groff -man -Tascii vobcopy.1
.\"
.TH VOBCOPY 1 "July 2002" Linux "User Manuals"
.SH NAME
vobcopy \- copy (rip) files from a dvd to the harddisk
.SH SYNOPSIS
.B vobcopy [-b
.I size[bkmg]
.B ] [-e
.I size[bkmg]
.B ] [-f] [-h] [-i
.I input-dir
.B ] [-l] [-m] [-n
.I title-number
.B ] [-o
.I output-dir
.B ] [-t
.I name
.B ] [-v [-v]] [-I] [-V] [-1
.I aux_output_dir1
.B ] [-2
.I aux_output_dir2
.B ] [-3
.I aux_output_dir3
.B ] [-4
.I aux_output_dir4
.B ]
.SH DESCRIPTION
.B vobcopy
copies DVD .vob files to harddisk, decrypting them on the way (thanks to 
libdvdread) and merges them into file(s) with the name extracted from the 
DVD. It checks for enough free space on the destination drive and compares 
the copied size to the size on DVD (in case something went wrong during the 
copying). It should definitely work on linux and now on FreeBSD too. 
.BR vobcopy
without any options will copy the title with the most chapters into files of 
2GB size into the current working directory.
.SH OPTIONS
.IP "-b, --begin SIZE[bkmg]"
begins to copy from the specified offset-size. Modifiers like b for 512-bytes, k for kilo-bytes, m for mega- and g for giga-bytes can be appended to the number. Example: vobcopy -b 500m will start to copy from 500MB onward till the end.
.IP "-e, --end SIZE[bkmg]"
similar to -b, this options lets you specify some size to stop before the end.
.IP "-f, --force"
force the output to the specified directory even if vobcopy thinks there is not
enough free space
.IP "-h, --help"
print the command line options available
.IP "-i, --input-dir INPUT-DIR"
provide vobcopy with the path to the mounted dvd drive
.IP "-l, --large-file"
write data into one file (needs large file support (LFS))
.IP "-m, --mirror"
mirrors the whole dvd to harddisk. It will create a directory named after the dvd and copy the ifo, bup and vob files there. The title-vobs are decrypted during this. 
.IP "-n, --title-number TITLE-NUMBER"
specify which title vobcopy shall copy (default is 1). On the dvd, vts_01_x.vob specify the first title (mostly main film).
.IP "-o, --output-dir OUTPUT-DIR"
specify the output-directory of the data.
.IP "-t, --name NAME"
you can give the file a name if you don't like the one from dvd, or, what might be of interest to some people, give "stdout" and get the file to stdout! Useful for pipeing it to /dev/null ;-) If you forget to pipe it to some place, your terminal will get garbled, so remember that typing "reset" and then Enter will rescue you.
If you want to give it names like "Huh I like this movie", do it in quotation marks.
.IP "-v, --verbose"
prints more information about whats going on (more verbose).
.IP "-v -v"
prints the information given on command line into a log-file in /tmp/ for 
inclusion into a bugreport.
.IP "-I, --info"
prints information about the titles, chapters and angles on the dvd.
.IP "-V, --version"
prints version number.
.IP "-1, --1st_alt_output_dir AUXILIARY-OUTPUT-DIR1"
if the data doesn't fit on the first output-directory (specified behind -o)
writing will continue here (and after -2 there and -3 and -4) -> the files will be split according to the remaining free space (try specifying the path _directly_ behind -1, _no_ space in between if you have troubles, this might be even necessary at -o...)
.SH BUGS
Vobcopy is still under heavy development. So expect some.
There *might* be problems for users who's system is not large-file ready. If so, please get back to me.
.SH AUTHOR
Robos <robos@muon.de>