Support

Answers to common questions. If yours isn’t here, get in touch.

Getting started

Where is Caplet?

Caplet has no Dock icon. It lives in the menu bar at the top of the screen. Click the Caplet icon there to reach every feature and the settings.

What are the default shortcuts?

• Capture Area: ⌘⇧A
• Capture Full Screen: ⌘⇧F
• Clipboard History: ⌘⇧V

You can change them in Settings › Shortcuts. A yellow warning next to a shortcut means another app already uses it, so choose a different one.

Permissions

Why does Caplet need Screen Recording permission?

macOS requires it for any app that captures the screen. Caplet reads the screen only when you take a screenshot. Turn on Caplet in System Settings › Privacy & Security › Screen & System Audio Recording. If Caplet isn’t listed, click “+” below the list to add it. Reopen Caplet after granting access.

Why does Caplet need Accessibility permission?

Only the “Paste Directly When Picking an Item” feature uses it: after you pick an item in the clipboard history, Caplet presses ⌘V for you. Caplet does not use this permission to read or control other apps. If you prefer not to grant it, turn the feature off in Settings › Clipboard. Picking an item will then only copy it, and you paste it yourself.

The clipboard history stays empty

By default macOS asks before an app reads the clipboard. In System Settings › Privacy & Security › Paste from Other Apps, set Caplet to “Always Allow”.

Screenshots

How do I copy text from a screenshot?

Select an area, then click Recognize Text in the toolbar. You can drag across the recognized text like ordinary text and press ⌘C to copy the selection. Press ⌘C without selecting anything to copy all of it.

How do I pick a color?

Select an area, then click Pick Color in the toolbar. Move the loupe over the spot you want and click to copy its hex value. Shift-click to copy it as RGB.

What does Pin to Screen do?

It keeps the screenshot floating above other windows for reference. Drag it to move, scroll to zoom, and double-click or press esc to close it.

Clipboard history

What is not recorded?

Content that password managers mark as private is never recorded. You can also add apps under Settings › Clipboard › Ignored Apps; anything copied while they are frontmost is skipped. Caplet currently records text and images, not files.

How do I keep an item from being cleaned up?

Select it in the history and press ⌘P, or click the pin on the right of the item. Pinned items stay at the top and are exempt from the count and time limits.

How do I delete history?

Select an item and press ⌘⌫ to delete it. Click Clear History at the bottom of the panel to delete everything that isn’t pinned.

Other

How do I change the language?

Choose it in Settings › General › Language, then reopen Caplet.

How do I remove Caplet and its data completely?

Quit Caplet and move it from the Applications folder to the Trash. The clipboard history is stored in ~/Library/Containers/net.xiangong.caplet; delete that folder to remove all data.