macOS

KeySteer supports macOS 14 and later. Move KeySteer.app to your Applications folder.

Install from a GitHub Release

Download the ZIP for your architecture from the official GitHub Releases, extract it, and move KeySteer.app to /Applications. If Gatekeeper prevents it from opening, first confirm the download source, then run:

sudo xattr -cr /Applications/KeySteer.app

First-time permissions

1. Before opening KeySteer.app, go to System Settings → Privacy & Security → Accessibility.
2. Allow KeySteer to control your computer.
3. Restart KeySteer and test it with Primary+E.

Vision detection in UI Hint also needs Screen Recording permission. Grid and Recursive Grid do not inspect screen contents, but keyboard capture still needs Accessibility permission. Grant both permissions up front to avoid later interruptions.

File locations

The packaged app uses:

~/Library/Application Support/KeySteer/

It contains:

• keysteer.<name>.toml: configuration files.
• keysteer.log: runtime log.
• keysteer.log.1, .2, .3: rotated logs.

Scroll direction

When you use natural scrolling, vertical inversion is enabled by default. Adjust it in the configuration if needed:

[platform.macos.scroll]
invert_horizontal = false
invert_vertical = true

Permission problems

If the top status icon appears but keys do nothing:

1. Check that the Accessibility list authorises KeySteer.app.
2. Quit and reopen KeySteer.
3. Run keysteer --doctor to check whether the keyboard is available.
4. If it persists, inspect keysteer.log in the data directory.

Because future builds may not have a stable Developer ID signature, upgrades can require you to grant permission again.

Top status icon

Direct and login launches create one KeySteer status icon at the right side of the top bar after AppKit finishes launching. Click it to open the controls for pausing, reloading configuration, checking for updates, and quitting. KeySteer does not create a regular application main menu or Dock icon.