KPlayer is a KDE media player based on MPlayer, www.mplayerhq.hu.

With KPlayer you can easily play a wide variety of video and audio files and
streams using a rich and friendly interface compliant with KDE standards.

Features include video, audio and subtitle playback from file, URL, DVD, VCD,
audio CD, TV, etc.; volume, contrast, brightness, hue and saturation controls;
zooming, full screen and fixed aspect options; status and progress display
and seeking; playlist; message log; drag and drop support; configuration
dialog; and a KPart for integration with Konqueror, KMLDonkey, etc.

Requirements
------------

KDE 3.1 or later

XVideo extension is recommended, however other video outputs are supported

A fairly recent MPlayer
  KPlayer 0.4 was tested and found to work well with MPlayer 0.90 and 1.0pre2.
    MPlayer 0.91, 0.92 and 1.0pre1 are more buggy and are not recommended.
  KPlayer 0.3 was tested primarily with MPlayer 0.90, and also both
    the main and the 0_90 branches as of July 27.
  KPlayer 0.2 was tested with MPlayer 0.9rc up to 5.
  MPlayer 0.6 and earlier does not work well with KPlayer.

MPlayer config file(s) may need to be modified (or simply removed).

MPlayer reads its configuration from /etc/mplayer/mplayer.conf (or maybe
/etc/mplayer.conf or some such) and from ~/.mplayer/config. Right now there
seems to be no way to override this. So if you have those files, check to
see if they have lines like 'gui=yes' or 'vo=x11' and delete them or comment
them out. When you run MPlayer from the command line, you can specify those
options on the command line if you need them.

It is perfectly fine if you want to remove the config files entirely.
However, they may be useful as an alternative way of specifying options
that KPlayer does not directly support yet.

Installation
------------

See INSTALL.

Configuration
-------------

KPlayer's initial settings have been tuned to the optimal values so that
the program should be fully usable out of the box. In fact, version 0.2
did not have a configuration dialog and was quite useful nevertheless.

For advanced users the config dialog offers 87 (as of 0.4) different
options affecting both the KPlayer user interface and MPlayer options.
If you mess KPlayer up by playing with them, the Defaults button is there
to help you out.

However, if KPlayer does not work for you in the first place, please first
test MPlayer itself from the command line to see if it needs any command
line options to work on your system. Then you can set those options in the
KPlayer config dialog.

Before you put anything into the Additional Command Line Arguments box,
please first look around the dialog to make sure the option you need is not
supported directly yet. For example, the only time you'll ever need to put
-ao, -ac, -vo or -vc in there is when you want to list more than one output
or codec separated by a comma. In that case please first set the respective
option on the Audio or Video page to 'auto'.

Warning about -vo sdl and -vo svga: if you set these anywhere other than the
Video page in the KPlayer config dialog, you will likely have to either wait
for your file to finish playing or kill your X session. If you really have
to, you can edit or remove the input.conf file in share/apps/kplayer, but
that is not recommended, nor are -vo sdl and -vo svga for that matter.

Playing DVDs, VCDs, audio CDs, TV
---------------------------------

As advertised on MPlayer manpage, DVDs can be played by passing a URL like
dvd://1 to MPlayer. "1" in this case is the track number you want to watch.
So put that in the Open URL dialog inside KPlayer.

Similarly, a URL like vcd://1 can be used to play a track from video CD.
Use the cdda: prefix to play a track from audio CD, and tv: to play from TV.

Full screen mode
----------------

To return from the full screen mode to the normal mode just hit Ctrl+F or
right click anywhere in the video area and choose Full Screen from the menu.
You can also hit the Esc key, which will stop playback and end the full
screen mode.

History
-------

See ChangeLog.

Known issues
------------

See BUGS.
