I.   ABOUT

   dvd::rip is a full featured DVD copy program written in Perl. It
   provides an easy to use but feature-rich Gtk+ GUI to control almost
   all aspects of the ripping and transcoding process. It uses the widely
   known video processing swissknife transcode and many other Open
   Source tools. dvd::rip itself is licensed under GPL / Perl Artistic
   License.

            "And note: it's spelled dvd::rip, and nothing else."

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. DOCUMENTATION

[3]1. Installation
     _________________________________________________________________

     * [4]1.1 Binary distributions

     * [5]1.1.1 Debian packages
     * [6]1.1.2 SuSE packages
     * [7]1.1.3 Mandrake packages
     * [8]1.1.4 RedHat packages
     * [9]1.1.5 RedHat-8.0-only packages
     * [10]1.1.6 gentoo packages

     [11]1.2 Source download
     * [12]1.2.1 dvd::rip tarball download
     * [13]1.2.2 CVS access

     [14]1.3 Install from source
     * [15]1.3.1 Requirements
     * [16]1.3.2 Install dvd::rip
     * [17]1.3.3 Update dvd::rip

     [18]1.4 Download this documentation
     _________________________________________________________________

   This chapter describes how you can get and install dvd::rip. You can
   try one of the several binary distributions or install it from the
   source.

[19]1.1 Binary distributions

   [ [20]Content ] [ [21]Top ]

   Installation of dvd::rip isn't that hard, but fulfilling the
   requirements actually is. So you should first try a binary
   installation using the package manager of your Linux distribution.
   This tracks all dependencies automatcially and should speed up things
   significantly.

[22]1.1.1 Debian packages

   Christian Marillat builds video related Debian packages and publishes
   them on his website [23]http://marillat.free.fr/. You can use apt-get
   to install the packages if you add one of the following entries
   (depending on your distribution) 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.

[24]1.1.2 SuSE packages

   Rainer Ley builds dvd::rip SuSE RPM's you can download from the
   contrib directory:

     [25]http://www.exit1.org/dvdrip/contrib/suse/

   On his homepage you find several video related RPM's, including
   transcode:

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

[27]1.1.3 Mandrake packages

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

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

[29]1.1.4 RedHat packages

   A kind RedHat user (who wants to stay anonymous) builds dvd::rip
   RedHat RPM's, you can download from the contrib directory:

     [30]http://www.exit1.org/dvdrip/contrib/redhat/

[31]1.1.5 RedHat-8.0-only packages

   Michel Alexandre Salim maintains an apt repository with the very
   latest snapshots of transcode and dvd::rip. It's for RedHat 8.0 only:

     [32]http://messlab.sourceforge.net

[33]1.1.6 gentoo packages

   You can get dvd::rip and transcode from the official gentoo package
   repository:

     [34]http://www.gentoo.org/packages/media-video/dvdrip.html

[35]1.2 Source download

   [ [36]Content ] [ [37]Top ]

[38]1.2.1 dvd::rip tarball 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:

     [39]Video-DVDRip-0.48.5.tar.gz

   CPAN download directory: ([40]list of mirrors)

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

   You can download older versions from here:

     [42]http://www.exit1.org/dvdrip/dist/
     [43]http://www.exit1.org/dvdrip/dist/pre/

[44]1.2.2 CVS access

   Note: this is mainly intended for developers. 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 (besides making it
   easier using "cvs update" ;)

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

[45]1.3 Install from source

   [ [46]Content ] [ [47]Top ]

[48]1.3.1 Requirements

   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.

   dvd::rip expects all command line tools mentioned here to be found in
   the standard search PATH.

[49]1.3.1.1 transcode

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

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

   Version 0.6.1 is recommended, but 0.6.0 should work, too.

   If you plan to create (S)VCD's you must compile transcode with the
   mjpeg export filter module. transcode's internal bbmpeg filter isn't
   supported yet.

   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 [51]binaries section for details.

[52]1.3.1.2 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:

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

[54]1.3.1.3 ogmtools

   dvd::rip has support for generating audio / video ogg streams (often
   known as OGM streams). You need a recent version of ogmtools for that
   to work:

     [55]http://www.bunkus.org/videotools/ogmtools/index.html

   dvd::rip expects version 0.954 or higher.

[56]1.3.1.4 subtitleripper

   To get subtitles with dvd::rip you need a recent version of the
   subtitleripper package. It's shipped with transcode in the
   contrib/subrip directory. You can use this version for transcode >=
   0.6.2.20021017. Otherwise fetch it from the subtitleripper homepage:

     [57]http://sourceforge.net/projects/subtitleripper

[58]1.3.1.5 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.:

     [59]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.

[60]1.3.1.6 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:

     [61]http://xine.sourceforge.net/
     [62]http://www.mplayerhq.hu/

[63]1.3.1.7 CD burning tools

   If you want to use dvd::rip's [64]CD burning module, you must have the
   following tools installed (in brackets the versions I use, maybe older
   versions work, too, but I recommend these):

     [65]mkisofs (1.15a34)
     [66]cdrecord (0.7.12)
     [67]vcdimager (0.7.12)
     [68]cdrdao (1.1.7)

[69]1.3.1.8 Additional requirements for cluster mode

   Some additional Perl modules and command line tools are needed for the
   cluster mode.

[70]1.3.1.9 Perl modules

   Cluster mode needs the Storable and Event Perl modules. Check if your
   distribution ships them already. If not, you can find them on CPAN:

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

[73]1.3.1.10 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: [74]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.

[75]1.3.2 Install dvd::rip

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

   [76]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.48.5.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.

[77]1.3.3 Update dvd::rip

   Updating is just like installing. The only thing you should be aware
   of is switching the underlying Perl version. This way you easily can
   get two versions of dvd::rip installed in your system, because
   dvd::rip installs its libraries in your Perl library directory. Such a
   installation mixing isn't recommended unless you know exactly what
   you're doing. So it's better to remove the old version from the old
   Perl directory if you change the Perl version.
   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.

[78]1.4 Download this documentation

   [ [79]Content ] [ [80]Top ]

   You can download a static HTML version of this documentation:

     [81]http://www.exit1.org/dvdrip/dist/dvdrip-doc-html.tar.bz2
     _________________________________________________________________

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.exit1.org/tmp/index.cipp
   4. http://www.exit1.org/tmp/install.cipp#binary_download
   5. http://www.exit1.org/tmp/install.cipp#debian
   6. http://www.exit1.org/tmp/install.cipp#suse
   7. http://www.exit1.org/tmp/install.cipp#mandrake
   8. http://www.exit1.org/tmp/install.cipp#redhat
   9. http://www.exit1.org/tmp/install.cipp#redhat-apt
  10. http://www.exit1.org/tmp/install.cipp#gentoo
  11. http://www.exit1.org/tmp/install.cipp#source_download
  12. http://www.exit1.org/tmp/install.cipp#source_tgz
  13. http://www.exit1.org/tmp/install.cipp#cvs
  14. http://www.exit1.org/tmp/install.cipp#install_source
  15. http://www.exit1.org/tmp/install.cipp#require
  16. http://www.exit1.org/tmp/install.cipp#install_dvdrip
  17. http://www.exit1.org/tmp/install.cipp#update_dvdrip
  18. http://www.exit1.org/tmp/install.cipp#docs_download
  19. http://www.exit1.org/tmp/genreadme19892.html#top
  20. http://www.exit1.org/tmp/index.cipp
  21. http://www.exit1.org/tmp/genreadme19892.html#top
  22. http://www.exit1.org/tmp/genreadme19892.html#top
  23. http://marillat.free.fr/
  24. http://www.exit1.org/tmp/genreadme19892.html#top
  25. http://www.exit1.org/dvdrip/contrib/suse/
  26. http://www6.informatik.uni-erlangen.de/~rainer/rpms/
  27. http://www.exit1.org/tmp/genreadme19892.html#top
  28. http://plf.zarb.org/
  29. http://www.exit1.org/tmp/genreadme19892.html#top
  30. http://www.exit1.org/dvdrip/contrib/redhat/
  31. http://www.exit1.org/tmp/genreadme19892.html#top
  32. http://messlab.sourceforge.net/
  33. http://www.exit1.org/tmp/genreadme19892.html#top
  34. http://www.gentoo.org/packages/media-video/dvdrip.html
  35. http://www.exit1.org/tmp/genreadme19892.html#top
  36. http://www.exit1.org/tmp/index.cipp
  37. http://www.exit1.org/tmp/genreadme19892.html#top
  38. http://www.exit1.org/tmp/genreadme19892.html#top
  39. http://www.exit1.org/dvdrip/dist/Video-DVDRip-0.48.5.tar.gz
  40. http://www.cpan.org/CPAN/SITES.html
  41. http://www.cpan.org/CPAN/modules/by-authors/id/J/JR/JRED/
  42. http://www.exit1.org/dvdrip/dist/
  43. http://www.exit1.org/dvdrip/dist/pre/
  44. http://www.exit1.org/tmp/genreadme19892.html#top
  45. http://www.exit1.org/tmp/genreadme19892.html#top
  46. http://www.exit1.org/tmp/index.cipp
  47. http://www.exit1.org/tmp/genreadme19892.html#top
  48. http://www.exit1.org/tmp/genreadme19892.html#top
  49. http://www.exit1.org/tmp/genreadme19892.html#top
  50. http://www.theorie.physik.uni-goettingen.de/~ostreich/transcode/
  51. http://www.exit1.org/tmp/install.cipp#binary_download
  52. http://www.exit1.org/tmp/genreadme19892.html#top
  53. http://www.imagemagick.org/
  54. http://www.exit1.org/tmp/genreadme19892.html#top
  55. http://www.bunkus.org/videotools/ogmtools/index.html
  56. http://www.exit1.org/tmp/genreadme19892.html#top
  57. http://sourceforge.net/projects/subtitleripper
  58. http://www.exit1.org/tmp/genreadme19892.html#top
  59. http://www.perl.org/CPAN/modules/by-module/Gtk/
  60. http://www.exit1.org/tmp/genreadme19892.html#top
  61. http://xine.sourceforge.net/
  62. http://www.mplayerhq.hu/
  63. http://www.exit1.org/tmp/genreadme19892.html#top
  64. http://www.exit1.org/tmp/gui-gui_burn.cipp
  65. http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/mkisofs.html
  66. http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html
  67. http://www.vcdimager.org/
  68. http://cdrdao.sourceforge.net/
  69. http://www.exit1.org/tmp/genreadme19892.html#top
  70. http://www.exit1.org/tmp/genreadme19892.html#top
  71. http://www.perl.org/CPAN/modules/by-module/Storable/
  72. http://www.perl.org/CPAN/modules/by-module/Event/
  73. http://www.exit1.org/tmp/genreadme19892.html#top
  74. http://www.fping.com/
  75. http://www.exit1.org/tmp/genreadme19892.html#top
  76. http://www.exit1.org/tmp/install.cipp#source_download
  77. http://www.exit1.org/tmp/genreadme19892.html#top
  78. http://www.exit1.org/tmp/genreadme19892.html#top
  79. http://www.exit1.org/tmp/index.cipp
  80. http://www.exit1.org/tmp/genreadme19892.html#top
  81. http://www.exit1.org/dvdrip/dist/dvdrip-doc-html.tar.bz2

IV.  
URL References

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.

   Before posting any questions or bug reports: please first check the
   [3]documentation, in particular the [4]FAQ.

   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.

     * [5]Mailing list subscription
     * [6]Mailing list archive

   Because dvd::rip is highly transcode related, I suggest subscribing to
   the [7]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://www.exit1.org/dvdrip/doc/
   4. http://www.exit1.org/dvdrip/doc/faq.cipp
   5. http://lists.exit1.org/mailman/listinfo/dvdrip-users
   6. http://www.exit1.org/dvdrip/htdig/search.cipp
   7. 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. And also first check the [4]documentation,
   in particular the [5]FAQ.

   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 [6]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://www.exit1.org/dvdrip/doc/
   5. http://www.exit1.org/dvdrip/doc/faq.cipp
   6. http://lists.exit1.org/mailman/listinfo/dvdrip-users

VII. CHANGES
   $Id: Changes,v 1.122.2.6 2002/12/07 08:43:10 joern Exp $

   Revision history and release notes for dvd::rip.

   0.48.5 Fri 7 Dec 2002, joern
	Bugfix:
	- 0.48.3 introduced a bug which prevents multiple audio
	  tracks with OGG/Vorbis. Thanks to Lethal Weapon for
	  the report.

