README

KMPlayer, a simple frontend for MPlayer/FFMpeg/Phonon.
It can play DVD/VCD movies, from file or url and from a video device.
If setup right, KMPlayer can embed inside konqueror. Which means if you click
on a movie file, the movie is played inside konqueror.
It can also embed inside khtml, enabling movie playback inside a html page.
Movie recording using mencoder (part of the mplayer package). No video during recording, but you can always open a new window and play it there.
Broadcasting, http streaming, by using ffserver/ffmpeg. For TV sources, you need v4lctl (part of the xawtv package).
KMPlayer needs KDE4 and a working mplayer/mencoder somewhere in you PATH.
Additonally, for broadcasting, ffserver/ffmpeg/v4lctl also.
For DVD navigation Xine is used. MPlayer has broken dvdnav support. DVDNav is included in libxine and works fine.
Unless you reconfigure kmplayer, both mplayer and ffmpeg should be compiled with liblame for mp3.
Quickly installing MPlayer
Download the sources from http://www.mplayerhq.hu/homepage/.
If you want quicktime support, also download the quicktime dll's
(http://www.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2) and unpack
them and copy the files to /usr/lib/win32 (make this dir if it doesn't exist).
Or download the 'All in one' package and have even more codecs.
Untar the mplayer source package (tar xfj MPlayer-0.90.tar.bz2), change to
that directory. Make sure $KDEDIR/bin is in you path (check if you can run
'artsplay').
Now run configure (./configure) and make ('make'). Install it as root ('su -c "make install"').
Finally you must setup the config files in ~/.mplayer ('mkdir ~/.mplayer').
Copy the files, from the mplayer sources, etc/codecs.conf and etc/example.conf as codecs.conf and config resp
('cp etc/codecs.conf ~/.mplayer; cp etc/example.conf ~/.mplayer/config').
Next change ~/.mplayer/config with an editor and change the video driver (vo=xv) and audio driver (ao=arts) and remove the last line.
Quickly installing ffmpeg/ffserver
Download 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.
Untar the source package, run './configure --enable-mp3lame' and 'make'. Install as root 'su -c "make install"'.
Quickly installing kmplayer
Untar the source package
tar xfj kmplayer-<version>.tar.bz2
Create a build directory, eg /tmp/kmplayer-build and enter this directory
Set your environment for building KDE4 apps
export QTDIR=path-to-qt4
export KDEDIR=path-to-kde4
export KDEDIRS=$KDEDIR
export KDE_BUILD=$KDEDIR
export DBUSDIR=$KDEDIR
export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH
export PKG_CONFIG_PATH=$DBUSDIR/lib/pkgconfig:/usr/lib/pkgconfig
export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH
Run cmake
cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR -DCMAKE_BUILD_TYPE=release path-to-kmplayer-source
Run make
make
Install as root
make install
KMPlayer doesn't work with all the video drivers that mplayer supports.
I tested only xv (X Video Extension) and x11 (Image/Shm). If none work, you
might try the patch for the x11 driver and see if that works for you (not needed anymore for mplayer version >= 0.90-rc4).
You 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.
Also make sure in the 'Embedding' tab 'Show file in embedded viewer' is set.
If you run an older versio of MPlayer (0.9x), set 'Post MPlayer 0.90=false' in
.kde/share/config/kmplayer.rc under group [MPlayer]. It will change some of the
mencoder arguments (for recording).
Enjoy!