Warning, /multimedia/kmplayer/README is written in an unsupported language. File is not indexed.

0001 KMPlayer, a simple frontend for MPlayer/FFMpeg/Phonon.
0002 It can play DVD/VCD movies, from file or url and from a video device. 
0003 If setup right, KMPlayer can embed inside konqueror. Which means if you click
0004 on a movie file, the movie is played inside konqueror.
0005 It can also embed inside khtml, enabling movie playback inside a html page.
0006 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.
0007 Broadcasting, http streaming, by using ffserver/ffmpeg. For TV sources, you need v4lctl (part of the xawtv package).
0008 
0009 KMPlayer needs KDE4 and a working mplayer/mencoder somewhere in you PATH.
0010 Additonally, for broadcasting, ffserver/ffmpeg/v4lctl also.
0011 For DVD navigation Xine is used. MPlayer has broken dvdnav support. DVDNav is included in libxine and works fine.
0012 Unless you reconfigure kmplayer, both mplayer and ffmpeg should be compiled with liblame for mp3.
0013 
0014 Quickly installing MPlayer
0015 Download the sources from http://www.mplayerhq.hu/homepage/.
0016 If you want quicktime support, also download the quicktime dll's
0017 (http://www.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2) and unpack
0018 them and copy the files to /usr/lib/win32 (make this dir if it doesn't exist).
0019 Or download the 'All in one' package and have even more codecs.
0020 Untar the mplayer source package (tar xfj MPlayer-0.90.tar.bz2), change to
0021 that directory. Make sure $KDEDIR/bin is in you path (check if you can run
0022 'artsplay').
0023 Now run configure (./configure) and make ('make'). Install it as root ('su -c "make install"').
0024 Finally you must setup the config files in ~/.mplayer ('mkdir ~/.mplayer').
0025 Copy the files, from the mplayer sources, etc/codecs.conf and etc/example.conf as codecs.conf and config resp 
0026 ('cp etc/codecs.conf ~/.mplayer; cp etc/example.conf ~/.mplayer/config').
0027 Next change ~/.mplayer/config with an editor and change the video driver (vo=xv) and audio driver (ao=arts) and remove the last line.
0028 
0029 Quickly installing ffmpeg/ffserver
0030 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.
0031 Untar the source package, run './configure --enable-mp3lame' and 'make'. Install as root 'su -c "make install"'.
0032 
0033 Quickly installing kmplayer
0034 Untar the source package
0035   tar xfj kmplayer-<version>.tar.bz2
0036 Create a build directory, eg /tmp/kmplayer-build and enter this directory
0037 Set your environment for building KDE4 apps
0038   export QTDIR=path-to-qt4
0039   export KDEDIR=path-to-kde4
0040   export KDEDIRS=$KDEDIR
0041   export KDE_BUILD=$KDEDIR
0042   export DBUSDIR=$KDEDIR
0043   export LD_LIBRARY_PATH=$QTDIR/lib:$KDEDIR/lib:$LD_LIBRARY_PATH
0044   export PKG_CONFIG_PATH=$DBUSDIR/lib/pkgconfig:/usr/lib/pkgconfig
0045   export PATH=$QTDIR/bin:$KDEDIR/bin:$PATH
0046 Run cmake
0047   cmake -DCMAKE_INSTALL_PREFIX=$KDEDIR -DCMAKE_BUILD_TYPE=release path-to-kmplayer-source
0048 Run make
0049   make
0050 Install as root
0051   make install
0052 
0053 KMPlayer doesn't work with all the video drivers that mplayer supports. 
0054 I tested only xv (X Video Extension) and x11 (Image/Shm). If none work, you 
0055 might try the patch for the x11 driver and see if that works for you (not needed anymore for mplayer version >= 0.90-rc4).
0056 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.
0057 Also make sure in the 'Embedding' tab 'Show file in embedded viewer' is set.
0058 
0059 If you run an older versio of MPlayer (0.9x), set 'Post MPlayer 0.90=false' in
0060 .kde/share/config/kmplayer.rc under group [MPlayer]. It will change some of the
0061 mencoder arguments (for recording).
0062 
0063 Enjoy!
0064