
***************************************
*  KAFFEINE README for version 0.4.3  *
***************************************


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


MINIMUM REQUIREMENTS:

 - xine-lib 1.0rc3c  (http://www.xinehq.de)
 - kde 3.1.0  (http://www.kde.org)


INSTALLATION:

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

(If you checked out from CVS first run ./autogen.sh to build configure!)

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

 2,) make

 3.) make install


On the download page you'll find some RPM's.

Problems? Use the kaffeine-user mailing-list: https://lists.sourceforge.net/lists/listinfo/kaffeine-user


XFREE 4.4/X.ORG 6.7:
- Hint for packagers: A package compiled against xfree 4.4 might not start with xfree 4.3; vice versa,
  a package compiled against 4.3 will crash on closing with xfree 4.4
- konqueror/kpart: is still unstable with xfree 4.4 - the only known solution is to patch konqueror
 (add XInitThreads() as first call of main() in konqu_main.cc)

 
MOZILLA PLUGIN:

You'll find it here: $KDEDIR/lib/kaffeineplugin/kaffeineplugin.so. Kaffeine will it link automatically with
$HOME/.mozilla/plugins on first run.


SuSE USERS:

- Don't forget to run configure with --prefix=/opt/kde3 - or set the environment variable $KDEDIR
- If you get some compiler errors like XINE_EVENT_UI_NUM_BUTTONS not found - please install the xine-lib from
http://www.xinehq.de or the RPMs from http://packman.links2linux.org


WINDOWMAKER USERS:

Define WINDOWMAKER in kaffeine.h to make sure the fullscreen window is above the panel. Works for KDE too,
but produces a ugly flickery.


TRANSLATIONS:
Some translations are incomplete or currently unmaintained. Feel free to complete the *.po file for your language
and send it to kaffeine-devel@lists.sourceforge.net.
Maybe we'll bring out a updated kaffeine-i18n pack from time to time.


LICENCE:

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