The shortcut key combinations shown in this chapter are the default ones. They can of course be changed. Note that many menu entries are only enabled when they are applicable to the file currently loaded in &kplayer;. For example, the items on the View menu will be disabled when playing audio only files. &Ctrl;O Play... Displays the standard Play files dialog and lets you choose a file or several files to put on the playlist and start playing. &Ctrl;U Play URL... Displays the standard Play URL dialog and lets you type or paste in a URL to put on the playlist and start playing. The URL can be a remote network location, a local file path, or a &kde; I/O Slave URL. Play List Displays a submenu listing all playlists and lets you choose one of them to play. Play Recent Displays a submenu listing the most recently played files and URLs and lets you choose one to put on the playlist and start playing. Device Displays a submenu with commands for the particular device. Each device has its own submenu. The submenu label reflects the kind of device it is, for example TV Device or DVD Device. When you put a disk in a disk drive, after a few seconds the label will change to reflect the kind of disk you inserted, for example Audio CD in DVD Device. The list of commands on the submenu will also be updated accordingly to include commands applicable to the disk and the tracks it has. See below for details about the commands. &Ctrl;S Load Subtitles... Displays the standard Load subtitles dialog and lets you choose a subtitle file or files to use with the current file or URL. After you click Open, &kplayer; will start showing subtitles from the first of the files immediately if the video is already playing, and list the subtitle files on the Subtitles submenu of the Player menu. By default it will also remember the subtitles you choose in the current file properties. This command is available for video files. You can also drag subtitle files from &konqueror; File Manager and drop them anywhere in &kplayer; except the multimedia library to load and display them. &Alt;&Enter; Properties... Opens the File Properties dialog that lets you choose many options specific to the currently loaded file. See the File properties micro-HOWTO for details. &Ctrl;Q Quit Saves the playlist and all settings, stops playing and closes &kplayer;. Play Disk Plays the entire disk. This command is available if the device is a disk drive. Play Title Plays one title of a video DVD. This command is available when &kplayer; detects a video DVD in a DVD drive and finds out the number of titles on it. Each title on the DVD has its own command on this submenu. Play Track Plays one track of an audio or video CD. This command is available when &kplayer; detects an audio or video CD in a disk drive and finds out the number of tracks on it. Each track on the CD has its own command on this submenu. Load Disk Detects the kind of disk that is in the disk drive, finds the number of titles or tracks on the disk and updates the submenu accordingly. Usually &kplayer; detects this information automatically, but sometimes this command can be useful to initiate the detection process manually. This command is available if the device is a disk drive. Play Channel Plays a channel from a tuner device. This command is available if the device is a tuner device. Each channel on the device has its own command on this submenu. Commands on this menu are only available for video files. &Ctrl;F Full Screen Switches to full screen video display and back to normal mode. Double clicking the video area also switches between full screen and normal window size. &Ctrl;+ Zoom In Enlarges the video area by one half of the original video size of the current file. &Ctrl;- Zoom Out Reduces the video area by one half of the original video size of the current file. Zoom to 50% Resizes the video area to one half of the original video size of the current file. &Ctrl;&Backspace; Zoom to 100% Resizes the video area to the original video size of the current file. Zoom to 150% Resizes the video area to 150% of the original video size of the current file. Zoom to 200% Resizes the video area to twice the original video size of the current file. Zoom to 250% Resizes the video area to 250% of the original video size of the current file. Zoom to 300% Resizes the video area to thrice the original video size of the current file. Maintain Original Aspect Toggles the option to maintain the original video aspect ratio of the current file. Maintain Current Aspect Toggles the option to maintain the current video aspect ratio. Force 4 to 3 Aspect Toggles the option to maintain four to three video aspect ratio. Force 16 to 9 Aspect Toggles the option to maintain sixteen to nine video aspect ratio. &Enter; Play Starts playback of the current file. If the player has been paused, this command resumes playback. This command is available when a file is loaded. Space Pause Pauses or resumes playback of the current file. This command is available when the player is not idle. &Esc; Stop Stops playback of the current file. This command is available when the player is not idle. &Alt;Down Arrow Next Starts playing the next item on the current playlist. &Alt;Up Arrow Previous Starts playing the previous item on the current playlist. Loop Toggles the option to start playing items from the beginning of the playlist after playing the last item on the playlist. Shuffle Toggles the option to play playlist items in a random order. This submenu and the commands it contains are available when playing a file. Right Arrow Forward Moves playback forward by one percent of the time length of the current file. &Ctrl;Right Arrow Fast Forward Moves playback forward by ten percent of the time length of the current file. Left Arrow Backward Moves playback backward by one percent of the time length of the current file. &Ctrl;Left Arrow Fast Backward Moves playback backward by ten percent of the time length of the current file. &Ctrl;Home Back to Start Moves playback to the beginning of the current file. Track Switches to the selected audio track. If the currently loaded file or stream has more than one audio track, each track will have a command that allows you to switch to that audio track. The command will be labelled with the audio track language if it is known. If there is only one audio track, this command will not be available. Down Arrow Decrease Volume Decreases the sound volume. Up Arrow Increase Volume Increases the sound volume. &Ctrl;\ Mute Turns the sound on or off. &Ctrl;] Decrease Delay Decreases the delay of sound relative to video. &Ctrl;[ Increase Delay Increases the delay of sound relative to video. This submenu is only available for video files. Track Switches to the selected video track. If the currently loaded file or stream has more than one video track, each track will have a command that allows you to switch to that video track. If there is only one video track, this command will not be available. &Ctrl;1 Decrease Contrast Decreases the video contrast. &Ctrl;2 Increase Contrast Increases the video contrast. &Ctrl;3 Decrease Brightness Decreases the video brightness. &Ctrl;4 Increase Brightness Increases the video brightness. &Ctrl;5 Decrease Hue Decreases the video hue. &Ctrl;6 Increase Hue Increases the video hue. &Ctrl;7 Decrease Saturation Decreases the video saturation. &Ctrl;8 Increase Saturation Increases the video saturation. This menu is only available when a video file has embedded subtitles or when external subtitles are loaded. None Stops showing subtitles while playing video. Track Switches to the selected subtitles. If the currently loaded file or stream has embedded subtitle tracks, each track will have a command that allows you to switch to that subtitle track. The command will be labelled with the subtitle track language if it is known. If you load external subtitles, they will also have a command, labelled with the subtitle file name, that allows you to switch to the external subtitles. &Ctrl;, Move Down Moves the subtitles down in the video area. &Ctrl;. Move Up Moves the subtitles up in the video area. &Ctrl;' Decrease Delay Decreases the delay of subtitles relative to video. &Ctrl;; Increase Delay Increases the delay of subtitles relative to video. If your system is too slow to play a file, &mplayer; can drop some frames so playback does not slow down. This submenu lets you choose a frame dropping option. The soft frame dropping option drops frames less agressively than the hard one and should not cause playback problems. You should try it when you get video lagging behind audio, for example because you cannot use an accelerated video output. The hard option drops frames more agressively than the soft one and may sometimes break decoding. Soft Frame Dropping Toggles the soft frame dropping option. Hard Frame Dropping Toggles the hard frame dropping option. To turn frame dropping off, unselect the currently selected frame dropping option. The Frame drop option can also be set on the Advanced page either globally in &kplayer; Settings or for a particular file in the File Properties. The commands on this menu work on the multimedia library. Most of the commands are available when the library is shown using the Show Library command on the Settings menu or one of the commands on the Go submenu. Other commands become available when you select some items in the library. For a detailed description of the multimedia library feature see the Multimedia library micro-HOWTO. &Ctrl;Enter Play Puts the selected items on the current playlist and starts playing them. Play Next Puts the selected items on the current playlist and plays them after the currently playing item. Queue Adds the selected items to the current playlist. Queue Next Adds the selected items to the current playlist and plays them after the currently playing item. Add to Shows a submenu with commands that add the current selection to different locations in the multimedia library. See below for details on each available command. Add Shows a submenu with commands that allow you to add items to the current folder. See below for details on each available command. Select All Selects all items in the current folder. Move Up Moves the currently selected items up in the multimedia library. This command is available for items in the Now Playing, Recent and Playlists sections of the library. You can also move items around in those sections by clicking and dragging them with the &LMB;. Move Down Moves the currently selected items down in the multimedia library. This command is available for items in the Now Playing, Recent and Playlists sections of the library. You can also move items around in those sections by clicking and dragging them with the &LMB;. Delete Remove Removes the currently selected items from the multimedia library. Note that &kplayer; never deletes any multimedia files from your system, so this command is not available for files and directories. F2 Rename Starts edit mode for the current item in the multimedia library so that you can change the item name. Edit Shows a submenu with commands that start edit mode for the chosen field of the current item in the multimedia library. Each editable field has its own command on this submenu. If the field column is not shown, this command will show it. After you are done editing the field, press &Enter; to apply the changes, or or &Shift; to apply the changes and edit the next or the previous field, or Down Arrow or Up Arrow to apply the changes and edit the same field of the next or previous item. Properties... Opens the File Properties dialog for the current item in the multimedia library. This command currently does not apply to folders, but it is available for devices and optical disks as well as other items. See the File properties micro-HOWTO for details. Columns Shows a submenu with commands that show or hide the chosen column in the list view of the multimedia library. Each available column has its own command on this submenu. Go Shows a submenu with commands that let you navigate the multimedia library. See below for details on each available command. Playlist Adds the selected items to the playlist you choose from the list. Each playlist in the Playlists section of the library has its own command on this submenu. New Playlist... Shows a dialog allowing you to enter a name for a new playlist to add to the Playlists section of the multimedia library and adds the selected items to the new playlist. Playlists Adds the selected items to the Playlists section of the multimedia library. Collection Adds the selected items to the Collection section of the multimedia library. Files... Displays the standard Add files dialog and lets you choose a file or several files to add to the current folder. URL... Displays the standard Add URL dialog and lets you type or paste in a URL to add to the current folder. Folder... Shows a dialog allowing you to enter a name for a new subfolder to add to the current folder. Playlist... Shows a dialog allowing you to enter a name for a new playlist to add to the playlist selected in the multimedia library. Device... Shows a dialog allowing you to enter a name, type and path for a new device to add to the Devices section of the multimedia library. Some device types need additional settings. See the Devices micro-HOWTO for details. Folder Opens the selected folder in the multimedia library. If the library window is not shown, this command will show it. Each folder in the recent history has its own command on this submenu. Each top level folder also has its own command. &Alt;Left Arrow Back Opens the previous folder. &Alt;Right Arrow Forward Opens the next folder. This command will be available after you use the Back command. &Alt;&Shift;Up Arrow Up Opens the parent folder of the selected folder. &Alt;&Shift;Down Arrow Down Opens the selected folder. &Alt;&Shift;Left Arrow To Origin Opens the origin folder of the selected folder. This command is available when the currently selected folder is linked to an origin folder. For an explanation of linked folders, see the Multimedia library micro-HOWTO. &Ctrl;M Show Menubar Shows or hides the menu bar. Show Statusbar Shows or hides the status bar. &Ctrl;P Show Playlist Shows or hides the playlist toolbar. &Ctrl;L Show Library Shows or hides the multimedia library. &Ctrl;G Show Message Log Shows or hides the message log. Show Main Toolbar Shows or hides the main toolbar. Show Progress Toolbar Shows or hides the progress toolbar. This command is available when the time length of the current file is known. Show Volume Toolbar Shows or hides the volume toolbar. Show Contrast Toolbar Shows or hides the contrast toolbar. This command is available for video files. Show Brightness Toolbar Shows or hides the brightness toolbar. This command is available for video files. Show Hue Toolbar Shows or hides the hue toolbar. This command is available for video files. Show Saturation Toolbar Shows or hides the saturation toolbar. This command is available for video files. Configure Shortcuts... Opens a dialog that lets you see and change &kplayer;'s shortcut key bindings, or associations between actions and the corresponding keys or combinations of keys that activate them. If you change the bindings, make sure not to duplicate an existing shortcut and also not to use the &Shift; key for your new shortcuts, because the &Shift; key has a special function in &kplayer;. Configure Toolbars... Opens a dialog that lets you see and change the command buttons available on &kplayer;'s toolbars. Configure &kplayer;... Opens a dialog that lets you configure the program, modifying various aspects of its functionality, user interface and interaction with &mplayer;. For more information see the Configuration dialog chapter and the Advanced configuration micro-HOWTO in this manual. &kplayer; Handbook Opens and displays the &kplayer; user manual. What's This... Changes the mouse pointer to a question mark and lets you click a &kplayer; interface element to get a quick description of its purpose and functionality. Report Bug... Opens a help topic that explains the recommended way to report a bug in &kplayer;. About &kplayer;... Displays some brief information about &kplayer;'s version number, authors and license agreement. About &kde;... Shows some information about the version of &kde; that you are running. The main toolbar contains the most useful &kplayer; commands and options. Play and Play URL buttons invoke the corresponding actions from the File menu that display dialog boxes allowing you to play local files or remote URLs. Properties button corresponds to the command on the File menu that will open the File Properties dialog for the current file. Play, Pause and Stop buttons correspond to the commands on the Player menu and will respectively start, pause and stop playback of the current file. Zoom In and Zoom Out buttons invoke the commands on the View menu that respectively enlarge and reduce the video area by one half of the original video size of the current file. Maintain Aspect button corresponds to the command on the general popup menu that will toggle the option to maintain the video aspect ratio. Full Screen button invokes the command on the View menu that switches to the full screen mode and back the to normal mode. Volume, Contrast, Brightness, Hue and Saturation buttons display popup sliders allowing you to adjust those settings. If you want the slider to stay visible instead of disappearing when it loses the input focus, use the slider toolbars instead. As usual, if you hold the &Shift; key down, the changes you make to the settings will be applied only to the current file and stored in its properties. The playlist toolbar contains the current playlist and the most frequently used playlist commands and options. Next and Previous buttons correspond to the commands on the Player menu and will select the next or previous item on the playlist and start playing it. The playlist combo box in the closed state displays the current playlist item. You can drop down the combo box to see the entire list and select a different item to load and play. Loop button is the same as the corresponding command on the Player menu that toggles the option to continue playing from the top of the current playlist after playing the last item. Shuffle button is also the same as the corresponding command on the Player menu that toggles the option to play items in random order. The progress and seeking toolbar is available when &kplayer; knows the time length of the current file. It shows the current playback progress and lets you seek, which is to say, move the playback position forward or backward. The progress slider reflects the current playback position relative to the total time length of the current file, and also lets you seek or change the current position. To seek forward and backward by the distance between the tick marks on the slider, left click to the right or left of the slider thumb. To seek to a specific point, middle click that point, or left click and drag the slider thumb to that point. If your mouse has a wheel, you can roll it up (away from you) to seek forward or down (towards you) to seek backward when the mouse pointer is over the slider. If you hold down the &Ctrl; key on the keyboard when rolling the wheel, seeking will be faster. Fast Forward and Fast Backward buttons corresponds to the commands on the Player menu that seek forward or backward by the amount which by default is the same as the distance between slider marks. However, internally they use different seeking technique (relative as opposed to absolute), and so sometimes may give different results than left clicking the slider. The volume toolbar allows you to control the sound volume. The volume slider allows you to change the sound volume. If you hold the &Shift; key down, the setting will be applied only to the current file and stored in its properties. If you want the slider to always disappear after you have changed the volume, hide this toolbar and use the popup slider on the main toolbar instead. Show Volume Toolbar button corresponds to the command on the Settings menu and will hide the toolbar when clicked. Mute button turns the sound off and back on, without changing the normal sound volume. It is the same as the command on the Audio submenu of the Player menu. The contrast toolbar allows you to control the video contrast. The contrast slider allows you to change the video contrast. If you hold the &Shift; key down, the setting will be applied only to the current file and stored in its properties. If you want the slider to always disappear after you have changed the contrast, hide this toolbar and use the popup slider on the main toolbar instead. Show Contrast Toolbar button corresponds to the command on the Settings menu and will hide the toolbar when clicked. The brightness toolbar allows you to control the video brightness. The brightness slider allows you to change the video brightness. If you hold the &Shift; key down, the setting will be applied only to the current file and stored in its properties. If you want the slider to always disappear after you have changed the brightness, hide this toolbar and use the popup slider on the main toolbar instead. Show Brightness Toolbar button corresponds to the command on the Settings menu and will hide the toolbar when clicked. The hue toolbar allows you to control the video hue. The hue slider allows you to change the video hue. If you hold the &Shift; key down, the setting will be applied only to the current file and stored in its properties. If you want the slider to always disappear after you have changed the hue, hide this toolbar and use the popup slider on the main toolbar instead. Show Hue Toolbar button corresponds to the command on the Settings menu and will hide the toolbar when clicked. The saturation toolbar allows you to control the video saturation. The saturation slider allows you to change the video saturation. If you hold the &Shift; key down, the setting will be applied only to the current file and stored in its properties. If you want the slider to always disappear after you have changed the saturation, hide this toolbar and use the popup slider on the main toolbar instead. Show Saturation Toolbar button corresponds to the command on the Settings menu and will hide the toolbar when clicked. Like any half decent &kde; program, &kplayer; sports popup menus that you can get by right clicking different parts of it. When you right click the video area, the menu bar or the status bar, you get the general popup menu that includes the most frequently used &kplayer; commands and options. Play and Play URL commands invoke the corresponding actions from the File menu that display dialog boxes allowing you to play local files or remote URLs. Play List and Play Recent show the submenus from the File menu that allow you to play a playlist or a recent item respectively. Properties command corresponds to the command on the File menu that will open the File Properties dialog for the current file. Play, Pause and Stop commands correspond to the actions on the Player menu and will respectively start, pause and stop playback of the current file. Maintain Aspect command toggles the option to maintain the video aspect ratio. Full Screen command invokes the action on the View menu that switches to the full screen mode and back to the normal mode. The commands on the Settings submenu are the same as the commands on the Settings menu and will show or hide the menu bar, status bar, playlist toolbar, multimedia library, message log, main toolbar, progress and seeking toolbar and volume toolbar. Quit command invokes the action on the File menu that stops playback, saves all settings and closes &kplayer;. When you right click the playlist drop down box on the playlist toolbar, &kplayer; displays a menu that lists commands that work on the current playlist. Play... and Play URL... commands invoke the corresponding actions from the File menu that display dialog boxes allowing you to play local files or remote URLs. Play List and Play Recent show the submenus from the File menu that allow you to play a playlist or a recent item respectively. Device submenus are also the same as the ones on the File menu. Please refer to the description above for details. Next and Previous commands invoke the corresponding actions from the Player menu and will select the next or previous item on the playlist and start playing it. Loop and Shuffle commands are also the same as the ones on the Player menu that toggle the options to continue playing from the top of the current playlist after playing the last item and to play items in random order respectively. Edit command opens the current playlist in the multimedia library, allowing you to edit it. Files... Displays the standard Add files dialog and lets you choose a file or several files to add to the current playlist. URL... Displays the standard Add URL dialog and lets you type or paste in a URL to add to the current playlist. Playlist Adds the contents of the current playlist to the playlist you choose from the list. Each playlist in the Playlists section of the library has its own command on this submenu. Playlists... Shows a dialog allowing you to enter a name for a new playlist and saves the current playlist in the Playlists section of the multimedia library under that name. Collection... Shows a dialog allowing you to enter a name for a new folder and saves the current playlist in the Collection section of the multimedia library under that name. When you right click an item in the multimedia library, &kplayer; displays a menu that lists commands applicable to that item or to the currently selected items or to the current folder. The menu is the same as the Library menu on the menu bar. When you right click the message log, &kplayer; displays a menu that lists commands applicable to the message log. Select All command selects all the text in the message log. Copy command copies the selected message log text to the clipboard. Clear command removes all messages from the message log. When you right click a &kplayer; toolbar, you get a standard &kde; toolbar popup menu. It contains options that allow you to change the toolbar orientation, text position and icon size, as well as a command that opens the Toolbar configuration dialog. When you right click the &kplayer; title bar, you get a standard &kde; title bar popup menu. You can also get it by left clicking the little button in the top left corner of &kplayer; window or by pressing &Alt;F3. The menu contains commands that let you maximize, minimize, restore, move and resize the &kplayer; window, as well as a few options, some of which you may find useful. For example, the Keep Above Others option on the Advanced submenu lets you keep the &kplayer; window on top of all other program windows. &kplayer; features a KPart, which is an applet that can be embedded into other programs and used to watch video or play audio. You can configure programs like &konqueror; File Manager and &kmldonkey; to embed the &kplayer;'s KPart and play files with it. &konqueror; Web Browser can also be configured to use the &kplayer; KPart to display multimedia objects embedded in web pages. You can tell &konqueror; to use &kplayer; for playing multimedia files and URLs by going to the File Associations page either in the &konqueror; configuration dialog or in &kcontrolcenter; and moving &kplayer; to the top of the list of programs for each media type you want &kplayer; to play, both on the Program tab and on the Embedded tab. It is recommended that you choose the option to Open Separate Program, which will give you a whole lot more options and better interface when playing multimedia compared to an embedded KPart. However, when an object is embedded into a web page, &konqueror; has no choice but to use the KPart. In that situation the best thing is to right click the multimedia object and select the Start &kplayer; command described below. Following is a complete list of user interface elements that &kplayer;'s KPart provides whenever possible. However, when the KPart is embedded into a web page, only the right click popup menu will be available. This menu contains the following commands, most of which are the same as the corresponding commands in the full &kplayer;: Play, Pause, Stop, Forward, Fast Forward, Backward, Fast Backward and Back to Start commands from the Player menu of the full &kplayer;; Decrease Volume, Increase Volume and Mute commands from the Audio submenu of the Player menu of the full &kplayer;; Maintain Aspect command from the general popup menu of the full &kplayer;; Properties command from the File menu of the full &kplayer;; Start &kplayer; command from the KPart popup menu described below. This toolbar contains Play, Pause, Stop, Maintain Aspect, Volume and Properties buttons which as the same as the ones on the main toolbar in the full &kplayer;. This toolbar is the same as the Progress toolbar in the full &kplayer;. This toolbar is the same as the Volume toolbar in the full &kplayer;. Right clicking the video area of &kplayer; KPart embedded into another program gives you a popup menu. The top item on the menu is Start &kplayer; command that will stop playback, open the full &kplayer;, put the multimedia file or URL on the playlist and start playing it. It is always recommended that you choose this command, since it will give you better interface and more options when playing the multimedia. The popup menu also contains Play, Pause, Stop, Maintain Aspect and Properties commands which as the same as the ones on the general popup menu in the full &kplayer;. The action of the mouse wheel in &kplayer; depends on where the mouse cursor is positioned. If the cursor is positioned over a slider, rolling the mouse wheel will change the setting that the slider controls, like playback position, sound volume, video contrast and so on. Rolling the wheel up (away from you) increases the setting, while rolling it down (towards you) decreases it. You can hold down the &Ctrl; key on the keyboard when rolling the wheel to change the setting faster. Rolling the wheel when the mouse pointer is positioned over a window that has a scroll bar, like the multimedia library or the message log, will scroll the window up or down. Rolling the wheel over the playlist combo box will likewise scroll it up or down, switch to a different entry and start playing it. When the mouse pointer is in the video area, rolling the wheel up (away from you) will zoom in, that is, enlarge the video area, and rolling the wheel down (towards you) will zoom out, or reduce the video area. However, if &kplayer; cannot resize the video area, for example when the window is full screen or maximized, it will instead seek, or move the playback point, forward when rolling the wheel up (away from you) or backward when rolling it down (towards you). In that case you can also hold down the &Ctrl; key on the keyboard to seek faster.