macOS Setup

macOS setup

PolterType needs two permissions, and macOS prompts for both on first run:

1. Accessibility — to observe and inject keystrokes.
2. Input Monitoring — to read the key stream.

Both live in System Settings → Privacy & Security. If you denied a prompt, toggle poltertype.app on there and restart the app. If the hooks fail to start, the tray shows a ⚠ Keyboard hooks unavailable — Setup… entry pointing at the docs.

Gatekeeper on first launch

The app is currently unsigned, so a plain double-click is blocked. Either right-click → Open once, or:

xattr -dr com.apple.quarantine /Applications/poltertype.app

Hotkey differences on macOS

The pause hotkey defaults to Ctrl+Shift+P (not Ctrl+Shift+Space): Ctrl(+Shift)+Space is macOS's own "select input source" shortcut, and claiming it would take your layout switching away — the very thing PolterType complements. Bind whatever you like on the Hotkeys pane; an explicit binding is honoured as written.

Honest status

• Validated end-to-end on macOS 15, Intel: listener, layout switching, corrections — including the PC ("Win") input-source variants (RussianWin, UkrainianWin, ABC).
• Apple Silicon: reported at 0.19.0 on an M1 Pro (macOS 26) — first launch, detection, corrections, the force-switch hotkey and the self-update, the .app-bundle swap included (#3).
• The focus tracker and the suggestions tooltip both landed in 0.15.0, so the per-app skip list, wordlist profiles and the tooltip all work here.
• Still unmeasured: a correction typed under a held modifier — the ⌘⌫ case. If something looks wrong there, please say so in #3.