# Playlist

## Built-in playlist

&kplayer; has had a simple playlist since version 0.4. It supports all basic playlist functions and options. You can add entries using Open and Open URL commands on the File menu, by starting &kplayer; with a file path from &konqueror; or from command line, or by dragging and dropping a file onto &kplayer; from &konqueror; or another program. You can also move entries around the list by dragging them with the mouse or by using the Move Up and Move Down commands on the Playlist menu, the playlist popup menu or the playlist editor toolbar.

Playlist toolbar

  The first command on the Playlist menu shows the Playlist toolbar inside the &kplayer; window. The toolbar has Next and Previous commands, the playlist itself, and the Loop and Shuffle options. Selecting an entry from the list will start playing it.

Playlist editor

  The second command on the Playlist menu shows the Playlist Editor window. It allows you to move entries around, rename or delete them, start playing an entry or edit its properties.

Playlist editor toolbar

  The third command on the Playlist menu shows the playlist editor toolbar that has buttons for moving entries around and deleting them, as well as the Temporary list for new items aka Lock option. This toolbar is embedded into the playlist editor.

Loop and Shuffle

  If you choose both Loop and Shuffle options, the list will be reshuffled every time it loops. To reshuffle at any time, disable the Shuffle option and enable it again.

Temporary list for new entries, aka Lock

  This option locks the playlist and tells &kplayer; to put new entries on a temporary list. The temporary list will only be shown in the drop down list on the playlist toolbar. The main list will stay in the editor, and you can resume playing from it by clicking an entry in the editor or choosing Play From Playlist from the Playlist menu.

Play selection only

  Selecting this option will make &kplayer; play only the items selected in the playlist editor. Newly added items will be initially selected.

Clear before adding new entries

  This option is set separately for the main list and for the temporary list. It will wipe out the current list before adding new entries, whether by using Open or Open URL, starting &kplayer; with a file parameter, or dropping files onto &kplayer; window.

Allow duplicate entries

  When this option is unchecked on the Playlist page in &kplayer; Settings, duplicate entries will be automatically removed from the playlist. Entries are duplicate if they have exactly the same URL.

Playlist size limit

  If you try to add more than the given number of entries, the topmost entries will be removed so the playlist stays under the specified size.

Cache size limit

  &kplayer; will remember properties of every file you play with it, until the total number reaches this limit. After that &kplayer; will start discarding properties of the oldest entries. Playing a file makes its entry the most recent.

## Playlist files

&mplayer; currently cannot automatically detect and play playlist files like `m3u`, `pls`, `asx`, `ram` and so on. &kplayer; needs to pass a special option to &mplayer; for it to play a playlist file correctly.

&kplayer; tries to detect playlist files by file extension. However, sometimes a playlist file will not have a playlist extension, or a file that is not a playlist can have a playlist extension. In those cases playback will initially fail. You can then go to the General page in File Properties and set the Playlist option correctly. kplayer; will remember the option and use it the next time you play the same file or URL.

If setting the Playlist option does not help, you will need to manually extract the actual path or URL from the file and paste it into the Open URL dialog that you can open from the File menu.

The playlist extensions &kplayer; recognizes are `ram`, `rpm`, `smi`, `smil`, `asx`, `m3u`, `pls` and `strm`.