kmplayer/README

KMPlayer, a simple frontend for MPlayer/FFMpeg/Xine.
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 tdehtml, 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 KDE3.1 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 $TDEDIR/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 Xine
Download the sources for libxine (xine-lib-1-beta12.tar.gz) from http://xinehq.de. Unpack it (tar xfz xine-lib-1-beta12.tar.gz) and change to this directory (cd xine-lib-1-beta12). Now run configure (./configure) and make ('make'). Install it as root ('su -c "make install"').
Recommended, for encrypted DVDs, install libdvdcss from http://developers.videolan.org/libdvdcss too.
Xine can use the codecs for MPlayer in /usr/lib/win32, however it can't find
the real codecs in there. Eg run
  $ strings /usr/local/lib/xine/plugins/1.0.0/xineplug_decode_real.so |grep drv
after installing to see where it looks for the Real codecs. Either copy or 
symlink for Xine to find them.

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"'.

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 | TDE Components | File Associations) to make sure KMPlayer (or 'Embedded MPlayer for TDE' 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!