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 ⚠ Setup Guide 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 hardware: listener, layout switching, corrections — including the PC ("Win") input-source variants (RussianWin, UkrainianWin, ABC).
• Apple Silicon: same universal binary, not yet validated by a human — testing checklist here.
• The self-updater's .app-bundle swap has never run on real hardware — treat macOS self-updating as untested rather than broken.
• The per-app skip list and profiles do nothing on macOS yet (no focus tracker), and the suggestions tooltip has no overlay backend there.