HELP AND PRIVACY
A few answers before you start.
Nothing happens when I press right ⌘ + a letter
Check the menu bar ⌘ icon. Gray means access is missing or the app is paused. Open Settings and use Open Accessibility Settings… if prompted. You can also run initials status in Terminal and check whether intercepting is yes.
It stopped working after an update
macOS may invalidate an older permission. In the Accessibility list, toggle Initials off and back on. If needed, remove it with the minus button and add it again.
Double-tap is too sensitive, or does not trigger
By default, each tap and the gap between taps must be under 0.3 seconds. Disable double-tap in the Left Command settings if you do not need it, or run initials tap off --side left.
Can it conflict with Hammerspoon rcmd?
Both tools may handle the same key. Once you have checked Initials, use Turn off Hammerspoon rcmd in Settings so only one handles the shortcut. Use the same button to restore it later.
Does switching input methods change the letters?
Initials uses physical key codes for the letter mapping, independently of the active input method. Non-QWERTY layouts may differ from the printed letters on your keyboard.
Can I let the current app receive the shortcut?
Right Command with Shift, Option or Control passes through. To disable right Command entirely, run initials disable right.
Will enabling left Command affect ⌘C and ⌘V?
Left Command hold only takes assigned letters; other shortcuts keep working. Left and right share a table by default. If that table includes C, V or W, Settings and initials list flag the conflicts. Turn off the shared-table option and assign a few less-used letters on the left.
Does it support Intel Macs, Windows or Linux?
The current download supports Apple Silicon Macs running macOS 14 or later. There is no Intel, Windows or Linux download.
Is it free? Does it need an account or the internet?
Initials is free, with MIT-licensed source. App switching works without an account or network and records no input. Optional iCloud Drive sync uses your Apple ID and only shares app choices and shortcut settings, with no developer server. Turn it off in Settings. Downloads and this website require a network.
How do I restore settings on a new Mac?
Use the same Apple ID, enable iCloud Drive and choose sync in Initials Settings on both Macs. Settings are stored in Initials/config.json in iCloud Drive, with transfers handled by macOS; app switching keeps using the local copy. You can also export on the old Mac and import on the new one. Accessibility and Open at Login are configured separately.
How do I update the app?
Choose Check for Updates… from the menu bar or Settings. When a new release is available, upgrade in the window. The package, app identity and developer signature are verified; settings are kept and a failed replacement rolls back.
Does this website track my use?
This page has no third-party tracking scripts or analytics cookies. The server keeps normal access logs and aggregates page and download requests for operations and promotion evaluation. These aggregates do not identify people across sessions or track activity inside the app.
How can I report a problem?
Use GitHub Issues · Feedback to report your macOS version, Initials version, relevant settings and reproduction steps. Please do not include private typed text or your complete personal configuration.