====== Playlist view ======
The playlist is the main area of the UI where your songs are listed.

There are currently two playlist views available: NG playlist and Columns Playlist.
Columns playlist is now obsolete; NG Playlist replaces it.

===== General commands =====

  * **Double click a track**\\ Plays that track.
  * **Enter key**\\ Plays that track.
  * **Press Ctrl+Enter**\\ Adds track to the playback queue.
  * **Right click track(s)**\\ Shows the shortcut menu for the track(s) .
  * **NG playlist only: Drag the selection with the left mouse button**\\ Starts a drag and drop operation with the selection.
  * **Columns playlist only: Hold Ctrl and drag with left mouse button**\\ Starts a drag and drop operation with the selection.
  * **Columns playlist only: Drag with right mouse button**\\ Starts a drag and drop operation with the selection.

There are various methods of manipulating the selection. For the alternative selection model, these are as follows:

===== Selection manipulation =====

==== Standard selection model ====

FIXME write me

==== Alternative selection model ====

  * **Left click a track**\\ Selects it exclusively.
  * **Hold Ctrl and left click a track**\\ Toggles the track's selected state.
  * **Drag a selected track with left button**\\ Moves selection vertically.
  * **Drag an unselected track with left button**\\ Creates a new selection.
  * **Hold Ctrl and Shift and left click a track**\\ Moves selected tracks to the point you clicked.
  * **Up or Down arrow keys**\\ Exclusively selects and focuses the item above or below the focused item.
  * **PgUp or PgDn keys**\\ Exclusively selects and focuses the first or last item in the next or previous page.
  * **Home or End keys**\\ Exclusively selects and focuses the first or last item in the playlist.

  * **Hold Shift and press Up/Down/PgUp/PgDn/Home/End**\\ Performs as Up/Down/PgUp/PgDn/Home/End, but additionally selects all items from originally focused item to the new one.
  * **Hold Ctrl and press Up/Down/PgUp/PgDn/Home/End**\\ Performs as Up/Down/PgUp/PgDn/Home/End, but only moves the focus to te new item.
  * **Hold Ctrl and Shift and and press Up/Down/PgUp/PgDn/Home/End**\\ Moves selected items to the position of the item that would be selected if only Up/Down/PgUp/PgDn/Home/End was pressed.
  * **Space**\\ Toggles the focused item's selection state.

===== Columns Titles =====

Another area of the playlist you can see is the columns titles.

  * **Click a column title**\\ Sorts by that column, in reverse order if already sorted by that column.
  * **Drag column title**\\ Moves the column to the location you drag the title to.

When not in auto-sizing columns mode, these actions are also available:

  * **Drag a column title divider**\\ Resizes that column.
  * **Double click on a column divider**\\ Makes that column resize to the minimum possible width so that all its items are visible.

===== Inline metafield editing =====
If mouse activated inline metafield editing is enabled, you can left-click on a selected track to enter inline-metafield editing mode. The ''F2'' key also enters this mode, when the playlist has the keyboard focus. 

In this mode, the following actions are available:
  * Pressing ''ESCAPE'' will exit this mode, cancelling any changes to the current field.
  * Pressing ''ENTER'' will save changes and exit this mode.
  * Pressing ''TAB'' will save changes and advance to the next field.
  * Holding ''CTRL'' and pressing ''TAB'' will save changes and move to the preceding field.
  * Holding ''CTRL'' and pressing ''ENTER'' will insert a newline.
  * Pressing ''UP'' or ''DOWN'' will navigate up or down a line within the field.
  * Clicking anywhere outside of the edit field will save changes and exit this mode.

Metafield assignments are done in the [[.config:playlist view:columns|columns configuration page]].

==== Limitations ====
  * For items with multiples values for the same metafield, currently only the first value will be edited. This may be overcome in the future by using a separating character such as '';''.
  * There is currently no multi-item edit mode.