summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README94
1 files changed, 42 insertions, 52 deletions
diff --git a/README b/README
index 103c2f9..9a46418 100644
--- a/README
+++ b/README
@@ -1,53 +1,43 @@
-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!
+ KMPlayer - a simple media player for TDE.
+
+
+KMPlayer is a GUI for several backends, namely:
+ - Mplayer
+ - Xine
+ - Gstreamer
+ - ffmpeg
+
+It can play DVD/VCD movies, from file or url and from a video device.
+
+
+
+Features:
+=========
+ * can act as a browser plugin for Konqueror
+ * can embed into a KOffice document.
+ * play DVD (DVDNav only with the Xine player)
+ * play VCD
+ * let the backend players play from a pipe (read from stdin)
+ * play from a TV device (experimental)
+ * show backend player's console output
+ * launch ffserver when viewing from a v4l device
+ * DCOP KMediaPlayer interface support
+ * VDR viewer frontend (with *kxvplayer), configure VDR keys with standard TDE
+ shortcut configure window
+ * Lots of configurable shortcuts. Highly recommended for the VDR keys
+ and volume increase/decrease
+ * Broadcaste http streaming by using ffserver/ffmpeg
+
+
+
+CONTRIBUTING
+==============
+
+If you wish to contribute to kmplayer, you might do so:
+
+- TDE Gitea Workspace (TGW) collaboration tool.
+ https://mirror.git.trinitydesktop.org/gitea
+
+- TDE Weblate Translation Workspace (TWTW) collaboration tool.
+ https://mirror.git.trinitydesktop.org/weblate