Added new eject_opts option for greater flexibility.
[rip_dvd/.git] / README
diff --git a/README b/README
index 0f2d206d228421aa6fc232b46f540a201ee47056..2516b7993f6928a3c969242d34e3d9b896935d74 100644 (file)
--- a/README
+++ b/README
@@ -4,10 +4,21 @@ DEPENDENCIES
 The following packages need to be installed on your system:
 
 Package Dependencies (apt-get install these for example):
-lsdvd dvdauthor gddrescue dvdbackup tovid mencoder mplayer genisoimage libdvdcss2
+lsdvd dvdauthor gddrescue dvdbackup tovid mencoder mplayer genisoimage gpac ogmtools
+
+The libdvdcss2 package is also needed, but can only be downloaded from the medibuntu repository:
+https://help.ubuntu.com/community/Medibuntu
+
+NOTE:  In Ubuntu, depending on your version, replace libdvdcss2 with what you find on this page.
+  https://help.ubuntu.com/community/RestrictedFormats/PlayingDVDs
+
+NOTE:  After apt-get install on Ubuntu you may need to run this:
+  sudo /usr/share/doc/libdvdread4/install-css.sh
 
 Specific Executable (program) Dependencies (must be found in $PATH):
-volname makexml lsdvd dvdauthor gddrescue dvdbackup mencoder mplayer mkisofs
+volname makexml lsdvd dvdauthor ddrescue dvdbackup mencoder mplayer mkisofs
+
+NOTE:  The script puts /usr/share/tovid on your path which should contain makexml
 
 Optional Dependencies:
 lookup imdb info/posters for mythvideo: http://www.mythtv.org/wiki/Fill_mythvideo_metadata.pl
@@ -108,14 +119,14 @@ else on your system and change it appropriately to meet your needs.
 COMMAND LINE EXAMPLES
 ----------------------------------------------
 
-Rip a DVD into a compressed AVI file with default xvidvhq profile:
-> rip_dvd -d /path/to/dest/dir -b 2000 -x
+Rip a DVD into a compressed AVI file with default xvidhq profile:
+> rip_dvd -d /path/to/dest/dir -b 2000 -z
 
-Rip a DVD into a compressed AVI file with default xvidvhq profile scaling to 320x240 compressed video size:
-> rip_dvd -d /path/to/dest/dir -b 2000 -x -a 320:240
+Rip a DVD into a compressed AVI file with default xvidhq profile scaling to 320x240 compressed video size:
+> rip_dvd -d /path/to/dest/dir -b 2000 -z -a 320:240
 
-Rip a DVD into a compressed AVI file with default xvidvhq profile targetting a certain compressed video filesize (in MB):
-> rip_dvd -d /path/to/dest/dir -b 2000 -x -s 650
+Rip a DVD into a compressed AVI file with default xvidhq profile targetting a certain compressed video filesize (in MB):
+> rip_dvd -d /path/to/dest/dir -b 2000 -z -s 650
 
 Rip a DVD into a VOB file:
 > rip_dvd -d /path/to/dest/dir -v
@@ -127,18 +138,18 @@ Rip a DVD into a burnable DVD compliant folder (creating VIDEO_TS and AUDIO_TS f
 > rip_dvd -d /path/to/dest/dir -f
 
 Rip a VOB file into a compressed AVI file:
-> rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/file.vob
+> rip_dvd -d /path/to/dest/dir -b 2000 -z -n /path/to/file.vob
 
 Rip a DVD Folder into a compressed AVI file:
-> rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/dvd/folder/that/contains/a/VIDEO_TS
+> rip_dvd -d /path/to/dest/dir -b 2000 -z -n /path/to/dvd/folder/that/contains/a/VIDEO_TS
 
 Rip a DVD into a compressed MP4 file for an ipod:
-> rip_dvd -d /path/to/dest/dir -b 2000 -x -p ipod
+> rip_dvd -d /path/to/dest/dir -b 2000 -z -p ipod
 
 Rip a DVD into a compressed MP4 file for an ipod AND again for a compressed AVI file:
 > dvdname=`volname /dev/dvd | awk '{ print $1 }'`
 > rip_dvd -d /path/to/dest/dir -v
-> rip_dvd -d /path/to/dest/dir/ipod -b 2000 -x -p ipod -n /path/to/dest/dir/$dvdname.VOB
-> rip_dvd -d /path/to/dest/dir/xvid -b 2000 -x -p xvidvhq -n /path/to/dest/dir/$dvdname.VOB
+> rip_dvd -d /path/to/dest/dir/ipod -b 2000 -z -p ipod -n /path/to/dest/dir/$dvdname.VOB
+> rip_dvd -d /path/to/dest/dir/xvid -b 2000 -z -p xvidhq -n /path/to/dest/dir/$dvdname.VOB
 > rm /path/to/dest/dir/$dvdname.VOB