Keyboard
========

This page lists useful default shortcuts and key mappings for CopyQ and
describes how to change them.

CopyQ is keyboard-friendly, i.e. it should be possible to quickly access
any functionality with keyboard without using mouse.

Default Shortcuts
-----------------

.. note::

   On OS X, use ⌘ key instead of Ctrl for the shortcuts.

-  PgDown/PgUp, Home/End, Up/Down - item list navigation
-  Left, Right, Ctrl+Tab, Ctrl+Shift+Tab - tab navigation
-  Ctrl+T, Ctrl+W - create and remove tabs
-  Ctrl+Up, Ctrl+Down - move selected items
-  Esc - cancel search, hide window
-  Ctrl+Q - exit
-  F2 - edit selected items
-  Ctrl+E - edit items in an external editor
-  F5 - open action dialog for selected items
-  Delete - delete selected items
-  Ctrl+A - select all
-  Enter - put current item into clipboard and paste item (optional)
-  Ctrl+1...Ctrl+9 - focus a tab in given order
-  Ctrl+0 - focus last tab

Search
------

Start typing a text to search items. This works in main application
window and ``copyq menu``.

Change Shortcuts
----------------

To change the shortcuts:

1. Open "File - Preferences".
2. Select "Shortcuts" tab.
3. Click the button next to action you need to change.
4. Press a shortcut on keyboard.
5. Click OK to save the dialog.

Create new Shortcut
-------------------

If and action with shortcut is missing in the Shortcuts configuration
tab, you can use predefined ones:

1. Open "File - Commands/Global Shortcuts...".
2. Click "Add" button.
3. Select command (e.g. "Show/hide main window").
4. Press a shortcut on keyboard.
5. Click OK to save the dialog.
