macOS Permissions
macOS has many privacy gates. Some Octoclip capabilities (auto paste, global input, background monitoring) require OS-level permissions. This page explains what each permission enables, where to grant it, and how to verify. Only enable what you need.
Who this is for
- Users setting up auto paste or background monitoring on macOS for the first time
- Users whose features stopped working after an OS upgrade and need to re-grant
Exactly which permissions are needed, the prompt wording, and toggle names vary by macOS version and app version. Defer to Octoclip's runtime system prompts and the actual items under System Settings → Privacy & Security.
What each permission enables
| Permission (System Settings → Privacy & Security) | What it enables |
|---|---|
| Accessibility | Auto paste, simulated paste/insertion into the target app, global input behavior |
| Input Monitoring | Global shortcuts, listening for trigger input |
| Screen Recording | Possibly needed only for screenshot/text-grab features [待确认：whether the current version requires it] |
| Files and Folders | Grant as needed for file-type clips or import/export |
Without Accessibility granted, auto paste / direct insertion into the target app usually won't work, often showing as "the clip is in history but won't paste."
Granting steps
Open System Settings → Privacy & Security.
Under categories like Accessibility and Input Monitoring, find Octoclip and turn on the toggle. Enable only what you use.
Some permissions take effect only after restarting Octoclip.
Confirm Octoclip runs in the menu bar; confirm local clip capture works before testing cross-device sync.
How to verify after fixing
- Copy a plain-text string and confirm it enters the local clip history.
- Trigger an auto paste into an ordinary text field and confirm it inserts.
- If you use a global shortcut, confirm it invokes the expected capability.
Still not solved
Please include:
- macOS version
- App version and install source
- Affected capability (auto paste / global shortcut / background monitoring)
- Permissions granted vs denied
- Whether you recently upgraded the OS
- Reproduction steps (shortest path)
For working through OS-level permission problems, see Permission Issues.