                           =====================
                             thoggen :: readme
                           =====================

Requirements:
=============

 * Gtk+ 2.8.0 or newer
 * libglade 2.4.0 or newer
 * GStreamer core >= 0.10.10
 * gst-plugins-base >= 0.10.10 (STRONGLY RECOMMENDED: 0.10.10.1 CVS or newer
   becaus of oggmux and audiorate/videorate fixes that are only in CVS)
 * gst-plugins-good >= 0.10.4
 * gst-plugins-ugly >= 0.10.4 (STRONGLY RECOMMENDED: 0.10.4.1 CVS or newer
   because of a52dec downmixing fixes that are only available in CVS)

 * GStreamer plugins required (debian/ubuntu package names in brackets):
    - a52dec            (gstreamer0.10-plugins-ugly)
    - mpeg2dec          (gstreamer0.10-plugins-ugly)
    - dvdreadsrc        (gstreamer0.10-plugins-ugly)
    - dvddemux          (gstreamer0.10-plugins-ugly)
    - dvdlpcmdec        (gstreamer0.10-plugins-ugly)
    - dtsdec            (gstreamer0.10-plugins-bad)
    - videorate         (gstreamer0.10-plugins-base)
    - theoraenc         (gstreamer0.10-plugins-base)
    - rawvorbisenc      (gstreamer0.10-plugins-base)
    - oggmux            (gstreamer0.10-plugins-base)
    - audioconvert      (gstreamer0.10-plugins-base)
    - audioscale        (gstreamer0.10-plugins-base)
    - ffmpegcolorspace  (gstreamer0.10-plugins-base)
 * libdvdread3 >= 0.9.4
 * libdvdcss2 >= 1.2.8 required for encrypted DVDs
 * dbus, dbus-glib >= 0.36
 * hal and libhal >= 0.5.0


Known Issues:
=============

 * Thoggen is SLOW
   Make sure you are using libtheora alpha7 or newer, which contains
   MMX code for x86/amd64/i64 and speeds up encoding on those platforms
   a lot compared to previous versions.

 * DTS audio streams
   Thoggen will ignore audio streams in DTS format unless the
   GStreamer dtsdec plugin is installed (which depends on
   libdts, which is in debian but isn't shipped in all distros).
   If a title has only audio streams in DTS format, the title
   won't show up in the title list at all. Usually DVDs ship
   audio streams in other audio formats as well, so this 
   shouldn't be a problem.
 
 * Issues on PPC
   See http://bugzilla.gnome.org/show_bug.cgi?id=154431 (there
   are compiler issues with the mpeg decoding library on pcc)

 * Hangs at the end of the file instead of finishing and showing
   the 'Close' button (possibly an issue with oggmux, should be
   fixed in gst-plugins-base CVS >= 0.10.10.1). Might also be
   related to audiorate/videorate (also fixed in -base CVS).

 * Sound/audio level in output is very low or voices cannot
   be heard properly: issue with a52dec downsampling, might vary
   from DVD to DVD or title to title. Fixed in gst-plugins-ugly CVS.

Bugs / Feature Requests:
========================

Please report bugs and feature requests to the thoggen-devel
 mailing list for the time being (until I've set up a bugzilla 
 server). See http://thoggen.net/mailing-lists/

