KeyHue manual
KeyHue shows the input source your Mac is using as a thin colored line at the edge of the screen, so you can tell Korean from English (or Japanese, Russian, …) before you start typing.
Install
- Download
Get KeyHue.zip (always the latest version) and unzip it.
- Move it to Applications
Drag KeyHue.app into your Applications folder. KeyHue runs on macOS 13 Ventura or later, on Apple silicon and Intel.
- Allow it to open
KeyHue isn't signed with an Apple Developer ID, so macOS blocks the first launch.
- macOS 15 Sequoia or later: open KeyHue once. When macOS says it can't be opened, click Done. Then go to System Settings › Privacy & Security, scroll down and click Open Anyway.
- macOS 13–14: Control-click (or right-click) KeyHue.app, choose Open, then click Open in the dialog.
- Or run this in Terminal:
xattr -dr com.apple.quarantine /Applications/KeyHue.app
You only need to do this once per version.
First launch
KeyHue appears as a chameleon in the menu bar near the clock. The chameleon takes the color of the current input source. Click it, or open KeyHue again, to get to the settings. While the settings window is open, KeyHue also shows in the Dock so you can ⌘Tab back to it. To keep it in the Dock all the time, turn on Show in Dock in the settings.
A thin line appears along the bottom of every display. Switch input sources the way you usually do (Caps Lock, Control-Space or the 한/A key) and watch the line change color.
If you pressed the switch key and the color didn't change, the switch didn't happen. That's the point: KeyHue only shows what macOS actually selected.
Reading the colors
Every input source enabled in System Settings › Keyboard › Input Sources gets its own color. Until you choose your own, KeyHue uses these:
- Blue: ABC, U.S., German, Dvorak and other Latin layouts
- Green: Korean
- Orange: Japanese
- Purple: Chinese
- Teal: Russian and other Cyrillic layouts
- Red: Caps Lock is on. This wins over every input source color.
- Gray: ABC and the system 2-Set Korean while the KeyHue input method is integrated. They are only a step on the way to a KeyHue mode, so they look different from KeyHue English and Korean.
Other languages get their own color automatically, and it stays the same every time. Red is kept for Caps Lock.
HUD
With Show HUD on Change on, the chameleon appears briefly near the bottom of the screen in the new input source's color whenever you switch. It works the same way for every language. It appears the moment you switch and is gone about a quarter of a second later. If Switch to ABC on ESC is on, it also hides as soon as you start typing.

ABC 
Korean 
Japanese 
Caps Lock
The menu
Click the chameleon to open the menu. Items with a ✓ are turned on.
| Item | What it does |
|---|---|
| Current Input | The input source KeyHue sees right now, with its color. |
| Show State Bar | Shows or hides the colored line. |
| When Switching Apps | Keep As Is, Switch to ABC (your default input source), or Restore Last Input Source used in that app. |
| When Switching Windows in the Same App | The same three choices for windows and tabs of one app. Needs Accessibility. |
| Remember Each Window in 〈app〉 | Turns per-window memory on or off for the app you were using. Shown while When Switching Apps is set to restore (Choosing per app). |
| Switch to ABC on ESC | Switches to your default input source when you press ESC. Needs Input Monitoring. |
| Disable Word Fixing in 〈app〉 | Adds the app you were using to Apps That Are Never Changed. A ✓ means shortcut and automatic word fixing are off, and the fix shortcut goes to the app. Click again to remove the exclusion. Shown while input method integration and word fixing are on. |
| KeyHue Input Method ▸ | The input method's status and its one next step (install, update, or open input source settings), Keep KeyHue Korean/English Modes, pause, uninstall, and Input Method Settings…. |
| Settings… (⌘,) | Opens the settings window with every option. The line's look, colors, the HUD, the default input source, the text field option, Show in Dock, Launch at Login and the log file are there. |
| Check for Updates… | Checks GitHub and opens General settings to show the result. When a new version is available, this becomes Download New Version and opens that release page. |
The ABC in some item names changes to whatever you set as your default input source.
Settings
Choose Settings… in the menu, or press ⌘, while the menu is open.
General

- Language changes KeyHue's own language right away, without restarting. System Default follows macOS. Input source names still come from macOS in its language.
- Show in Dock is off by default, so KeyHue never takes focus away from your other apps. It still shows in the Dock while the settings window is open.
- Updates: shows your current version and the last successful check. Automatic checking is on by default and checks GitHub once a day. You can turn it off and still check manually. A new version opens its release page for download. Quit KeyHue and replace the app in Applications after downloading; updates are not installed automatically.
- Show Log File: reveals the log to attach when you report something odd.
Appearance

- Bar Position: bottom is the default. Top is easier to notice but covers the edge of the menu bar.
- Bar Thickness and Bar Opacity work well together, for example a thick line at 60% opacity.
- Displays: show the line on all displays, or only on the one you're working on.
- Hide macOS Input Source Indicator: hides the badge macOS shows next to the cursor when you switch input sources. This is a macOS setting that applies to all apps right away and stays after you remove KeyHue, so turn this off to bring the badge back.
Input Sources

- Click a color well to pick any color. Reset appears next to colors you changed.
- Default Input Source is where automatic switching goes. Set it to German, for example, if that's the layout you type commands in.
- Add or remove input sources in System Settings. The list here updates on its own.
Automation

Input Method

Switching back automatically
These options put the right input source back, so shortcuts and commands don't come out in the wrong language.
When you switch apps or windows
Pick one choice for When Switching Apps and one for When Switching Windows in the Same App:
- Keep As Is: KeyHue does nothing.
- Switch to ABC: always go back to your default input source.
- Restore Last Input Source: bring back what you last used there, so you can keep Korean in one Terminal window and English in another. Apps and windows KeyHue hasn't seen yet, like a new window from ⌘N, switch to ABC.
If both are set to restore, coming back from another app restores the front window first, then the app. App choices need no permission and apps are remembered across restarts. The window choices need Accessibility (System Settings › Privacy & Security › Accessibility). KeyHue watches only for the app's main window changing, so floating panels and dialogs don't count, and it never reads window titles or contents. Because of that, it can't recognize a window after the app or KeyHue restarts, so windows are remembered only until KeyHue quits.
Choosing per app
If you use a different language in each terminal tab but one language in all your chats, you can remember them differently. Set When Switching Apps to Restore Last Input Source and When Switching Windows in the Same App to Keep As Is, so every app is remembered as a whole. Then pick the apps that remember each window.
- Turn on: while using the app, choose Remember Each Window in 〈app〉 in the KeyHue menu. You can also use Add App… under Settings › Automation › Apps That Remember Each Window.
- Turn off: choose the same menu item again while using the app, or click Remove in the Settings list. Remove apps that aren't running or were deleted in Settings. The removed app's window memory is cleared right away.
Listed apps restore the last input source when you switch windows (tabs), and new windows and tabs start in ABC. Coming back from another app restores the front window too. Other apps follow When Switching Windows in the Same App. The list applies only while When Switching Apps restores, and isn't needed when When Switching Windows already restores every app. Apps with macOS tabs, like Ghostty, are remembered per tab. Split panes in one tab are one window and share one memory.
When you press ESC
Handy in Vim, VS Code and terminals. The first time you turn it on, KeyHue explains why it needs Input Monitoring and opens the system prompt.
- Go to System Settings › Privacy & Security › Input Monitoring.
- Turn on KeyHue.
- If the option still shows a dash (–) in the menu, quit and reopen KeyHue.
When you leave a text field (experimental)
Needs Accessibility (System Settings › Privacy & Security › Accessibility). It works in most native Mac apps. In Chrome and some Electron apps it may not.
When Korean and English are mixed up (experimental, for Korean input)
This option is for people who type Korean. It's shown only when both 2-Set Korean and a QWERTY English layout such as ABC are enabled (the two KeyHue input method modes also count), so you won't see it otherwise. When a word looks like it's meant for the other language, for example dkssud (안녕) typed in ABC or ㅗ디ㅣㅐ (hello) typed in Korean, KeyHue usually notices within the first 3–4 keys (dks → “안…?”) and otherwise when you finish the word with Space or Return. A small message near the bottom of the screen shows the word in that language (for example “안녕?”) for a moment, and the bar blinks a few times in that language's color. KeyHue doesn't change what you typed or switch the input source. Words you corrected with Delete, very short words, and words mixed with digits or symbols are skipped to avoid false alarms; if you delete a word typed in English back to its start, what you type next is checked as a new word. Needs Input Monitoring, like the ESC option. KeyHue reads only key positions, keeps the current word in memory, and discards it when the word ends. So that commands like dirname aren't mistaken for Korean, it also reads the file names in the system and Homebrew command folders. Turn off Show a Message to only blink the bar.
KeyHue input method (experimental)
If the fix shortcut conflicts with an app such as IntelliJ, open the menu while using that app and select Disable Word Fixing in 〈app〉. You can also add or remove apps in Settings › Input Method › Word Fixing › Apps That Are Never Changed. Excluded apps have both shortcut fixing and automatic fixing at Space turned off, and the fix shortcut goes to the app. Normal Korean and English input remains available.
The Korean/English input method is included in KeyHue.app and is off by default. Click Install and Use Input Method… below the status line in Settings › Input Method, or choose KeyHue Input Method ▸ Install and Use Input Method… in the menu. KeyHue switches to ABC, installs the service for your user account, verifies its signature and registers it with macOS. KeyHue does not add input sources for you. If both KeyHue modes are already added and usable, integration starts and the Korean mode is selected. Otherwise KeyHue shows that the input method is installed: use Open Input Source Settings and add both KeyHue – Korean (Experimental) (under Korean) and KeyHue – English (Experimental) (under English) in System Settings › Keyboard › Text Input › Edit with +. If the list for Korean or English is empty when the window first opens, choose another language once and then Korean or English again; System Settings sometimes doesn't draw the first list. The setup request stays on and integration starts automatically once both modes are enabled; you don't need to turn the option on again. macOS may ask you to allow a newly registered input source; that approval belongs to macOS and KeyHue cannot grant it for you. On macOS 26, KeyHue restarts itself after a successful install or update.
Korean underlines only the current syllable; English is typed as is, without an underline, so Return runs a terminal command on the first press. macOS automatic capitalization then applies to the first word of a sentence; turning off Capitalize words automatically (Keyboard › Text Input › Edit…) keeps the fix shortcut from reading a capital you didn't type. Hanja conversion is not available. Two-mode routing observes source changes from ⌘Space, Caps Lock, Control Space, Fn and the menu without changing your shortcuts. ABC or the system 2-Set Korean chosen from a KeyHue mode is redirected to the other KeyHue mode and shown in gray; other languages stay selected. After the lock screen or a password field selects ABC, KeyHue puts both KeyHue modes back in front of it, so ⌘Space toggles them directly. Manage › Pause Integration and Switch to ABC leaves the pair without removing files. Your saved default source is kept. While integration is on, ABC and 2-Set Korean remembered for an app or window, or saved as the default, are read as the matching KeyHue mode; when it's off or a mode is removed, remembered KeyHue modes are read as 2-Set Korean and ABC again if those are enabled. Very fast switching and first-key timing remain experimental and should be tested in your apps.
Word fixing: while you use the KeyHue input method, press a shortcut (⌥↩ by default) to fix text typed in the wrong input mode. KeyHue converts the selection, or the word right before the cursor, to the other language (dkssud → 안녕, ㅗ디ㅣㅐ → hello) and switches the input mode; press the shortcut again right away to undo. In Settings › Input Method › Word Fixing you can turn it off, change the shortcut, also fix automatically at Space, and choose apps that are never changed. Automatic fixing only fixes Korean typed in English mode, and never runs in terminals so that commands aren't changed; use the shortcut there. In terminals, KeyHue erases the word you just typed with Delete keys and types the fix. KeyHue sends those keys, so it must be running and needs Accessibility access; the input method needs no permission of its own. Terminal fixing has been checked in Ghostty; other terminals such as Terminal are not checked yet. A terminal does not tell the input method what is selected, so text selected with Shift+arrows in a terminal is not changed and KeyHue tells you why. Clear the selection and press the shortcut right after the word. Password fields are never changed.
Installation is at ~/Library/Input Methods/KeyHueInputMethodSpike.app; the internal name stays compatible with previous experiments. KeyHue quitting leaves basic input available, while automatic integration stops. To remove it, first remove both KeyHue modes in System Settings › Keyboard › Text Input › Edit, then use Manage › Uninstall Input Method in Settings › Input Method. If a mode is still listed, KeyHue asks you to remove it, with a button that opens the settings, and keeps the files. On macOS 26, System Settings sometimes keeps the last mode you remove: it disappears from the list, but macOS keeps it. If KeyHue still says a mode is listed after you removed both, choose Remove Anyway. KeyHue then turns off its own entries, stops the service and deletes only its installed copy; it never edits other input methods or KeyHue settings. What macOS kept does nothing without the input method (see Removing what macOS keeps). On macOS 26, KeyHue restarts itself afterward. If an already open Keyboard settings window shows stale entries, close and reopen it.
If setup still reports a problem, inspect ~/Library/Logs/KeyHue/KeyHue.log for catalog, registration and mode availability, and ~/Library/Logs/KeyHue/KeyHueInputMethod.log for IMK server sessions and mode callbacks. Moments when the switch was pressed again and again, or a session repair ran while you typed, are marked [Suspect], and display lines say which screen the bar and HUD showed and in what color. These logs do not include typed text or key codes.
Update and uninstall
To update, quit KeyHue from its menu, download the latest version, and replace KeyHue.app in Applications. Your settings stay. If you use the experimental input method, choose Update and Use Input Method… after replacing KeyHue; replacing the app alone does not update the installed service. If you use the ESC or text field options, you may need to allow the permission again after updating.
To uninstall, first choose Uninstall Input Method if it is installed, then quit KeyHue, turn off Launch at Login, and move KeyHue.app to the Trash. To also remove its settings, run defaults delete io.github.sejoung.keyhue in Terminal and remove KeyHue from Input Monitoring and Accessibility in System Settings.
Removing what macOS keeps
After Remove Anyway, macOS may keep KeyHue Korean or English in its input source list. Without the input method it doesn't appear anywhere and does nothing. If you install the input method again, it comes back as an added mode and KeyHue asks only for the other one. KeyHue can't remove it: only an app with Full Disk Access can change that list, and KeyHue doesn't ask for it. To remove it yourself, allow Terminal in System Settings › Privacy & Security › Full Disk Access, run this in Terminal, then log out and back in. It removes only KeyHue's entries; other input methods stay. You can turn Full Disk Access for Terminal off again afterward.
f=$(mktemp) && defaults export com.apple.inputsources "$f" && k=AppleEnabledThirdPartyInputSources && i=$(( $(plutil -extract $k raw "$f") - 1 )) && while [ $i -ge 0 ]; do [ "$(plutil -extract "$k.$i.Bundle ID" raw "$f")" = io.github.sejoung.keyhue.inputmethod.spike ] && plutil -remove "$k.$i" "$f"; i=$((i-1)); done; defaults import com.apple.inputsources "$f"
Troubleshooting
I can't see the chameleon in the menu bar
On MacBooks with a notch, menu bar icons can hide behind it when there are many. Quit a few menu bar apps, or hold ⌘ and drag icons to rearrange them. On macOS 26 or later, also check System Settings › Menu Bar. Even when the icon is hidden, opening KeyHue again from Spotlight or the Applications folder shows the settings window.
The color doesn't change when I switch
KeyHue follows the input source macOS reports. Some input methods switch modes inside themselves without changing the input source (for example Shift in some Chinese input methods), and KeyHue can't see those.
ESC doesn't switch anymore after an update
macOS ties Input Monitoring to the app's signature, and each KeyHue update has a new one, so the earlier approval stops applying even if System Settings still shows KeyHue turned on. KeyHue tells you when this happens. Choose Allow Again… (or Grant Input Monitoring Access… in the menu), then turn on KeyHue in System Settings › Privacy & Security › Input Monitoring. The same applies to Accessibility for the text field option.
Shift, Option or Ctrl+arrow keys type A to D in a terminal
A terminal sends an arrow key pressed with a modifier as a sequence such as ESC[1;2A (Shift+↑), ESC[1;3D (Option+←) or ESC[1;5C (Ctrl+→). zsh has no binding for these keys, so the final A to D is typed, sometimes with a digit as in 2A or 3D. It happens with ABC as well, not only with the KeyHue input method. Run cat -v in a terminal and press the key to see what the terminal sends.
To select text with Shift+arrows in the shell too, install the zsh plugin zsh-shift-select (GitHub jirutka/zsh-shift-select). With oh-my-zsh, run git clone https://github.com/jirutka/zsh-shift-select ~/.oh-my-zsh/custom/plugins/zsh-shift-select in Terminal, add zsh-shift-select to plugins=(...) in ~/.zshrc, and open a new terminal. If you only want the letters gone and don't need selection, add these lines to ~/.zshrc:
bindkey '^[[1;2D' backward-char # Shift+←
bindkey '^[[1;2C' forward-char # Shift+→
bindkey '^[[1;2A' up-line-or-history # Shift+↑
bindkey '^[[1;2B' down-line-or-history # Shift+↓
To move by word with Option or Ctrl+←/→, add these. macOS uses Ctrl+arrow keys for Mission Control and switching desktops first, so they reach the terminal only if you turn those shortcuts off in System Settings › Keyboard › Keyboard Shortcuts › Mission Control.
bindkey '^[[1;3D' backward-word # Option+←
bindkey '^[[1;3C' forward-word # Option+→
bindkey '^[[1;5D' backward-word # Ctrl+←
bindkey '^[[1;5C' forward-word # Ctrl+→
Save the file and open a new terminal.
In Ghostty, Tab or an arrow key needs a second press while typing Korean
Ghostty drops the syllable being composed when Tab, an arrow key, Home, End, Page Up/Down or forward Delete arrives during Korean composition. To keep the syllable, the KeyHue input method uses that key only to finish composing, so the syllable stays and you press the key once more. Return and Esc need a second press during composition in Ghostty for the same reason. Without composition, or in English mode, one press works, and ⌘, ⌃ and ⌥ shortcuts such as ⌃C always go through.
macOS says KeyHue is damaged or can't be checked
That's the first-launch block for apps without an Apple Developer ID. Follow step 3 in Install.
I want to report something odd
Choose Show Log File in Settings › General to reveal ~/Library/Logs/KeyHue/KeyHue.log in Finder. Attach it to a problem report along with roughly when it happened. It records the version, settings and permissions at launch, plus app and window switches, input source changes and automatic switches with timestamps, which helps find the cause.
Privacy
KeyHue never records what you type. It reads the selected input source, Caps Lock state and the active app. With the optional features on, it also checks whether a key is ESC, and what kind of element is in focus. It never reads the text. The experimental Korean/English mix-up warning looks at the key positions of the word you're typing, keeps that word in memory only until it ends, and never stores or logs it. The optional KeyHue input method composes only input delivered to its client session in memory; it never saves, logs or sends the text. Word fixing reads the selection or the word before the cursor when you press the shortcut (in terminals, the keys the input method just received) and discards it after the fix. Only if you turn on Record Undone Fixes (off by default, automatic fixing) does KeyHue keep fixes you undid (the typed word, the fix and the app) on this Mac, up to 50; turning it off deletes them. Two-mode routing observes source changes and typing timing without reading document text. The log file for troubleshooting (~/Library/Logs/KeyHue/, at most 3 MB) records app bundle IDs and input source switches, but never what you type or window titles, and it is never sent anywhere. KeyHue contacts GitHub only to check public releases, automatically once a day or when you choose Check for Updates. Automatic checking can be turned off in Settings › General. It sends no typing, app activity or logs and has no analytics, and the source code is open under the MIT License. The Korean syllable model for the Korean/English mix-up warning is derived from Korean Wikipedia (CC BY-SA 4.0).