A macOS menu bar utility that automatically corrects keyboard layout mistakes. Type in the wrong layout (e.g., English instead of Ukrainian/Russian) and SwitchFix detects it, deletes the mistyped word, switches the layout, and retypes the correct text — like PuntoSwitcher, but native, lightweight, and modern.
- Automatic correction — detects wrong-layout words on space/enter and corrects them instantly.
- Hotkey mode — correct only when you press Ctrl+Shift+Space (configurable).
- Selection correction — select text and press the hotkey to convert it.
- Permissions indicator — shows the status of required macOS permissions in the app menu.
- Undo —
Cmd+Zwithin 5 seconds reverts the last correction. - Revert hotkey —
CapsLockreverts the last correction (configurable). - Three layouts — English (US/ABC/British/Dvorak/Colemak), Ukrainian, and Russian.
- Smart filtering — skips password fields, URLs, emails, camelCase, mixed scripts.
- App blacklist — disabled in terminals, IDEs, and code editors by default (toggle per app).
- Launch at Login — optional auto-start.
- macOS 13.0 or later
The easiest way to install and set up SwitchFix is using the automated install script. It builds the app, installs it to your Applications folder, sets it to run at startup, and guides you through the necessary macOS privacy permissions.
- Download or clone this repository to your Mac.
- Open your Terminal and navigate to the SwitchFix folder.
- Run the setup script:
./install.sh- Follow the interactive prompts to grant the required Accessibility and Input Monitoring permissions.
Note: If you don't have Apple's Command Line Tools installed, the script will prompt you to install them first. Just follow the macOS prompts and re-run
./install.shwhen it finishes.
You can also download a pre-compiled .dmg version from the Releases page.
- Open the downloaded
.dmgfile. - Double-click the
Install SwitchFixscript inside. - A terminal will open to securely copy the app to your Applications folder, bypass Apple's "App is damaged" quarantine warning for unsigned apps, and interactively guide you through granting the necessary macOS privacy permissions.
SwitchFix lives in your menu bar with an Ab icon. The menu provides:
- Enable/Disable toggle
- Correction Mode — Automatic or Hotkey Only
- Permissions Status — visually indicates if required permissions are granted
- Installed Layouts — shows all detected system layouts
- Launch at Login — toggle automatic startup
SwitchFix stores hotkeys in UserDefaults. You can customize them via Terminal if you prefer advanced bindings:
# Set revert hotkey to CapsLock (no modifiers)
defaults write com.switchfix.app SwitchFix_revertHotkeyKeyCode -int 57
defaults write com.switchfix.app SwitchFix_revertHotkeyModifiers -int 0
# Set correction hotkey to Ctrl+Shift+Space
defaults write com.switchfix.app SwitchFix_hotkeyKeyCode -int 49
defaults write com.switchfix.app SwitchFix_hotkeyModifiers -int $((262144+131072))- KeyboardMonitor securely captures keystrokes without blocking them.
- Characters accumulate in a short-lived LayoutDetector word buffer.
- On a word boundary (space, enter, tab), the buffer is checked against alternative layout dictionaries (e.g. checking if an English typo forms a valid Ukrainian word).
- If a valid word is found in another layout, TextCorrector safely deletes the mistyped characters, switches your input layout, and retypes the correct word.
MIT