X-Git-Url: http://git.pippins.net/embedvideo/.git/static/git-logo.png?a=blobdiff_plain;f=README;h=dd7efa30e5f71cbd1d696a033c0509b059e2231f;hb=e2d5d785cc746bb0b093cbcb91a7870265cba022;hp=3c4ef2126df92601934e40a4667211dcfe36d854;hpb=d67d8803018a0dcff83dbd3357bce917b8353014;p=rip_dvd%2F.git

diff --git a/README b/README
index 3c4ef21..dd7efa3 100644
--- a/README
+++ b/README
@@ -1,3 +1,20 @@
+----------------------------------------------
+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
+
+Specific Executable (program) Dependencies (must be found in $PATH):
+volname makexml lsdvd dvdauthor gddrescue dvdbackup mencoder mplayer mkisofs
+
+Optional Dependencies:
+lookup imdb info/posters for mythvideo: http://www.mythtv.org/wiki/Fill_mythvideo_metadata.pl
+
+----------------------------------------------
+INSTALL
+----------------------------------------------
 The following steps should be followed to pull this code project
 into a local GIT repository (local directory):
 
@@ -8,3 +25,96 @@ To pull updates in the future of this project into your local directory:
 > cd rip_dvd
 > git pull origin
 
+----------------------------------------------
+ENABLING XVID TO ENCODE USING MULTICORES
+----------------------------------------------
+The libxvidcore4 package that you can get through ubuntu or debian
+is version 1.1.0. They didn't enable multi-core encoding using this
+library until version 1.2.0. Since you can't get that in a package,
+you can build it from source easily. Since the xvid codec (this lib)
+is used by mencoder by rip_dvd in all of its xvid profiles (the default),
+you can speed up the encode process quite a bit if you enable multi-cores.
+Follow these instructions to enable the xvid encoding to use multi-cores:
+
+> wget http://downloads.xvid.org/downloads/xvidcore-1.2.1.tar.gz
+> gunzip xvidcore-1.2.1.tar.gz
+> tar xvf xvidcore-1.2.1.tar
+> cd xvidcore/build/generic
+> ./configure --prefix=/usr
+> make
+> sudo make install
+> cd /usr/lib
+> sudo rm libxvidcore.so.4
+> sudo ln -s libxvidcore.so.4.2 libxvidcore.so.4
+
+After you do these steps, when rip_dvd is running using any xvid profile,
+you will note with 'top' that the mencoder process is using > 100% of your CPU.
+
+----------------------------------------------
+CONFIGURATION
+----------------------------------------------
+You'll need to copy the rip_dvd.conf.dist file to a local copy of the
+file called rip_dvd.conf. This way, you can customize the settings
+needed by the script in a file that isn't tracked by GIT. The conf
+file tracked by GIT (rip_dvd.conf.dist) will then contain the defaults
+the script needs to run. You can override these in your own rip_dvd.conf
+file you create locally.  This will allow you to get updates from my
+GIT repository at a later point in time without blowing away your 
+local settings.
+
+----------------------------------------------
+MYTHTV MENU SETUP
+----------------------------------------------
+Copy the menu files provided in the GIT repository to your mythtv
+menu location:
+
+> cp optical_menu.xml /usr/share/mythtv/
+> cp rip_dvd_menu.xml /usr/share/mythtv/
+
+You'll also need to edit the rip_dvd_menu.xml file so that the paths,
+commands, buttons, actions, meet your needs to accomplish the common
+encoding tasks you will want to do.
+
+The optical_menu.xml file was modified with a single entry for the
+rip_dvd_menu.xml file. You can take a look at this entry in this file
+and place it in any xml file you want to get it on the menu you want.
+I choose to place it on the optical menu.
+
+----------------------------------------------
+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 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 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 VOB file:
+> rip_dvd -d /path/to/dest/dir -v
+
+Rip a DVD into an ISO file:
+> rip_dvd -d /path/to/dest/dir -m
+
+Rip a DVD into a burnable DVD compliant folder (creating VIDEO_TS and AUDIO_TS folders):
+> 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 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 a DVD into a compressed MP4 file for an ipod:
+> rip_dvd -d /path/to/dest/dir -b 2000 -x -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
+> rm /path/to/dest/dir/$dvdname.VOB
+