README

OGMRip
======

    OGMRip is an application and a set of libraries for ripping and encoding
    DVD into AVI/OGM files.

    OGMRip:

        * transcodes from DVD or files
        * outputs ogm, avi, matroska, webm or mp4 files
        * supports a lot of codecs (vorbis, mp3, pcm, ac3, dts, aac, xvid, lavc, x264, theora, vp8)
        * determines video bitrate for a given filesize
        * autodetects cropping parameters and scaling factors
        * supports multiple audio and subtitles streams encoding
        * extracts subtitles in srt or vobsub format
        * uses maximum quality codec switches
        * rips contiguous chapters
        * supports external audio and subtitles files
        * provides customisable encoding profiles
        * is extensible through plugins

        * features a HIG-compliant GNOME 2 user interface

Requirements
------------

    glib         >= 2.40.0: http://www.gtk.org
    dvdread      >= 0.9.4:  http://www.dtek.chalmers.se/groups/dvd
    mplayer      >= 0.92:   http://www.mplayerhq.hu
    mencoder     >= 0.92:   http://www.mplayerhq.hu
    intltool     >= 0.35:   http://www.gnome.org
    pkgconfig    >= 0.12:   http://www.freedesktop.org/software/pkgconfig
    libxml2      >= 2.0:    http://www.xmlsoft.org
    libmediainfo >= 0.7:    http://mediainfo.sourceforge.net
    enca         >= 1.9:    http://trific.ath.cx/software/enca

Optional
--------

    For the GUI:

        GTK+ >= 3.12.0: http://www.gtk.org

    For Ogg Media support:

        ogmtools >= 1.0: http://www.bunkus.org/videotools/ogmtools

    For Matroska support:

        mkvtoolnix >= 0.9.5: http://www.bunkus.org/videotools/mkvtoolnix

    For WebM support:

        mkvtoolnix built with WebM support

    For MP4 support:

        gpac >= 0.4.2: http://gpac.sourceforge.net

    For x264 suport:

        mencoder built with x264 support

    For VP8 support:

        vpxenc: http://www.webmproject.org

    For Theora support:

        libtheora >= 1.0alpha5: http://www.theora.org

    For Dirac support:

        mencoder built with Dirac support

    For DTS support:

        mplayer built with dts support

    For MP3 support:

        lame >= 3.96: http://lame.sourceforge.net

    For AAC support:

        faac: http://www.audiocoding.com

    For Ogg Vorbis support:

        vorbistools >= 1.0: http://www.xiph.org/ogg/vorbis

    For FLAC support:

        flac >= 1.0: http://flac.sourceforge.net

    For SRT support:

        gocr  >= 0.39:    http://jocr.sourceforge.net/
      or
        ocrad >= 0.15:    http://www.gnu.org/software/ocrad/ocrad.html
      or
        tesseract >= 2.0: http://code.google.com/p/tesseract-ocr
        libtiff:          http://www.remotesensing.org/libtiff

    For subtitles spell checking:

        enchant >= 1.1: http://www.abisource.com/enchant/

Install
-------

    See the INSTALL file.

Usage
-----

    $ ogmrip

License
-------

    OGMRip is distributed under the terms of the GNU Lesser General Public License.
    See the COPYING file for more information.

Thanks
------
    Arpi and the mplayer team for such a great piece of software.
    Moritz Bunkus for ogmtools and mktoolnix.
    Mike Cheng and Mark Taylor for the best mp3 encoder ever.
    Chris Phillips for lsdvd from which I have learned libdvdread's API.
    The Xiph Foundation for vorbis and theora.