README
1KMPlayer, a simple frontend for MPlayer/FFMpeg/Phonon.
2It can play DVD/VCD movies, from file or url and from a video device.
3If setup right, KMPlayer can embed inside konqueror. Which means if you click
4on a movie file, the movie is played inside konqueror.
5It can also embed inside khtml, enabling movie playback inside a html page.
6Movie recording using mencoder (part of the mplayer package). No video during recording, but you can always open a new window and play it there.
7Broadcasting, http streaming, by using ffserver/ffmpeg. For TV sources, you need v4lctl (part of the xawtv package).
8
9KMPlayer needs KDE4 and a working mplayer/mencoder somewhere in you PATH.
10Additonally, for broadcasting, ffserver/ffmpeg/v4lctl also.
11For DVD navigation Xine is used. MPlayer has broken dvdnav support. DVDNav is included in libxine and works fine.
12Unless you reconfigure kmplayer, both mplayer and ffmpeg should be compiled with liblame for mp3.
13
14Quickly installing MPlayer
15Download the sources from http://www.mplayerhq.hu/homepage/.
16If you want quicktime support, also download the quicktime dll's
17(http://www.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2) and unpack
18them and copy the files to /usr/lib/win32 (make this dir if it doesn't exist).
19Or download the 'All in one' package and have even more codecs.
20Untar the mplayer source package (tar xfj MPlayer-0.90.tar.bz2), change to
21that directory. Make sure $KDEDIR/bin is in you path (check if you can run
22'artsplay').
23Now run configure (./configure) and make ('make'). Install it as root ('su -c "make install"').
24Finally you must setup the config files in ~/.mplayer ('mkdir ~/.mplayer').
25Copy the files, from the mplayer sources, etc/codecs.conf and etc/example.conf as codecs.conf and config resp
26('cp etc/codecs.conf ~/.mplayer; cp etc/example.conf ~/.mplayer/config').
27Next change ~/.mplayer/config with an editor and change the video driver (vo=xv) and audio driver (ao=arts) and remove the last line.
28
29Quickly installing ffmpeg/ffserver
30Download the sources from http://ffmpeg.sourceforge.net/. If the current version is 0.4.6, I recommend using a more recent CVS snapshot because it uses less CPU when grabbing a TV device.
31Untar the source package, run './configure --enable-mp3lame' and 'make'. Install as root 'su -c "make install"'.
32
33Quickly installing kmplayer
34Untar the source package
35 tar xfj kmplayer-<version>.tar.bz2
36Create a build directory, eg /tmp/kmplayer-build and enter this directory
37Set your environment for building KDE4 apps
38 export QTDIR=path-to-qt4
39 export KDEDIR=path-to-kde4
40 export KDEDIRS=$KDEDIR
41 export KDE_BUILD=$KDEDIR
42 export DBUSDIR=$KDEDIR
43 export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH
44 export PKG_CONFIG_PATH=$DBUSDIR/lib/pkgconfig:/usr/lib/pkgconfig
45 export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH
46Run cmake
47 cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR -DCMAKE_BUILD_TYPE=release path-to-kmplayer-source
48Run make
49 make
50Install as root
51 make install
52
53KMPlayer doesn't work with all the video drivers that mplayer supports.
54I tested only xv (X Video Extension) and x11 (Image/Shm). If none work, you
55might try the patch for the x11 driver and see if that works for you (not needed anymore for mplayer version >= 0.90-rc4).
56You might need to change mimetype settings (Control Center | KDE Components | File Associations) to make sure KMPlayer (or 'Embedded MPlayer for KDE' in embedded tab) is set for all the formats you want to play with KMPlayer.
57Also make sure in the 'Embedding' tab 'Show file in embedded viewer' is set.
58
59If you run an older versio of MPlayer (0.9x), set 'Post MPlayer 0.90=false' in
60.kde/share/config/kmplayer.rc under group [MPlayer]. It will change some of the
61mencoder arguments (for recording).
62
63Enjoy!
64
65