Updated usage to reflect ability to rip directly from VOB

[rip_dvd/.git] / README

diff --git a/README b/README
index 89e8224716c4629fbdb1d1a7016c492c385064fe..e53819b7384ed242cc76c3245523381ac9636ec5 100644 (file)
--- a/README
+++ b/README
@@ -12,6 +12,11 @@ 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
 
+Windows Dependencies:
+To play back the videos in windows that use the divx encoding profiles, you'll
+need to download and install the xvid codec:
+http://www.koepi.info/xvid.html
+
 ----------------------------------------------
 INSTALL
 ----------------------------------------------
@@ -25,6 +30,34 @@ To pull updates in the future of this project into your local directory:
 > cd rip_dvd
 > git pull origin
 
+To see the changelog for what you have pulled, run this command:
+> git whatchanged
+
+----------------------------------------------
+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
 ----------------------------------------------
@@ -35,7 +68,13 @@ 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.
+local settings. You can put your copy of the rip_dvd.conf file in 
+any of the following locations:
+
+ 1) /path/to/rip_dvd/script/rip_dvd.conf.dist
+ 2) /path/to/rip_dvd/script/rip_dvd.conf
+ 3) /etc/rip_dvd.conf
+ 4) /path/to/where/rip_dvd/is/run/from/rip_dvd.conf
 
 ----------------------------------------------
 MYTHTV MENU SETUP
@@ -55,6 +94,13 @@ 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.
 
+The menu items in these examples call the rip_dvd.wrap script.
+This is a simple script I wrote to implementation hide the full
+command line options for rip_dvd from the mythtv menu system.
+I also use this wrapper script to determine where to put the
+ripped DVD images. You can copy this example and call it something
+else on your system and change it appropriately to meet your needs.
+
 ----------------------------------------------
 COMMAND LINE EXAMPLES
 ----------------------------------------------