<info> <desc>How to start using <app>Kupfer</app>.</desc> </info>
Keyboard Interface

<app>Kupfer</app> is to the largest part a keyboard-managed interface to applications and documents.

Kupfer's default mode is the command mode: If you type a query, kupfer will search for a match in its catalog.

The arrow keys allow you to browse query matches quite naturally, going to the previous or next match, and going up and down in the subcatalogs.

In command mode, some 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")

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>

By default you show <app>Kupfer</app> using the global keyboard shortcut <keyseq><key>Ctrl</key><key>Space</key></keyseq>.

See for more information.

Learning Habits

<app>Kupfer</app> remembers which objects and actions are used the most and which abbreviations you use to access them. When starting, you have to use the arrow keys at times to make it precise which object you want to find. After a few uses of that object, Kupfer will rank it higher.

The Catalog

The Catalog is the collection of objects you can access in Kupfer, such as documents and programs.

Objects in the catalog that have content, like folders, are marked with an arrow. Pressing <key>→</key> will enter these objects. Much of the catalog is composed of subcatalogs; plugin subcatalogs do in general list objects that are also available directly from the top level. Subcatalogs can be used for a narrower view or search scope, when using Kupfer.

Most subcatalogs update their content automatically. For example, the Desktop folder source is always up-to-date.