Installation

Installation

Builds are published on the Releases page. Each release ships three installers (plus latest.json, which the in-app updater polls — you never download that one by hand).

The installers are currently unsigned. That is why Windows SmartScreen and macOS Gatekeeper warn on first launch — the workarounds below are expected, not a sign something is wrong. Code signing is planned.

Windows 10 / 11

1. Download poltertype-<ver>-x86_64-pc-windows-msvc.msi.
2. Double-click. It is a per-user install — no admin rights, no UAC prompt.
3. If SmartScreen shows "Windows protected your PC" → More info → Run anyway.

macOS 11+ (Intel & Apple Silicon)

1. Download poltertype-<ver>-universal-apple-darwin.dmg.
2. Open the DMG, drag poltertype.app into /Applications.
3. First launch: right-click the app → Open (or run xattr -dr com.apple.quarantine /Applications/poltertype.app).
4. Grant Accessibility and Input Monitoring when macOS asks — details in macOS-Setup.

Validated on real hardware on macOS 15 (Intel); Apple Silicon runs the same universal binary but has not been validated end-to-end yet — reports welcome.

Linux (x86_64)

1. Download poltertype-<ver>-x86_64.AppImage.
2. chmod +x and run. Per-user, no system install.
3. Wayland needs a one-time setup script (evdev/uinput access); X11 needs nothing at all — see Linux-Setup.

Staying up to date

You install once. From then on PolterType checks GitHub for new releases daily, downloads your platform's installer in the background, verifies its SHA-256, and waits — the swap happens when you quit or click ⟳ Restart to update in the tray. It sends no account, no identifier, nothing about you or your typing; one checkbox on the Settings → General pane turns the whole mechanism off. Full details and caveats in the README.

Building from source

git clone https://github.com/Just-Code-NET/PolterType.git
cd PolterType
cargo run -p poltertype-app

The per-OS native dependency checklist is in CONTRIBUTING.md.