Skip to content

Troubleshooting

This page lists common problems and their possible solutions, as well as known issues with specific apps.

Solutions to common problems

ProblemPossible Solution
Not all of the enabled actions are appearing in the PopClip bar.This is normal, because actions only appear when they are applicable. See: Why are some actions not appearing?
Actions appear, but are not working properly.This is a common problem just after upgrading macOS. Solution: Remove and re-add Accessibility permission.
Problem using PopClip in a specific app.Check the App compatibility section to see if there is a known problem with that specific app.
Check whether you have excluded the app from PopClip. See: Excluded Apps pane.
Try quitting and restarting that app, then quitting and restarting PopClip.
PopClip bar doesn't appear when selecting text, in any app.Check that PopClip is turned on. See: Turn PopClip On and Off.
Check that PopClip has Accessibility permission. See: Grant Accessibility permission.
Check whether you can still trigger PopClip using its keyboard shortcut. See: Activate with a keyboard shortcut.
Check whether you have customized your mouse pointer using an app like MouseScape or Cursor Pro. PopClip cannot appear automatically if you have a custom mouse pointer.
Check whether you have set custom keyboard shortcuts for Cut, Copy and Paste. PopClip can only work if your systemwide keyboard shortcuts are the standard ⌘X, ⌘C and ⌘V.
Check whether you are running both the Setapp and Standalone or Mac App Store editions at the same time. Only one edition should be installed at a time.
Check whether you are using the 3rd party macOS extension "Add to Fantastical" which comes with Fantastical. This is in System Settings → Privacy & Security → Extensions → Installed extensions. PopClip may behave unreliably if this is enabled.
Check that you are running the latest version of PopClip.
Try quitting and restarting PopClip.
Try rebooting your Mac.
Delay before PopClip bar appears.If "3-finger drag" mode is enabled in Trackpad settings, there will be a delay. This can't be avoided because the delay is inserted by macOS.
PopClip bar disappearing too quickly.PopClip does not disappear on a timer, but only when you move the mouse away, click, scroll, or begin to type. (See: Make popclip disappear.) Keep the mouse near the PopClip bar to prevent it disappearing.
A specific extension is not working.Try downloading the latest version of the extension. (Note that extensions do not autmatically update.)
PopClip app launches but no user interface appears.You may be using Bartender, Hidden Bar, or Vanilla or a similar app. Disable it or configure it not to hide PopClip.
PopClip has locked up / using 100% CPU.Force Quit PopClip using Activity Monitor. If this happens repeatedly, please report it and any steps that cause the lock-up.
A "click" or "purr" sound when selecting text.Check whether you are using either Alfred or LaunchBar, and have the clipboard merging feature enabled. The way PopClip works is triggering this feature, so you will need to disable it. The checkbox is "Fast append selected text" in Alfred and "Enable ClipMerge" in LaunchBar.
Can't set "Start at Login"Quit PopClip and move it to the /Applications folder. Then try again.

App compatibility

The following table lists apps that are known to have problems with PopClip.

AppIssueStatus
2DoPopClip will not work in this app.Can't fix
Adobe, all apps (Acrobat, Dreamweaver, Illustrator, InDesign, etc.)PopClip will not work in this app.Can't fix
AlacrittyPopClip will not work in this app.Can't fix
AnkiPopClip will not work in this app.Can't fix
Apple BooksPopClip will not work in this app.Can't fix
BanktivityPopClip will not work in this app.Can't fix
BartenderMay prevent PopClip's user interface appearing. Disable or configure Bartender as appropriate.Can't fix
Citrix ReceiverPopClip will not work in this app.Can't fix
CollectorzPopClip will not work in this app.Can't fix
CrossoverPopClip will not work in this app.Can't fix
Cursor ProUsing this app to change the mouse cursor will prevent PopClip working at all.Can't fix
emacsPopClip will not work in this app.Can't fix
FanstaticalPopClip may behave unreliably if the macOS extension "Add to Fantastical", which comes with Fantastical, is enabled. This is in System Settings → Privacy & Security → Extensions → Installed extensions.To be investigated
Final DraftPopClip will not work in this app.Can't fix
Hidden BarMay prevent PopClip's user interface appearing. Disable or configure Hidden Bar as appropriate.Can't fix
JetBrains, all apps (IntelliJ IDEA, PyCharm, WebStorm, etc.)PopClip will not appear automaticallty, but can be made to appear by using the keyboard shortcut or AppleScript trigger.Can't fix
KeePassXPopClip will not work in this app.Can't fix
Kindle for MacPopClip will not work in this app.Can't fix
MacVIMPopClip will not work in this app.Can't fix
Mail Perspectives 2PopClip will not work in this app.Can't fix
Microsoft WordIn Word, text may be copied to the clipboard if you press delete or start typing after selecting text. As a workaround, you can add Word to PopClip's excluded apps list and trigger PopClip with the keyboard shortcut.Can't fix
MouseScapeUsing this app to change the mouse cursor will prevent PopClip working at all.Can't fix
Mozilla FirefoxPopClip will fail with certain Firefox extensions installed. Ones know to cause problems are: Tiny Menu, Menu Wizard.Can't fix
NeoOffice suitePopClip will not work in this app.Can't fix
Oracle SQL DeveloperPopClip will not work in this app.Can't fix
Parallels DesktopPopClip will not work in this app.Can't fix
Pixelmator, Pixelmator ProPopClip will not work in this app.Can't fix
QuarkXPressPopClip will not work in this app.Can't fix
qutebrowserPopClip will not work in this app.Can't fix
Revolver OfficePopClip will not work in this app.Can't fix
ScreenPalPopClip will not work in this app.Can't fix
ScreensPopClip will not work in this app.Can't fix
Unity3DPopClip will not work in this app.Can't fix
VanillaMay prevent PopClip's user interface appearing. Disable or configure Vanilla as appropriate.Can't fix
vimPopClip will not work in this app.Can't fix
VMWarePopClip will not work in this app.Can't fix

Further information

Why are some actions not appearing?

Only Search and Copy are appearing! Is there something wrong?

To keep visual clutter down, PopClip's bar is intelligent; it only displays actions relevant to your current text selection and context. Here's a quick rundown:

  • Cut & Paste: They'll show up when you use PopClip in text-editing apps, like Mail or TextEdit. Don't expect them when selecting read-only text on webpages.

  • Open Link: Only visible when a URL is selected, e.g., https://apple.com/mac/.

  • Dictionary: Appears when a dictionary word is highlighted.

  • Reveal in Finder: This pops up for valid local file or folder paths, like ~/Documents/.

  • Spelling: For editable, misspelled words when there are correction suggestions in your set languages.

  • Extension-added actions: These also have specific conditions; they show up depending on their designed context.

If, after understanding the above, you believe an action should be visible but isn't, please provide details. Specify the action, the app you're in, and the exact text selected.

Remove and re-add Accessibility permission

The following procedure can help if PopClip is not working properly. It removes PopClip from the Accessibility permission list and then adds it again. It is most likely to be required after upgrading macOS from one version to another.

  1. Quit PopClip

  2. Go to System Settings → Privacy & Security → Accessibility

  3. In the list, highlight PopClip and then remove it using the "–" (minus) button. (Fully remove it, don't just uncheck it.)

Remove from the list with minus button
  1. Use the "+" (plus) button add PopClip again to the list.