Keyboard shortcuts

#The shortcuts

All of them are remappable in Settings → Shortcuts, and can be reset there too.

#Why ⌘⇧V does not break anything

⌘⇧V is already macOS's Paste and Match Style. A menu-bar app that claimed it globally would take that away from every text field on the system — which is the kind of thing you discover three weeks later, in someone else's document.

So Klippster does not claim it globally. It registers the hotkey when Finder activates and hands it straight back the moment Finder resigns.

Finder becomes frontmost   →  ⌘⇧V and ⌘⇧C registered
Finder resigns             →  both released

Everywhere else            →  ⌘⇧V is still Paste and Match Style

How it works: the hotkeys are registered with Carbon's RegisterEventHotKey, gated on NSWorkspace application-activation notifications. The effect is a dedicated Finder command that costs no other app a keystroke.

The trade is that these two need the Automation permission described in Install — the hotkey does not go through the Finder extension, it asks Finder for the frontmost window's folder and writes there directly. Decline it and you keep every Finder right-click menu and every Services row, and lose only the two shortcuts.

The upside of not going through the extension: the shortcuts work in iCloud Drive, where the right-click submenus cannot appear at all. See Troubleshooting.

#The Center hotkey is different

⌘⌥V is global, and that is intentional. A panel you can only reach from Finder would be useless — the moment you want a Klipp from last Tuesday is almost always the moment you are in a mail window or an editor, not in Finder.

It opens Klippster Center: the current Klipp, your recent and pinned Klipps, and the Shelf, with Open Clipboard History… leading on to everything else — searching, folders, editing.

It stays registered whether or not Clipboard History recording is switched on. With recording off, the history window opens and tells you it is off rather than appearing broken.

#Remapping, and what a shortcut collides with

Settings → Shortcuts lets you put any combination on any of Klippster's bindings. When the keys already mean something, the pane says so — and lets you take them anyway. You know your own habits better than a table does, so the warning informs; it never refuses.

What it can tell you:

• Another Klippster binding already uses the keys.
• macOS keeps the shortcut for itself — ⌘Space, ⌘⇥, the screenshot keys. macOS reports that these are taken but not what they do, so the pane points at System Settings rather than guessing a name. A system shortcut you have switched off counts as free.
• A known app shortcut — Klippster carries a short list of well-known menu shortcuts, so it can warn that a global binding on ⌥⌘H would cost you Hide Others everywhere. That list cannot be complete: reading another app's actual menus would need the Accessibility permission, which Klippster does not ask for.

Scope is part of the answer. The two Finder-only bindings exist only while Finder is frontmost, so only collisions inside Finder count against them — which is why ⌘⇧V is a safe default: Paste and Match Style lives in text apps, and Finder itself does not use the combination. A global binding, on the other hand, really does win the keys everywhere while Klippster is running.

#Shortcuts for the Services rows

The four Services rows — Paste Clipboard Here, Copy to Clipboard as…, Convert with Klippster… and Edit with Klippster… — can be given their own shortcuts under System Settings → Keyboard → Keyboard Shortcuts → Services. Services work everywhere, including the folders where the right-click submenus cannot appear, and they need no permission at all.

#If a shortcut does nothing

• Nothing happens in Finder. The permission was probably declined or reset by a macOS update. Re-grant it in System Settings; Klippster picks the shortcuts back up without a restart.
• Another app took the key. Two apps can register the same global hotkey and the first one wins. Remap Klippster's in Settings → Shortcuts.
• ⌘⇧V pastes plain text instead. Finder was not actually frontmost — a Finder window being visible is not the same as Finder being the active application. Click the window first.

Troubleshooting has the rest.