summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README86
1 files changed, 86 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..9a6ec79
--- /dev/null
+++ b/README
@@ -0,0 +1,86 @@
+
+*******************************
+* 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
+