Every key, and how to change it.

How to read this

⌘ is Command, ⌥ is Option, ⌃ is Control, and ⇧ is Shift. A key written on its own, like T, is pressed on its own.

Some keys mean different things depending on where you are. There are three places: the grid of thumbnails, the large preview, and a video playing in the preview. Where a key only works in some of them, the table says so. Everything else works anywhere.

Single letters pause whenever you are typing. If the cursor is in the keyword field, T types a letter t. Press Esc to leave the field and the keys come back.

A command that cannot run right now does not fail quietly. It beeps and the status bar says why, for example that nothing is tagged, or that the source is read only.

Keys that never change

These move you around and open things, so they are not available for rebinding. Settings lists them too, so nothing about the keyboard is hidden.

Marking

By default a marking key acts where you are and does not move on. Turn on advancing in Settings, Culling, and then holding ⇧ does the opposite for one press. The command names in the app flip to match, so the menu always tells the truth.

A mark applies to every selected photograph, or to the one under the focus ring. On a collapsed bracket stack it applies to every frame in the stack.

Moving

In the sources list, ↑ and ↓ move, ↩ or → opens, and typing the first letters of a name jumps to it.

Views and overlays

Zoom

All of these work in the preview. Zoom is anchored on the pointer, so the detail under the cursor stays under the cursor.

A pinch on the trackpad zooms around your fingers, a two finger drag pans, and a two finger double tap does what Z does. In the grid, a pinch resizes the thumbnails.

Selecting and filtering

Selection follows the Finder. Click to select, ⌘ click to add or remove one, ⇧ click to take a range. ⌘ with an arrow key moves the focus ring without changing what is selected, which is how you reach past a selection without losing it.

Stacks

Metadata

The quick entry syntax is on the templates page.

Files and ingest

Video

These work while a video is open in the preview, and they take precedence over the letters they share.

Cards and folders

App

Changing a key

Open Settings, then Shortcuts. Every command is listed with its key. Click the key and press the one you want. Esc cancels, and Delete removes the key so the command has none.

If the key is already taken by something that overlaps, Ingest names the other command and offers to move the key across. It refuses a key that is fixed, and it refuses the bare keys that move you around, because the app consumes those before any command sees them.

A changed key follows everywhere at once. The menus, the palette, the ? sheet, and the hold overlay all read from the same table, so there is no second place to update and nothing to get out of step. Reset All puts every key back.

Commands without a key

Plenty of commands have no key, on purpose. They are all in the palette. Press ⌘K and type a few letters of the name, an alias, or the category.

The palette also lists the things that come and go: your favourites, workspaces, splits, metadata presets, actions, and recent folders. ⇧⌘P pins whatever is highlighted to the top of the list. ⇧⌘C copies a link that runs it, which is how the URL scheme is meant to be discovered.