KittyKit installation guide

v0.7.4 · macOS 13 or later · Intel / Apple silicon

This app is notarized by Apple, so it opens without an “unidentified developer” warning. Because it was downloaded from the internet, if macOS asks once whether you want to open it, click Open.

Install

1. Open KittyKit_0-7-4.dmg and drag KittyKit to Applications.
2. Eject the DMG.

First launch

1. Open KittyKit from Applications.
2. If a “downloaded from the internet” confirmation appears, click Open.
3. When KittyKit appears in the menu bar, the installation is done.

Enter a free code (Pro free for life · limited-time offer)

1. Copy the free code (KKB-XXXX-XXXX-XXXX) you received by email or message.
2. In KittyKit Settings → the Get Pro tab, paste it into the key field (“Bought Pro or have a free code? Enter your key”) and click Activate.
3. When it changes to Free code in use · Pro free for life, you're done. You need an internet connection to activate, and once activated it stays active without one.

A code is tied to one Mac and can't be moved to another Mac. Deleting and reinstalling the app on the same Mac is fine. If you don't have a code, request one at support@kittyland.net. Even without a code, you can try every Pro feature first with Try Pro free for 7 days in Settings.

Allow permissions

KittyKit needs both of the permissions below to detect key presses. A guide appears on first launch. What you type is never stored or sent.

• Input Monitoring: always needed (rules for a lone key such as Right ⌘). Open now
• Accessibility: In newer versions of macOS it may appear as “Device Control & Data Access”. needed for combination-key rules such as ⇧ + Space, for Windows shortcuts, and for Pro features such as window layout, focus screen and separate scroll direction. Combination-key rules need both Input Monitoring and Accessibility turned on. Open now

In System Settings → Privacy & Security, turn on KittyKit for both items. This is the item inside “Privacy & Security”, not the separate “Accessibility” section (assistive features) in the System Settings sidebar.

KittyIME (input method)

Install and turn it on in one step from KittyKit Settings. “KittyIME” is added under System Settings → Keyboard → Input Sources. If it doesn't turn on by itself, add it by hand in the same place. What you type is never stored or sent.

To use Japanese retyping, the KittyIME app itself also needs both Accessibility and Input Monitoring. Turn them on separately from KittyKit's own permissions.

Updating to a new version

Before overwriting KittyKit in Applications with the one from the new DMG, quit it from the KittyKit menu in the menu bar. If a build's signature has changed, permissions may be reset. If so, remove KittyKit in System Settings with − and allow it again.

If something goes wrong

• If pressing the switch key does nothing, check the status line in the KittyKit menu bar menu (it shows when a permission is needed).
• If you use it together with other key-remapping apps (Karabiner and the like) or a virtual machine (Parallels and the like), please let us know.
• Please don't include what you typed in feedback. Your keyboard, the input source pair and your macOS version are enough.