README

   1 ----------------------------------------------
   2 DEPENDENCIES
   3 ----------------------------------------------
   4 The following packages need to be installed on your system:
   5
   6 Package Dependencies (apt-get install these for example):
   7 lsdvd dvdauthor gddrescue dvdbackup tovid mencoder mplayer genisoimage libdvdcss2
   8
   9 Specific Executable (program) Dependencies (must be found in $PATH):
  10 volname makexml lsdvd dvdauthor gddrescue dvdbackup mencoder mplayer mkisofs
  11
  12 Optional Dependencies:
  13 lookup imdb info/posters for mythvideo: http://www.mythtv.org/wiki/Fill_mythvideo_metadata.pl
  14
  15 ----------------------------------------------
  16 INSTALL
  17 ----------------------------------------------
  18 The following steps should be followed to pull this code project
  19 into a local GIT repository (local directory):
  20
  21 This command will create a directory called "rip_dvd" in the CWD and pull the code for this project:
  22 > git clone http://git.pippins.net/rip_dvd/.git rip_dvd
  23
  24 To pull updates in the future of this project into your local directory:
  25 > cd rip_dvd
  26 > git pull origin
  27
  28 To see the changelog for what you have pulled, run this command:
  29 > git whatchanged
  30
  31 ----------------------------------------------
  32 ENABLING XVID TO ENCODE USING MULTICORES
  33 ----------------------------------------------
  34 The libxvidcore4 package that you can get through ubuntu or debian
  35 is version 1.1.0. They didn't enable multi-core encoding using this
  36 library until version 1.2.0. Since you can't get that in a package,
  37 you can build it from source easily. Since the xvid codec (this lib)
  38 is used by mencoder by rip_dvd in all of its xvid profiles (the default),
  39 you can speed up the encode process quite a bit if you enable multi-cores.
  40 Follow these instructions to enable the xvid encoding to use multi-cores:
  41
  42 > wget http://downloads.xvid.org/downloads/xvidcore-1.2.1.tar.gz
  43 > gunzip xvidcore-1.2.1.tar.gz
  44 > tar xvf xvidcore-1.2.1.tar
  45 > cd xvidcore/build/generic
  46 > ./configure --prefix=/usr
  47 > make
  48 > sudo make install
  49 > cd /usr/lib
  50 > sudo rm libxvidcore.so.4
  51 > sudo ln -s libxvidcore.so.4.2 libxvidcore.so.4
  52
  53 After you do these steps, when rip_dvd is running using any xvid profile,
  54 you will note with 'top' that the mencoder process is using > 100% of your CPU.
  55
  56 ----------------------------------------------
  57 CONFIGURATION
  58 ----------------------------------------------
  59 You'll need to copy the rip_dvd.conf.dist file to a local copy of the
  60 file called rip_dvd.conf. This way, you can customize the settings
  61 needed by the script in a file that isn't tracked by GIT. The conf
  62 file tracked by GIT (rip_dvd.conf.dist) will then contain the defaults
  63 the script needs to run. You can override these in your own rip_dvd.conf
  64 file you create locally.  This will allow you to get updates from my
  65 GIT repository at a later point in time without blowing away your
  66 local settings.
  67
  68 ----------------------------------------------
  69 MYTHTV MENU SETUP
  70 ----------------------------------------------
  71 Copy the menu files provided in the GIT repository to your mythtv
  72 menu location:
  73
  74 > cp optical_menu.xml /usr/share/mythtv/
  75 > cp rip_dvd_menu.xml /usr/share/mythtv/
  76
  77 You'll also need to edit the rip_dvd_menu.xml file so that the paths,
  78 commands, buttons, actions, meet your needs to accomplish the common
  79 encoding tasks you will want to do.
  80
  81 The optical_menu.xml file was modified with a single entry for the
  82 rip_dvd_menu.xml file. You can take a look at this entry in this file
  83 and place it in any xml file you want to get it on the menu you want.
  84 I choose to place it on the optical menu.
  85
  86 ----------------------------------------------
  87 COMMAND LINE EXAMPLES
  88 ----------------------------------------------
  89
  90 Rip a DVD into a compressed AVI file with default xvidvhq profile:
  91 > rip_dvd -d /path/to/dest/dir -b 2000 -x
  92
  93 Rip a DVD into a compressed AVI file with default xvidvhq profile scaling to 320x240 compressed video size:
  94 > rip_dvd -d /path/to/dest/dir -b 2000 -x -a 320:240
  95
  96 Rip a DVD into a compressed AVI file with default xvidvhq profile targetting a certain compressed video filesize (in MB):
  97 > rip_dvd -d /path/to/dest/dir -b 2000 -x -s 650
  98
  99 Rip a DVD into a VOB file:
 100 > rip_dvd -d /path/to/dest/dir -v
 101
 102 Rip a DVD into an ISO file:
 103 > rip_dvd -d /path/to/dest/dir -m
 104
 105 Rip a DVD into a burnable DVD compliant folder (creating VIDEO_TS and AUDIO_TS folders):
 106 > rip_dvd -d /path/to/dest/dir -f
 107
 108 Rip a VOB file into a compressed AVI file:
 109 > rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/file.vob
 110
 111 Rip a DVD Folder into a compressed AVI file:
 112 > rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/dvd/folder/that/contains/a/VIDEO_TS
 113
 114 Rip a DVD into a compressed MP4 file for an ipod:
 115 > rip_dvd -d /path/to/dest/dir -b 2000 -x -p ipod
 116
 117 Rip a DVD into a compressed MP4 file for an ipod AND again for a compressed AVI file:
 118 > dvdname=`volname /dev/dvd | awk '{ print $1 }'`
 119 > rip_dvd -d /path/to/dest/dir -v
 120 > rip_dvd -d /path/to/dest/dir/ipod -b 2000 -x -p ipod -n /path/to/dest/dir/$dvdname.VOB
 121 > rip_dvd -d /path/to/dest/dir/xvid -b 2000 -x -p xvidvhq -n /path/to/dest/dir/$dvdname.VOB
 122 > rm /path/to/dest/dir/$dvdname.VOB
 123