Files
lightcraft/docs/library-shortcuts.md
eliets2 c38bf96ef9 Docs: Select Only Active Photo in the shortcut list and the parity checklist
Add the Cmd+Shift+D row to the library shortcut table with a short note on
what it does and where it can be rebound, add a checklist row for it with
status partial (covered by headless key tests; the native macOS menu path
is not verified), and update the checklist's Last updated line, revision
history and the summary counts that this one row changes.
2026-10-13 15:42:56 +03:00

3.8 KiB
Raw Permalink Blame History

Library ratings, labels and flags

Select photos in Photo Grid or Square Grid, then use:

Key Action
Cmd+Shift+D (macOS) / Ctrl+Shift+D (Windows/Linux) Select only the active photo
0 Clear the star rating
1–5 Set the star rating
[ / ] Decrease / increase each selected photo's rating by one, within 0–5
6, 7, 8, 9 Set a red, yellow, green or blue label
P Flag as a pick
X Flag as rejected
U Clear the flag
Shift + 0–9, P, X or U Apply the action and select the next photo

Select Only Active Photo (Edit menu) narrows the selection to the active photo. It does not change the photo, its edits or the last edit Undo step, and it works in any view that has an active photo. It can be reassigned or disabled in Help → Keyboard Shortcuts; text fields and dialogs keep the key.

Purple and clearing a colour label are available in Photo → Set Color Label and the photo context menu. Purple has no default number key, matching Lightroom Classic. Rejection marks a photo for culling; it does not delete the original or remove it from the library. Setting a colour label shows the same brief bottom toast as a rating, using the colour or your custom label name. Clearing it shows a confirmation too, whether applied by a key, menu or swatch. Labelled thumbnails have a translucent matching colour on the square-grid surround, photo-grid footer (translucent, over the bottom of the photo) and Detail filmstrip surround. The white active-photo outline remains clear. The label confirmation uses a pale matching background with dark text; ratings and errors retain their neutral HUD styling. Custom names use the underlying label's colour.

Bracket ratings use each photo's own starting rating, and the changed photos form one Undo / Redo step. AutoWrite uses the normal rating metadata path. In Detail, including Masking and Remove, [ / ] keep resizing the brush and shifted brackets keep adjusting feather. Saved overrides, remapping and disabling the default brush bindings take precedence over their grid bracket actions. The separate Decrease Rating / Increase Rating commands can also be assigned in Help → Keyboard Shortcuts.

Grid actions apply to all selected photos and support Undo / Redo. In Compare and Survey, culling actions apply to the active photo. Auto Advance moves forward after an action; holding Shift with Auto Advance on still advances only once. The last photo stays selected. Text fields keep their keyboard input, and X in the Crop panel swaps the crop aspect. Shifted number keys also use the physical number key when the keyboard reports punctuation (for example, Shift+1 as !). Letter shortcuts continue to follow the keyboard layout.

Shift+P picks and advances in the two library grids. In other views it retains LightCraft's Presets-panel binding. Shift+Z remains an alternative pick-and-advance key in all views.

The macOS native menu displays plain-key bindings but leaves execution to egui; only shortcuts AppKit delivers to the menu (Command, Control or function keys) are skipped by egui. The native menu correction is adapted from PR #261, commit 4e012a59a6d2442ba749f109ea27aadb5c0b11a5 by Gardy, and addresses the cause reported in issue #283. That PR was open when checked on 2026-10-08; this work extends its fix with library culling bindings and tests.

Public behaviour references, checked 2026-10-08:

Only public descriptions were consulted. No Adobe assets or application data are included.