Tweaks

Tweaks are extra settings that don't appear in PopClip's settings window. They are for fine-tuning, experiments and troubleshooting. You can change them with the defaults command in Terminal.

Settings that are currently tweaks could become main options in the future. If you find a setting is particularly useful for you, please let me know! Your feedback always shapes the app.

Changing a tweak

To change a tweak, run its defaults write command in Terminal. For example:

defaults write com.pilotmoon.popclip ScreenshotMode -bool YES

To put a tweak back to its default, delete it:

defaults delete com.pilotmoon.popclip ScreenshotMode

Most tweaks take effect straight away. Those marked Restart need you to quit and restart PopClip.

General

Fine-tune how PopClip and its bar behave.

KeepPastedTextOnClipboard

Turn this off to put the previous clipboard contents back after a paste action. An extension can still choose for itself with the restore option.

Yes/no · Default: YES

defaults write com.pilotmoon.popclip KeepPastedTextOnClipboard -bool NO

CopyOnSearch

Search actions also copy the selected text. An extension can still choose for itself with the copy option.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip CopyOnSearch -bool YES

CopyOnShow

When a PopClip action shows text, it also copies it.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip CopyOnShow -bool YES

NewTabsAtEnd

When a link opens in the current browser, the new tab goes at the end of the tab bar instead of to the right of the current tab.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip NewTabsAtEnd -bool YES

AlwaysRespectPositionSetting

The bar always appears above or below the selection as set in Appearance, whichever way you dragged to select.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip AlwaysRespectPositionSetting -bool YES

IgnoreAutoSelect

PopClip doesn't appear when a single click into a field selects its contents, such as a browser address bar.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip IgnoreAutoSelect -bool YES

PopupDismissDistance

How far the pointer can move away from the bar before it starts to dismiss.

Number · Default: 40 pt · Range: 0 pt to 400 pt

defaults write com.pilotmoon.popclip PopupDismissDistance -float <number>

PopupDismissTime

How long the bar waits to dismiss once the pointer is beyond the dismiss distance.

Number · Default: 0.5 s · Range: 0 s to 10 s

defaults write com.pilotmoon.popclip PopupDismissTime -float <number>

PopupWidthFactor

The widest the bar can be, as a fraction of the screen width.

Number · Default: 0.95 · Range: 0.1 to 1

defaults write com.pilotmoon.popclip PopupWidthFactor -float <number>

PopupMaxWidth

The widest the bar can be, in points. 0 means no limit.

Number · Default: 1350 pt · Range: 0 pt to 10000 pt

defaults write com.pilotmoon.popclip PopupMaxWidth -float <number>

PopupRevealContextMenuOnHover

Context-style submenus open when the pointer rests on them, not only on click.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip PopupRevealContextMenuOnHover -bool YES

ClassicStatusIcon

Use the original menu bar icon.

Yes/no · Default: NO · Restart

defaults write com.pilotmoon.popclip ClassicStatusIcon -bool YES

DisableToolTips

Don't show tooltips when hovering over the bar's buttons.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableToolTips -bool YES

ScreenshotMode

Key presses don't dismiss the bar, so screenshot shortcuts can capture it.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip ScreenshotMode -bool YES

Experiments

Behaviors that are still being tried out. They may change or go away.

EnableSettableDetection

Hide Cut and Paste when Accessibility reports that a field isn't editable. Off by default because some apps report it wrongly.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip EnableSettableDetection -bool YES

Troubleshooting

Turn off or change parts of PopClip to work around a problem. Usually you'd change these only when support asks.

DeepCapture

Grab the rich clipboard copy even when Accessibility already returned the text. Try this if actions lose formatting in a particular app.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DeepCapture -bool YES

DisableTargetedKeys

Send synthetic key presses through the session event tap instead of directly to the app being acted on.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableTargetedKeys -bool YES

DisableBrowserProcessTargeting

Address browsers by bundle ID only, without telling apart several running copies of the same browser by process.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableBrowserProcessTargeting -bool YES

DisableBrowserTabScripts

Open links the standard way, without using AppleScript to place the new tab.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableBrowserTabScripts -bool YES

DisableBrowserInfoCapture

Don't fetch the current browser page's URL and title for actions.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableBrowserInfoCapture -bool YES

DisableInitialDisplay

Always open the bar at the top level, ignoring submenus that ask to open straight away.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableInitialDisplay -bool YES

DisableScriptRunnerXPC

Run AppleScript actions inside PopClip instead of in the separate, cancellable script runner.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableScriptRunnerXPC -bool YES

DisableIconCache

Render icons fresh every time instead of using the memory and disk caches.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableIconCache -bool YES

DisableEntitlementSniff

Don't scan JavaScript for APIs that need an entitlement. This only affects diagnostics.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip DisableEntitlementSniff -bool YES

NoLoginShell

Shell script actions run in a plain shell, so profile files such as .zprofile aren't read.

Yes/no · Default: NO

defaults write com.pilotmoon.popclip NoLoginShell -bool YES