Added old abandoned KDE3 version of kmplayer

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kmplayer@1091557 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 53 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..3d2acd3
--- /dev/null
+++ b/README
@@ -0,0 +1,53 @@
+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 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 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 $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 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 | 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!
+