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

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

 * Gtk+ 2.6.0 or newer
 * GStreamer 0.8.10 or newer
 * gst-plugins 0.8.10  or newer
 * GStreamer plugins required (debian package names in brackets):
    - a52dec            (gstreamer0.8-a52dec)
    - mpeg2dec          (gstreamer0.8-mpeg2dec)
    - dvdreadsrc        (gstreamer0.8-dvd)
    - dvddemux          (gstreamer0.8-misc)
    - dvdlpcmdec        (gstreamer0.8-misc)
    - dtsdec            (gstreamer0.8-dts)
    - videorate         (gstreamer0.8-misc)
    - theoraenc         (gstreamer0.8-theora)
    - rawvorbisenc      (gstreamer0.8-vorbis)
    - oggmux            (gstreamer0.8-misc)
    - audioconvert      (gstreamer0.8-misc)
    - audioscale        (gstreamer0.8-misc)
    - ffmpegcolorspace  (gstreamer0.8-misc)
 * libdvdread3 >= 0.9.4
 * libdvdcss2 >= 1.2.8 required for encrypted DVDs
 * dbus, dbus-glib
 * hal and libhal


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

 * Thoggen is SLOW
   The theora encoder is still in alpha stage. Correct working 
   and implementation of the specification are more important 
   than speed at this stage. As the encoder matures, however,
   performance issues will receive more attention. Experienced 
   users may check out the theora-mmx branch of the
   theora library, which gives a speed up of a factor of 3-4.

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


