I.   ABOUT

   dvd::rip is a Perl Gtk+ based DVD copy program build on top of a low
   level DVD Ripping API, which uses the Linux Video Stream Processing
   Tool transcode, written by Thomas Oestreich.

   It simplifies the whole process of making copies of your DVDs using a
   straightforward 4 step strategy:

    1. Specify file system storage locations.
    2. Read TOC from DVD, select a title and rip it.
    3. Adjust clipping and zooming parameters.
    4. Set transcode options and go!

   Also dvd::rip has a powerful cluster mode which will use all your
   hardware to increase transcode performance by parallel encoding.

   For the impatient: here is a short list of dvd::rip's major
   features.

II.  NOTE

   This README is automatically generated from the same sources which
   are used for the dvd::rip homepage. You'll allways get the latest
   news and information from the homepage.
   
     http://www.exit1.org/dvdrip/
   
   Also the homepage contains an extensive user documentation for
   standard and cluster mode, with screenshots, diagrams and more.
   This README covers only the installation not the usage of dvd::rip.
   
III. INSTALLATION

   This documentation page covers dvd::rip 0.45.

   dvd::rip is a Gtk+ based program written in Perl, using the video
   processing tool transcode for the internals. So you first have to
   comply some prerequisites before installing dvd::rip.

transcode

   dvd::rip delegates all the low level DVD handling to transcode, which
   can be obtained here:

     [3]http://www.theorie.physik.uni-goettingen.de/~ostreich/transcode/

   dvd::rip expects all transcode binaries to be found in the standard
   search PATH.

   If you plan to create (S)VCD's you must compile transcode with the
   mjpeg export filter module.

   Note: For almost any Linux distribution exist binary transcode
   packages. Compiling transcode isn't an easy task, so you should try
   binary packages first. Refer to the [4]download page for details.

Image Magick

   For image processing dvd::rip uses the widely distributed software
   package Image Magick, at least the programs identify and convert
   should be installed on your system. All versions above version 4
   should work (actually tested with 5.3.1). dvd::rip does not use Perl
   Magick.

   If your Linux distribution does not ship Image Magick, you can find it
   here:

     [5]http://www.imagemagick.org/

   dvd::rip expects the Image Magick binaries to be found in the standard
   search PATH.

Perl Gtk Module

   For its GUI component dvd::rip needs the Perl Gtk module, which
   presumes Gtk+ version 1.2 or higher. I tested dvd::rip with Perl Gtk
   0.7008.

   You can find the Gtk module on CPAN, e.g.:

     [6]http://www.perl.org/CPAN/modules/by-module/Gtk/

   Note:
   Perl Gtk detects your installed Gtk libs and build sub components only
   if the correspondent Gtk library was found.

   dvd::rip needs the Gtk::Gdk::Pixbuf component which needs gdk-pixbuf
   to be installed on your system. So first make sure, that gdk-pixbuf is
   installed. Then install Perl Gtk and everything should work as
   expected.

mplayer and/or xine (with a DVD plugin)

   If you have mplayer or xine (with the d4d or dvdnav plugin) installed,
   you can preview selected DVD titles/chapters with the appropriate
   audio channels.

   You can download xine and mplayer from here:

     [7]http://xine.sourceforge.net/
     [8]http://www.mplayerhq.hu/

   dvd::rip expects the player binaries to be found in the standard
   search PATH.

Installing / Updating dvd::rip itself

   This is quite easy, if you have managed installing the packages
   mentioned above... ;)

   [9]Download the .tar.gz archive of the dvd::rip version you want to
   install. Then extract the file, change into the created directory,
   generate the Makefile and execute make:

     # as a normal user
     tar xfz Video-DVDRip-0.45.tar.gz
     cd Video-DVDRip-x.xx
     perl Makefile.PL
     make
     make test

   If the "make test" reported no errors, you can install the files into
   your Perl library path. Maybe you must be root to do this:

     # become root
     su
     make install

   You can ommit the "make install" step. But then you can execute the
   'dvdrip' binary only from the build directory, otherwise dvd::rip
   can't find its files.

   Note: If you execute 'make test' as root, you most probably get an
   error message about a missing 'splitpipe' command. This is because
   root hasn't the actual directory in PATH and so dvd::rip can't find
   the splitpipe program. Do only the 'make install' as root. As well for
   security reasons you shouldn't compile packages as root.

   Read the Changes file

   I strongly suggest you reading at least the latest change log entry of
   the Changes file, resp. all entries of the versions you probably
   skipped in case of an update. It contains important release notes,
   e.g. about compatibility issues, and all relevant changes from release
   to release.

Additional steps for cluster mode

   First ensure that you're using transcode version 0.6.0pre4-20020322 or
   better, because cluster mode doesn't work with earlier versions.

Perl modules

   Additionally you need the Storable and the Event Perl modules. You can
   find them on CPAN, e.g.:

     [10]http://www.perl.org/CPAN/modules/by-module/Storable/
     [11]http://www.perl.org/CPAN/modules/by-module/Event/

fping and pstree

   The dvd::rip cluster control daemon uses fping to check if nodes are
   online and pstree to get information about specific child processes.
   Both tools should be shipped with your Linux distribution (fping
   sometimes isn't, but you can get it here: [12]http://www.fping.com/).

   Note: Matthias Riese told me that there are IPv6 fping packages which
   don't support IPv4, what's most likely not what you want, so pay
   attention to get the right version ("ipv6" should not occur in the
   package name).

   dvd::rip expects fping to be installed set-uid root (because you
   hopefully don't run dvd::rip as root ;), which is not the default for
   most distributions. Please set the set-uid flag by typing this command
   as root:

     chmod u+s /usr/sbin/fping

   If fping is installed in another location, set a symlink to
   /usr/sbin/fping, because dvd::rip expects it there.

   Note: These steps are necessary only on the computer, where the
   cluster control daemon runs. All slave nodes of a dvd::rip cluster
   only need transcode installed, dvd::rip or any packages mentioned here
   aren't needed there.

URL References

   1. http://www.exit1.org/dvdrip/doc/install.cipp
   2. http://www.exit1.org/dvdrip/doc/install.cipp?print=1
   3. http://www.theorie.physik.uni-goettingen.de/~ostreich/transcode/
   4. http://www.exit1.org/dvdrip/download.cipp
   5. http://www.imagemagick.org/
   6. http://www.perl.org/CPAN/modules/by-module/Gtk/
   7. http://xine.sourceforge.net/
   8. http://www.mplayerhq.hu/
   9. http://www.exit1.org/dvdrip/download.cipp
  10. http://www.perl.org/CPAN/modules/by-module/Storable/
  11. http://www.perl.org/CPAN/modules/by-module/Event/
  12. http://www.fping.com/

IV.  SOURCE DOWNLOAD

   You can download dvd::rip sources from this server or all stable
   releases from any CPAN mirror.

   Local download of the latest stable release:

     [3]Video-DVDRip-0.45.tar.gz

   CPAN download directory:

     [4]http://www.perl.org/CPAN/modules/by-authors/id/J/JR/JRED/

   Here you can get a list of CPAN mirrors:

     [5]http://www.perl.org/CPAN/SITES.html

   You can download older versions from here:

     [6]http://www.exit1.org/dvdrip/dist/
     [7]http://www.exit1.org/dvdrip/dist/pre/

RPM's and other contributed downloads

   I do not provide RPM archives myself, but other dvd::rip users are so
   kind to build some. You'll find them in my contribution directory,
   beside other interesting donated stuff:

     [8]http://www.exit1.org/dvdrip/contrib/

   Please understand that I can't offer any support for these files.

Debian packages

   Christian Marillat <marillat.christian AT wanadoo.fr> does a great job
   building video related Debian packages and publishing them on his
   website [9]http://marillat.free.fr/. You can use apt-get to install
   the packages if you add the following entries to your
   /etc/apt/sources.list file:
  deb http://marillat.free.fr/ testing main
  deb http://marillat.free.fr/ unstable main

   You will find all packages to compile transcode on your own (if you
   need always the very latest versions), or can get binaries of
   reasonably recent transcode versions directly. The same applies to
   dvd::rip.

SuSE packages

   Rainer Ley maintains several video related SuSE RPM's, including
   transcode and dvd::rip. Refer to his download page:

     [10]http://www6.informatik.uni-erlangen.de/~rainer/rpms/

Mandrake packages

   Mandrake users can get actual dvd::rip RPM's from the Penguin
   Liberation Front lair.

     [11]http://plf.zarb.org/

Anonymous CVS access

   Note: this is intended for developers and documentation translators.
   This CVS repository is only a read only mirror of my main repository.
   It's updated manually when I publish releases or pre-releases, so
   there is no advantage for normal users compared to downloading the tar
   balls mentioned above (besides making it easier using "cvs update" ;)

   Root                            Module
   :pserver:cvs@cvs.exit1.org:/cvs dvdrip

URL References

   1. http://www.exit1.org/dvdrip/download.cipp
   2. http://www.exit1.org/dvdrip/download.cipp?print=1
   3. http://www.exit1.org/dvdrip/dist/Video-DVDRip-0.45.tar.gz
   4. http://www.perl.org/CPAN/modules/by-authors/id/J/JR/JRED/
   5. http://www.perl.org/CPAN/SITES.html
   6. http://www.exit1.org/dvdrip/dist/
   7. http://www.exit1.org/dvdrip/dist/pre/
   8. http://www.exit1.org/dvdrip/contrib/
   9. http://marillat.free.fr/
  10. http://www6.informatik.uni-erlangen.de/~rainer/rpms/
  11. http://plf.zarb.org/

V.   MAILING LIST

   If you want to discuss usage, problems and suggestions with other
   dvd::rip users, you should subscribe to the dvdrip-users mailing list.
   This list is low traffic and announces, patches etc. will be posted
   here, too.

   The language of the mailing list is english, although the author and
   many users and contributors are germans (or at least speak german ;).

   Note: this is a closed mailing list to prevent members from getting
   flooded by spam. So you have to subscribe before posting. Postings
   from non subscribed users may be discarded without notification! Also
   you must use the correct sender address, because the mailing list
   program has no idea of your alternative mail addresses.

   IMPORTANT NOTE: please don't post any illegal stuff here, e.g.
   requests for movie downloads or similar stuff! Mailing list members
   breaking this simple rule will be removed immediately.

     * [3]Mailing list subscription
     * [4]Mailing list archive

   Because dvd::rip is highly transcode related, I suggest subscribing to
   the [5]transcode-user mailing list, too.

URL References

   1. http://www.exit1.org/dvdrip/list.cipp
   2. http://www.exit1.org/dvdrip/list.cipp?print=1
   3. http://lists.exit1.org/mailman/listinfo/dvdrip-users
   4. http://lists.exit1.org/pipermail/dvdrip-users/
   5. http://www.theorie.physik.uni-goettingen.de/mailman/listinfo/transcode-users

VI.  COPYRIGHT / CONTACT

   Copyright (C) 2001-2002 by Jrn Reder, All Rights Reserved.

   dvd::rip is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.

   You can contact me by mail: [3]Jrn Reder <joern AT zyn.de>. Please
   place the word "dvd::rip" everywhere in the subject, in addition to
   your real topic, because this helps me classifying your email
   correctly. Thanks.

   In case of a bug report: please always tell me which version of
   dvd::rip and transcode you're using, otherwise I often have to guess
   wildly what's going wrong.

   If users send me suggestions and bug reports I usually add them with
   their name and email address to the Changes or TODO file. If you are
   concerned about privacy, then please tell me that you don't want to be
   listed and I omit that. I fully understand if privacy matters for you.

   I'm native german speaker, so you can send your mails in german, if
   you want. The others have to accept my rough english ;)

   And: consider subscription and posting to the [4]dvdrip-users mailing
   list list.

URL References

   1. http://www.exit1.org/dvdrip/copyright.cipp
   2. http://www.exit1.org/dvdrip/copyright.cipp?print=1
   3. mailto:?subject=dvd::rip
   4. http://lists.exit1.org/mailman/listinfo/dvdrip-users

VII. CHANGES
   $Id: Changes,v 1.104 2002/09/22 14:38:56 joern Exp $

   Revision history for dvd::rip

   0.45 Sun 22 Sep 2002, joern
	Important note:
	===============
	- File format changed with release 0.45_04. Files created with
	  older versions will be converted automatically, but can't
	  be used with older versions anymore after saving!!!
	  Consider making backup copies of your project files.
	- This version of dvd::rip works with transcode 0.6.0 and
