
*******************************
*    Kaffeine 0.8.x README    *
*******************************

------------------------------------------------------
!! HAVE A LOOK AT KAFFEINE HANDBOOK !!
------------------------------------------------------

!!!!!!!!!! IMPORTANT !!!!!!!
Live DVB only works with the xine backend (XinePart).
Depending on your distro, this package could be called kaffeine-xine.
Install it, start Kaffeine and change the backend in menu->settings->engine, then restart Kaffeine.
Note that this is only needed for live playback. All other features (recording, broadcasting..) do not depend on the backend.
Anyway, I strongly recommend the xine engine even if you don't have a DVB device. All others are incomplete and/or buggy.
Also note that for licensing reasons, some distro (kubuntu, suse) comes with "restricted" media libraries (xine, gstreamer),
so you won't be able to play some media files (in fact the most common ones:().
You will have to install an "unrestricted" version in order to play all your media files.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


Latest Kaffeine version is available on http://kaffeine.sourceforge.net


MINIMUM REQUIREMENTS:
---------------------

 *) xine-lib 1.0.2 (we recommend 1.1.1) (http://www.xinehq.de)
 *) KDE >= 3.2 (http://www.kde.org)

 *) for DVB support: see README.dvb
 *) for the gstreamer player-part: see README.gstreamer

RECOMMENDED:
------------

 *) WIN32 Codecs (http://www.mplayerhq.hu)
 *) libdvdcss (http://developers.videolan.org/libdvdcss)


INSTALLATION:
-------------

In order to compile and install Kaffeine on your system, type the following in the base
directory of the Kaffeine distribution:

 1.) ./configure --prefix=KDEDIR --mandir=MANPAGE_DIR (e.g. for SuSE: --prefix=/opt/kde3 --mandir=/usr/share/man)
     (use ./configure --help for more options)

 2,) make

 3.) make install


On the download page you'll find RPM's for most distributions.

Problems? Post to the kaffeine-user mailing-list: kaffeine-user@lists.sourceforge.net

INSTALLATION FROM SVN:
----------------------

See http://kaffeine.sourceforge.net/index.php?page=developers


IMPORTANT CONFIGURE FLAGS:
--------------------------

 --with-xorg : use this ONLY(!) in the case Kaffeine hangs at startup
 --without-dvb : disables DVB support (may accelerate startup)
 --without-gstreamer: disables build of the gstreamer based player-part


TROUBLESHOOTING:
----------------

*) Fedora Users: If make aborts with '/usr/bin/ld: cannot find -lselinux' install
   the libselinux-devel package or disable selinux.

*) If Kaffeine hangs on start run 'configure --with-xinit-workaround' and recompile/reinstall.


LICENCE:
--------
This programm is distributed under the terms of the GPL v2. You can find a copy of the
licence in the file COPYING

