Installation & Onboarding
System requirements, installation steps, Accessibility permissions, and first-launch flow.
On this page (4 sections)
This page covers installing OpenClip on macOS, granting the permission it needs, and what you see the first time you launch it.
System requirements#
- macOS 14.0 (Sonoma) or later.
- Apple Silicon (M1 through M4) or Intel. The app is a universal binary.
- Accessibility permission, so OpenClip can detect when you select text.
The interface follows the macOS system language. English, Simplified Chinese, Traditional Chinese, French, and Japanese are bundled.
Installation steps#
- Download the latest
.dmgor.zipfrom the releases page. - Drag
OpenClip.appinto your/Applicationsfolder. - Open
OpenClip.appfrom Finder or Spotlight.
Releases are signed with an Apple Developer ID certificate and notarized by Apple, so OpenClip opens normally. You don't need to right-click to open it or strip a quarantine attribute with xattr. If macOS says the app "cannot be opened because the developer cannot be verified", you don't have a release build, so check where the download came from.
To check a copy before launching it:
spctl -a -vv -t exec /Applications/OpenClip.app
# accepted
# source=Notarized Developer ID
xcrun stapler validate /Applications/OpenClip.app
# The validate action worked!Granting Accessibility permission#
OpenClip uses the macOS Accessibility API (AXUIElement) to read the text you select without touching your clipboard.
- On first launch, OpenClip asks for Accessibility permission. Click Open System Settings.
- Go to Privacy & Security > Accessibility.
- Turn on the switch next to OpenClip.
- Confirm with your Mac password or Touch ID.
Note
OpenClip reads the selection only when you select text with the mouse. It doesn't log keystrokes and it doesn't store what you selected.
First launch#
The first time you open OpenClip it shows a four-step setup:
- Welcome explains the idea: select text, then pick an action.
- Access checks the Accessibility permission. Everything runs on your Mac.
- Extensions offers a few useful ones, such as translation, word count, and speech, each with a one-click install.
- Try it is a small sandbox where you can select text and see the real action bar.
You can skip any step. Finishing setup starts text-selection monitoring. After that you can open the popup at any time with the global shortcut (⌥⌘C by default), set up AI providers in Preferences > AI, and change the popup's look in Preferences > Appearance.