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

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

 * Gtk+ 2.10.0 or newer
 * libglade 2.4.0 or newer
 * GStreamer core >= 0.10.14
 * gst-plugins-base >= 0.10.14
   becaus of oggmux and audiorate/videorate fixes that are only in CVS)
 * gst-plugins-good >= 0.10.6
 * gst-plugins-ugly >= 0.10.6

 * 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.71
 * hal and libhal >= 0.5.7


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

 * Thoggen is SLOW
   Make sure you are using libtheora-1.0beta2 or newer, which contains
   a whole bunch of optimisations and speeds up encoding a lot, at least
   on x86/x86-64 CPUs.

 * 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)

 * No support for subtitles yet (hopefully in one of the next versions)


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

Please report bugs, feature requests, or submit patches in the Thoggen bug
tracker:

   http://sourceforge.net/tracker/?group_id=124800


