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 ----------------------------------------------
  29 CONFIGURATION
  30 ----------------------------------------------
  31 You'll need to copy the rip_dvd.conf.dist file to a local copy of the
  32 file called rip_dvd.conf. This way, you can customize the settings
  33 needed by the script in a file that isn't tracked by GIT. The conf
  34 file tracked by GIT (rip_dvd.conf.dist) will then contain the defaults
  35 the script needs to run. You can override these in your own rip_dvd.conf
  36 file you create locally.  This will allow you to get updates from my
  37 GIT repository at a later point in time without blowing away your
  38 local settings.
  39
  40 ----------------------------------------------
  41 MYTHTV MENU SETUP
  42 ----------------------------------------------
  43 Copy the menu files provided in the GIT repository to your mythtv
  44 menu location:
  45
  46 > cp optical_menu.xml /usr/share/mythtv/
  47 > cp rip_dvd_menu.xml /usr/share/mythtv/
  48
  49 You'll also need to edit the rip_dvd_menu.xml file so that the paths,
  50 commands, buttons, actions, meet your needs to accomplish the common
  51 encoding tasks you will want to do.
  52
  53 The optical_menu.xml file was modified with a single entry for the
  54 rip_dvd_menu.xml file. You can take a look at this entry in this file
  55 and place it in any xml file you want to get it on the menu you want.
  56 I choose to place it on the optical menu.
  57
  58 ----------------------------------------------
  59 COMMAND LINE EXAMPLES
  60 ----------------------------------------------
  61
  62 Rip a DVD into a compressed AVI file with default xvid profile:
  63 > rip_dvd -d /path/to/dest/dir -b 2000 -x
  64
  65 Rip a DVD into a compressed AVI file with default xvid profile scaling to 320x240 compressed video size:
  66 > rip_dvd -d /path/to/dest/dir -b 2000 -x -a 320:240
  67
  68 Rip a DVD into a compressed AVI file with default xvid profile targetting a certain compressed video filesize (in MB):
  69 > rip_dvd -d /path/to/dest/dir -b 2000 -x -s 650
  70
  71 Rip a DVD into a VOB file:
  72 > rip_dvd -d /path/to/dest/dir -v
  73
  74 Rip a DVD into an ISO file:
  75 > rip_dvd -d /path/to/dest/dir -m
  76
  77 Rip a DVD into a burnable DVD compliant folder (creating VIDEO_TS and AUDIO_TS folders):
  78 > rip_dvd -d /path/to/dest/dir -f
  79
  80 Rip a VOB file into a compressed AVI file:
  81 > rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/file.vob
  82
  83 Rip a DVD Folder into a compressed AVI file:
  84 > rip_dvd -d /path/to/dest/dir -b 2000 -x -n /path/to/dvd/folder/that/contains/a/VIDEO_TS
  85
  86 Rip a DVD into a compressed MP4 file for an ipod:
  87 > rip_dvd -d /path/to/dest/dir -b 2000 -x -p ipod
  88
  89 Rip a DVD into a compressed MP4 file for an ipod AND again for a compressed AVI file:
  90 > dvdname=`volname /dev/dvd | awk '{ print $1 }'`
  91 > rip_dvd -d /path/to/dest/dir -v
  92 > rip_dvd -d /path/to/dest/dir/ipod -b 2000 -x -p ipod -n /path/to/dest/dir/$dvdname.VOB
  93 > rip_dvd -d /path/to/dest/dir/xvid -b 2000 -x -p xvid -n /path/to/dest/dir/$dvdname.VOB
  94 > rm /path/to/dest/dir/$dvdname.VOB
  95