diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 237 |
1 files changed, 0 insertions, 237 deletions
@@ -1,237 +0,0 @@ -KPlayer is a KDE multimedia player. - -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, DVB, etc., as well as KDE I/O Slaves; -- volume, contrast, brightness, hue and saturation controls; -- zooming, full screen and fixed aspect options; -- status and progress display and seeking; -- multimedia library to organize your media files and streams; -- configuration dialog and file specific options; -- KPart for integration with Konqueror, KMLDonkey, etc. - -Requirements ------------- - -A recent MPlayer - - KPlayer uses the famous MPlayer, www.mplayerhq.hu, as the backend for - playing audio and video files and streams. This ensures the maximum - variety of supported types of files and encodings. - - You need to have MPlayer version 1.0rc1 or later. - - If there are good binary packages for your distribution, use those. - For example on Debian unstable you would do - - echo 'deb http://www.debian-multimedia.org unstable main' >> /etc/apt/sources.list - apt-get update - apt-get install mplayer kplayer libdvdcss w32codecs - - Substitute unstable for stable or testing as needed. - - As always compiling from source is an option. - - If you got an mplayer.conf in /etc/mplayer or a ~/.mplayer/config, - check them to make sure that they do not have a line like "gui=yes". - Kill it dead if you find it. Use 'gmplayer' if you ever decide to - use MPlayer's own GUI (not recommended). - - It is perfectly fine if you want to remove the MPlayer config files - entirely. However, they may be useful as an alternative way of - specifying options that KPlayer does not yet support directly. - -X11 and XVideo - - X11 is required. X.org is the best choice here. - - XVideo extension is recommended. You can check your /etc/X11/xorg.conf - file for a line that reads - - Load "extmod" - - This is the line that loads XVideo extension, so make sure it is not - disabled. Also check /var/log/Xorg.0.log to make sure that XVideo - is loaded without error. - -Qt and KDE - - KPlayer supports KDE 3.1 and later, so you need to either run a - relatively recent KDE (recommended) or at least have KDE libraries - and the corresponding Qt libraries on your system. - -Installation ------------- - -See INSTALL. - -Support -------- - -If you have any problems, questions, support requests, come to the KPlayer -user forum: http://sourceforge.net/forum/forum.php?forum_id=244388 - -For issues that take longer time to resolve use the issue trackers: -bugs: http://sourceforge.net/tracker/?atid=532182&group_id=71710 -support requests: http://sourceforge.net/tracker/?atid=532183&group_id=71710 -feature requests: http://sourceforge.net/tracker/?atid=532185&group_id=71710 -that way your issue will not be lost or forgotten. - -The forum and the trackers require you to be registered and logged in. -This is so that people do not post questions only to never come back to -check on the response. - -There is also an IRC channel for KPlayer discussions: #kplayer on FreeNode. - -Playing video DVDs and CDs, audio CDs, data CDs and DVDs, TV, and DVB ---------------------------------------------------------------------- - -KPlayer 0.6 and later has much improved support for disk and tuner devices. -It will detect any CD, DVD, TV and DVB devices present on your system and -list them as submenus on the File menu. For disk devices it will also detect -when a disk is inserted or removed and update the submenu accordingly. - -When a disk is in the drive, the submenu will list options to play the -entire disk or each individual track or title. There is also a Load Disk -command that you will only need if the disk is already in the drive when -KPlayer starts up or if your system does not tell KPlayer when a disk is -inserted or removed. - -Submenus for TV and DVB devices list options for playing each channel. -The list of channels can be chosen in the device properties. Go to the -Multimedia Library, expand the Devices subtree, right click a device and -choose Properties. The Channel List option is on the General page. There -are many more options for both disk and tuner devices. - -Multimedia Library ------------------- - -KPlayer 0.6 and later has a multimedia library that you can use to organize -your multimedia files and streams. - -The Now Playing tree lists the files, URLs and folders on your current -playlist. This playlist is temporary and will be wiped out the next time -you play anything else. - -Permanent playlists live on the Playlists tree. Copy your current playlist -from Now Playing here if you want to keep it. Items on playlists can be -arranged in any order you like by dragging them around or using Move Down -and Move Up commands. - -Collection tree can contain folders with items sorted by any available -field. By default only the most useful fields are displayed in both -the playlists and the collection, but other fields can be shown using the -Columns submenu on the Library menu. Some fields can be changed, those are -listed on the Edit submenu of the Library menu. - -Devices tree lists the disk and tuner devices KPlayer found on your system, -and under those you will find the available tracks, titles or channels. -Devices, disks, tracks, titles and channels all have their own properties -that you can access using the Properties option on the Library menu or on -the right click context menu. - -Root Directory and Home Directory list multimedia files found in those -directories and their subdirectories. Find the directories that contain -your multimedia files and put them into your collection. Then create and -organize your playlists from the collection. Both the collection and the -playlists can have as many levels as you need. - -Remote files and streams can be put on the collection and playlists by -using the Add URL command on the Library menu or the right click context -menu. - -Multitrack files and streams ----------------------------- - -Some media files and streams have more than one video, audio or subtitle -tracks in them. Those will be listed on the Video, Audio and Subtitles -submenus of the Player menu. Audio and subtitle tracks will be labelled -with their language if it is known. You can also choose the tracks in the -File Properties. - -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 configuration dialog offers a lot of different -settings 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 configuration 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 -yet supported directly. 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. - -File properties ---------------- - -Starting from KPlayer 0.5 each file and URL has its own set of properties. -They include information that KPlayer found out about the file, like time -length, video size, frame rate, bitrates, and so on, as well as various -options you can set, like name, video aspect, subtitles, and many more. - -Most properties can be set through the File Properties dialog. The -Properties dialog for the currently loaded file or URL can be opened from -the File menu, or using a button on the main toolbar, or from the right -click popup menu. You can also open Properties dialog for any entry in -the multimedia library by right clicking on it, or by using the Properties -command on the Library menu. - -An easier way to set file properties is by holding the Shift key when -changing a setting. For example, if you hold Shift and select Soft Frame -Drop from the Player menu, KPlayer will remember that setting for the -current URL, and use it the next time you play it. After it is done playing -the current URL, it will revert the Frame Drop setting to the default, the -one that was in effect before you changed it with Shift. On the other hand, -if you change Frame Drop without holding Shift, the new setting will become -the default, and will be used for all URLs that do not have it set -explicitly. - -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. -Double clicking the video area also switches between full screen and normal -mode. You can also hit the Esc key, which will stop playback and end the -full screen mode. - -History -------- - -See ChangeLog. - -Known issues ------------- - -See BUGS. - -Online manuals and HOWTOs -------------------------- - -KPlayer user manual is available online at -http://docs.kde.org/development/en/extragear-multimedia/kplayer/ -or http://kplayer.sourceforge.net/manual/ - -In particular the manual has a few micro HOWTOs that will give you many -useful tips on how to get the most out of KPlayer and your multimedia. |