<info> <desc>Complete keyboard shortcuts reference.</desc> </info>
Keyboard Interface

In command mode, the following keystrokes have special meanings:

<key>↓</key> or <key>Space</key> | Go to the next match
<key>↑</key> or <keyseq><key>Shift</key><key>Space</key></keyseq> | Go to the previous match
<key>→</key> or <key>/</key> | Descend into an object with content
<key>Backspace</key> | Erase a character from the query. If the query is empty, go up a level
<key>.</key> | Activate free-text mode
<key>,</key> | Put selected object on the stack ("Comma Trick")

Quick access keys:

<key>=</key> | Activate free-text mode with = prefix (for )
<key>/</key> | Activate free-text mode (when nothing is selected) with `/` prefix (to input a rooted path)

Additionally:

<list> <item>

<key>Return</key> activates the current selection: the command is executed.

</item> <item>

<key>Escape</key> clears the current selection.

</item> <item>

<key>Tab</key> switches between the object and the action pane.

</item> </list>

The meaning of the keys <key>Space</key>, <key>.</key>, <key>,</key>, <key>/</key> and <key>=</key> can not be changed, but you can deactivate their special meaning with the checkbox <app>Use single keystroke commands</app> in <app>Kupfer Preferences</app>.

Kupfer's Keyboard Shortcuts

These keyboard shortcuts are used in <app>Kupfer</app>'s interface. They have the following meanings and default shortcuts (some have no default).

<keyseq><key>Alt</key><key>A</key></keyseq> | Alternate activate
<keyseq><key>Ctrl</key><key>.</key></keyseq> | Toggle text mode
<keyseq><key>Ctrl</key><key>,</key></keyseq> | The comma trick
<keyseq><key>Ctrl</key><key>;</key></keyseq> | Show preferences window
<keyseq><key>Ctrl</key><key>R</key></keyseq> | Reset all
<keyseq><key>Ctrl</key><key>Return</key></keyseq> | Compose command
| Switch to 1st pane
| Switch to 2st pane
| Switch to 3st pane
<keyseq><key>Ctrl</key><key>Q</key></keyseq> | Select 'Quit'
| Select 'Clipboard File'
| Select 'Clipboard Text'
| Select 'Selected File'
<keyseq><key>Ctrl</key><key>G</key></keyseq> | Select 'Selected Text'
<keyseq><key>F1</key></keyseq> | Show Help

<steps> How to configure a keyboard shortcut <item>

Open <app>Kupfer Preferences</app> and go to the Keyboard tab.

</item> <item>

Double-click the shorcut's row under Browser Keyboard Shortcuts.

</item> <item>

Using the window that appears, press modifier keys and a letter or number key to set a shortcut. An example is pressing and holding <key>Ctrl</key> and then pressing and releasing <key>T</key> to bind <keyseq><key>Ctrl</key><key>T</key></keyseq>.

</item> </steps>
Action Accelerators

Action acclerators are a quick way to select or run a certain action on an object. All action accelerators use the same modifier key, which is <key>Ctrl</key> by default.

An action's accelerator is a key that is pressed together with the modifier to directly run the action on the currently selected object (in the case of actions that need an indirect object, the third pane will be focused instead).

<steps> How to configure an action accelerator <item>

Open <app>Kupfer</app> and find an object that allows the action you are configuring. Switch to the action pane with <key>Tab</key>.

</item> <item>

Find the action to configure an accelerator for in the action pane.

</item> <item>

Click the kupfer context menu in the window and select the option Assign Accelerator to “(Action)”

</item> <item>

Press and release a single key (with or without the action accelerator’s modifier) in the window that pops up. <key>Escape</key> cancels the configuration, and <key>Backspace</key> unsets the accelerator key for the action.

</item> </steps> <note>

Regular keyboard shortcuts in <app>Kupfer</app> take precedence over action accelerator keys. If multiple simultaneously eligible actions have the same accelerator key, the highest ranked one will be activated.

</note>
Global Keyboard Shortcuts

<app>Kupfer</app> always listens to global shortcuts, even if it is not currently in the foreground.

They have the following meanings and default shortcuts:

<keyseq><key>Ctrl</key><key>Space</key></keyseq> | Show/hide <app>Kupfer</app>
(not configured by default) | Show <app>Kupfer</app> with 'Selection' object focused

<steps> How to configure a global keyboard shortcut <item>

Open <app>Kupfer Preferences</app> and go to the Keyboard tab.

</item> <item>

Double-click the shorcut's row under Global Keyboard Shortcuts.

</item> <item>

Using the window that appears, press modifier keys and a letter or number key to set a global shortcut. An example is pressing and holding <key>Super</key> and then pressing and releasing <key>Space</key> to bind <keyseq><key>Super</key><key>Space</key></keyseq>.

</item> </steps>

Since these keyboard shortcuts are global, they can be used from any application. Select shortcuts with care so that they do not conflict with other functions.

Triggers

The plugin Triggers allows to activate actions with global keyboard shortcuts. Trigger shortcuts do not appear in <app>Kupfer Preferences</app>.

See for more information.