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

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; user friendly interface.

Among planned enhancements are configuration dialog, global and per-file
options, playlist, further KDE integration, MPlayer config file handling,
support for media encoding.

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

KDE 3

XVideo extension

A fairly recent MPlayer
  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.

For example, the mplayer.conf that comes with the Debian package from
marillat.free.fr may have those lines and so will prevent KPlayer from
working properly. It may also have a line like 'cache=1024', which
effectively prevents you from listening to online radio stations for
example.

It is perfectly fine if you want to remove the config files entirely.
However, they may be useful if you want to specify options that KPlayer
does not support yet.

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

See INSTALL.

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

As advertised in 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 cdda://14 can be used to play a track from audio CD.

History
-------

See ChangeLog.

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

See BUGS.

Reporting bugs
--------------

Before you report a bug, first please make sure the bug has not been reported
yet. Look in the BUGS file that comes with the distribution, then in the bug
tracking system at http://sourceforge.net/tracker/?atid=532182&group_id=71710
Also look in Support Requests, Feature Requests, Public Forums and Mailing
Lists sections.

Please report bugs through the KPlayer bug tracking system at
http://sourceforge.net/projects/kplayer/

Using SourceForge is much preferable over private e-mail, for it helps
prevent duplicate requests.
