/keycastr

KeyCastr, an open-source keystroke visualizer

Primary LanguageObjective-CBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Keycastr

KeyCastr, an open-source keystroke visualizer.

preview

display preferences

Download

Installation via homebrew cask

brew install --cask keycastr

Enabling Accessibility API Access

KeyCastr requires access to the macOS Accessibility API in order to receive your key events and broadcast the keystrokes you are interested in.

On newer versions of macOS (10.15+) there is a new Input Monitoring menu under Security & Privacy within the System Preferences app, and KeyCastr will appear there automatically the first time you run it. Simply unlock this menu and check the box next to KeyCastr to enable it.

input_monitoring

On older versions of macOS, or if for some reason the app doesn't appear under the Input Monitoring menu (or if you want to pre-enable it) then you may manually add it to the list of apps in the Accessibility menu.

accessibility

To add KeyCastr to the list click the + button and select KeyCastr from the file system.

If KeyCastr is already in the list, then click the button and add KeyCastr again to be certain that the right application is chosen.

Displaying All Keystrokes

Make sure to check the "Display all keystrokes" checkbox if you would like to display more than just the modifier keys.

Alternatively, keep this box unchecked to only display modifier keys (e.g. ⇧ ⌃ ⌥ ⌘)

display_all_keystrokes

Position on Screen

The default position is on the bottom left of your display. To modify the position of displayed keystrokes, click and drag the text like so:

reposition

History

  • sdeken wrote the original version.
  • akitchen fixes for more recent OS X releases and other maintenance.
  • elia created keycastr organization and forked into it.
  • lqez added a new menu bar icon.

License

BSD 3-Clause