KeyHue

KeyHue 사용 설명서

KeyHue는 지금 Mac이 쓰고 있는 입력 소스를 화면 가장자리의 얇은 색 선으로 보여줍니다. 타이핑하기 전에 한글인지 영문인지(또는 일본어, 러시아어…) 알 수 있습니다.

설치

  1. 내려받기

    KeyHue.zip(항상 최신 버전)을 받아 압축을 풉니다.

  2. 응용 프로그램 폴더로 옮기기

    KeyHue.app을 응용 프로그램 폴더로 끌어다 놓습니다. macOS 13 Ventura 이상, Apple silicon과 Intel에서 동작합니다.

  3. 실행 허용하기

    KeyHue는 Apple Developer ID 서명이 없어서, 처음 실행할 때 macOS가 막습니다.

    • macOS 15 Sequoia 이상: KeyHue를 한 번 엽니다. 열 수 없다는 안내가 나오면 완료를 누릅니다. 그다음 시스템 설정 › 개인정보 보호 및 보안에서 아래로 내려 그래도 열기를 누릅니다.
    • macOS 13–14: KeyHue.app을 Control-클릭(또는 우클릭)해 열기를 고르고, 대화상자에서 한 번 더 열기를 누릅니다.
    • 또는 터미널에서: xattr -dr com.apple.quarantine /Applications/KeyHue.app

    버전마다 한 번만 하면 됩니다.

처음 실행

KeyHue는 메뉴바 시계 근처의 카멜레온으로 나타납니다. 카멜레온은 현재 입력 소스의 색을 띱니다. 카멜레온을 누르거나 KeyHue를 다시 실행하면 설정을 열 수 있습니다. 설정 창이 열려 있는 동안에는 Dock에도 보여 ⌘Tab으로 돌아올 수 있습니다. 늘 Dock에 두고 싶다면 설정의 Dock에 표시를 켜세요.

모든 모니터의 아래쪽 가장자리에 얇은 선이 나타납니다. 평소처럼 입력 소스를 바꿔 보세요(한/A 키, Caps Lock, Control-Space). 선의 색이 바뀝니다.

한/영 키를 눌렀는데 색이 그대로라면 실제로는 전환되지 않은 것입니다. KeyHue는 macOS가 실제로 선택한 입력 소스만 보여줍니다.

색 읽는 법

시스템 설정 › 키보드 › 입력 소스에서 켜 둔 입력 소스마다 색이 있습니다. 직접 고르기 전까지는 이 색을 씁니다.

그 밖의 언어에도 자동으로 색이 정해지고, 매번 같은 색이 나옵니다. 빨강은 Caps Lock 전용입니다.

HUD

전환 시 HUD 표시를 켜면, 입력 소스를 바꿀 때마다 화면 아래쪽에 카멜레온이 새 입력 소스의 색으로 잠깐 나타납니다. 어떤 언어든 같은 방식입니다. 전환하는 순간 바로 나타나 0.25초쯤 뒤에 사라집니다. ESC를 누르면 ABC(으)로 전환을 켜 두면 타이핑을 시작하는 즉시 숨기도 합니다.

카멜레온을 누르면 메뉴가 열립니다. ✓ 표시가 있는 항목은 켜져 있는 것입니다.

항목하는 일
현재 입력KeyHue가 지금 보고 있는 입력 소스와 그 색.
상태 바 표시색 선을 보이거나 숨깁니다.
앱을 바꿀 때그대로 두기, ABC(으)로 전환(기본 입력 소스), 마지막 입력 소스로 복원 중 하나를 고릅니다.
같은 앱에서 창을 바꿀 때같은 앱의 창과 탭에 대해 같은 세 가지 중 하나를 고릅니다. 손쉬운 사용 권한이 필요합니다.
〈앱〉에서 창마다 기억지금 쓰던 앱만 창(탭)마다 기억하게 켜거나 끕니다. 앱을 바꿀 때가 복원일 때 보입니다(앱마다 기억 단위 고르기).
ESC를 누르면 ABC(으)로 전환ESC를 누르면 기본 입력 소스로 바꿉니다. 입력 모니터링 권한이 필요합니다.
〈앱〉에서 단어 고침 끄기지금 쓰던 앱을 고치지 않는 앱에 추가합니다. ✓가 있으면 단축키 고침과 자동 고침이 꺼지고 고침 단축키는 앱에 그대로 전달됩니다. 다시 누르면 제외를 해제합니다. KeyHue 입력기 연동과 단어 고침이 켜져 있을 때 보입니다.
KeyHue 입력기 ▸입력기 상태와 다음에 할 일 하나(설치, 업데이트, 입력 소스 설정 열기), 한/영 모드 유지, 연동 끄기, 제거, 입력기 설정….
설정… (⌘,)모든 옵션이 있는 설정 창을 엽니다. 막대 모양, 색, HUD, 기본 입력 소스, 텍스트 필드 옵션, Dock 표시, 로그인 시 실행, 로그 파일은 설정 창에 있습니다.
업데이트 확인…GitHub에서 확인하고 일반 설정에 결과를 보여줍니다. 새 버전이 있으면 새 버전 다운로드로 바뀌며 해당 릴리즈 페이지를 엽니다.

일부 항목 이름의 ABC는 기본 입력 소스로 지정한 이름으로 바뀝니다.

설정

메뉴에서 설정…을 고르거나, 메뉴가 열린 상태에서 ⌘,를 누릅니다.

일반

KeyHue 설정
일반 탭: 언어, Dock 표시, 로그인 시 실행, 업데이트, 로그 파일 보기
언어, Dock 표시, 로그인 시 실행, 업데이트, 로그 파일.

모양

KeyHue 설정
모양 탭: 상태 바 옵션, 메뉴바 아이콘, HUD, macOS 입력 소스 표시 숨기기
색 선, 메뉴바 아이콘, HUD, macOS의 입력 소스 표시.

입력 소스

KeyHue 설정
입력 소스 탭: 입력 소스별 색, Caps Lock 색, 기본 입력 소스
켜진 입력 소스마다 한 줄씩 나옵니다. 색을 눌러 바꿉니다.

자동 전환

KeyHue 설정
자동 전환 탭: 앱·창 전환, 기억한 입력 소스 지우기, ESC, 실험적 텍스트 필드
자동 전환은 직접 켜기 전까지 모두 꺼져 있습니다.

입력기

KeyHue 설정
입력기 탭: KeyHue 입력기 상태와 관리, 단어 고침, 한/영 경고
입력기는 상태 한 줄과 다음에 누를 버튼 하나로 보입니다. 드물게 쓰는 동작은 관리에 있습니다. ⓘ를 누르면 자세한 설명이 나옵니다.

자동으로 되돌리기

단축키나 명령어가 엉뚱한 언어로 입력되지 않도록 알맞은 입력 소스로 되돌려 주는 옵션입니다.

앱이나 창을 바꿀 때

앱을 바꿀 때와 같은 앱에서 창을 바꿀 때 각각 하나를 고릅니다.

둘 다 복원이면 다른 앱에서 돌아올 때 앞에 있는 창의 기록을 먼저, 없으면 앱의 기록을 씁니다. 앱 쪽은 권한이 필요 없고 다시 실행해도 기억합니다. 창 쪽은 손쉬운 사용 권한이 필요합니다(시스템 설정 › 개인정보 보호 및 보안 › 손쉬운 사용). KeyHue는 앱의 메인 창이 바뀌는지만 보므로 떠 있는 패널이나 대화상자는 세지 않고, 창 제목이나 내용은 읽지 않습니다. 그래서 앱이나 KeyHue를 다시 실행하면 같은 창인지 알 수 없어, 창은 KeyHue를 종료할 때까지만 기억합니다.

앱마다 기억 단위 고르기

터미널은 탭마다 다른 언어를 쓰고, 메신저는 채팅방을 바꿔도 같은 언어를 쓴다면 앱마다 다르게 기억할 수 있습니다. 앱을 바꿀 때를 마지막 입력 소스로 복원, 같은 앱에서 창을 바꿀 때를 그대로 두기로 두면 모든 앱이 앱 하나로 기억합니다. 그다음 창마다 기억할 앱만 고릅니다.

목록의 앱은 창(탭)을 바꿀 때 마지막 입력 소스로 되돌리고, 새 창과 새 탭은 ABC로 시작합니다. 다른 앱에서 돌아올 때도 앞 창의 기록을 씁니다. 목록에 없는 앱은 같은 앱에서 창을 바꿀 때를 따릅니다. 목록은 앱을 바꿀 때가 복원일 때만 적용되고, 창을 바꿀 때가 이미 복원이면 모든 앱이 창마다 기억하므로 쓰이지 않습니다. Ghostty처럼 macOS 기본 탭을 쓰는 앱은 탭마다 기억합니다. 한 탭을 나눈 칸(분할)은 같은 창이라 하나로 기억합니다.

ESC를 누를 때

Vim, VS Code, 터미널에서 유용합니다. 처음 켤 때 KeyHue가 입력 모니터링 권한이 왜 필요한지 설명하고 시스템 요청을 띄웁니다.

  1. 시스템 설정 › 개인정보 보호 및 보안 › 입력 모니터링으로 갑니다.
  2. KeyHue를 켭니다.
  3. 메뉴에서 이 항목에 여전히 대시(–)가 보이면 KeyHue를 종료했다가 다시 엽니다.

텍스트 필드를 벗어날 때 (실험적)

손쉬운 사용 권한이 필요합니다(시스템 설정 › 개인정보 보호 및 보안 › 손쉬운 사용). 대부분의 Mac 기본 앱에서 동작하지만 Chrome과 일부 Electron 앱에서는 동작하지 않을 수 있습니다.

한/영을 잘못 치고 있을 때 (실험적, 한국어 입력)

한국어를 입력하는 사용자를 위한 옵션입니다. 두벌식과 ABC 같은 QWERTY 영문 배열이 둘 다 켜져 있을 때만 보입니다(KeyHue 입력기의 두 모드도 해당). 다른 언어로 치려던 것 같으면, 예를 들어 ABC에서 친 dkssud(안녕)이나 한국어에서 친 ㅗ디ㅣㅐ(hello)이면, 보통 처음 3–4타 안에(dks → “안…?”), 아니면 스페이스나 리턴으로 단어를 마쳤을 때 화면 아래에 그 언어로 바꾼 단어(예: “안녕?”)를 작은 메시지로 잠깐 보여 주고 막대가 그 언어의 색으로 몇 번 깜빡입니다. 입력한 글자나 입력 소스는 바꾸지 않습니다. 잘못 알리지 않도록 지우기로 고친 단어, 아주 짧은 단어, 숫자·기호가 섞인 단어는 건너뜁니다. 영문으로 친 단어를 처음까지 다 지우면 이어서 치는 글자는 새 단어로 봅니다. ESC 옵션처럼 입력 모니터링 권한이 필요합니다. KeyHue는 키의 위치만 읽고, 지금 치는 단어만 메모리에 두었다가 단어가 끝나면 지웁니다. dirname 같은 명령어를 한글로 잘못 알리지 않도록 시스템·Homebrew 명령어 폴더의 파일 이름도 읽습니다. 막대 깜빡임만 원하면 메시지로 알리기를 끕니다.

KeyHue 입력기 (실험적)

IntelliJ 같은 앱에서 고침 단축키가 충돌하면, 그 앱을 쓰던 상태에서 메뉴의 〈앱〉에서 단어 고침 끄기를 선택하세요. 설정 › 입력기 › 단어 고침 › 고치지 않는 앱에서도 추가하거나 제거할 수 있습니다. 제외한 앱에서는 단축키 고침과 Space 자동 고침이 모두 꺼지고, 고침 단축키는 앱에 그대로 전달됩니다. 일반 한글·영문 입력은 계속 쓸 수 있습니다.

한글/영문 입력기는 KeyHue.app에 포함되며 기본 OFF입니다. 설정 › 입력기에서 상태 줄 아래의 입력기 설치 및 사용…을 누르거나 메뉴의 KeyHue 입력기 ▸ 입력기 설치 및 사용…을 선택하세요. KeyHue가 ABC로 전환하고 사용자 계정에 서비스를 설치한 뒤 서명을 확인하고 macOS에 등록합니다. 입력 소스는 KeyHue가 추가하지 않습니다. 두 모드가 이미 추가돼 사용 가능하면 연동이 시작되고 한글 모드가 선택됩니다. 아니면 설치 완료 안내가 표시되니 입력 소스 설정 열기를 눌러 시스템 설정 › 키보드 › 텍스트 입력 › 편집 › +에서 한국어 아래의 KeyHue 실험 – 두벌식과 영어 아래의 KeyHue 실험 – 영문을 모두 추가하세요. 창을 처음 열었을 때 한국어나 영어 목록이 비어 있으면 다른 언어를 한 번 눌렀다가 다시 한국어·영어를 누르세요. 시스템 설정이 처음 목록을 그리지 못할 때가 있습니다. 사용 요청은 유지되며 두 모드가 켜지면 연동이 자동으로 시작되므로 옵션을 다시 켤 필요는 없습니다. macOS가 새 입력 소스를 등록할 때 허용을 물을 수 있습니다. 이 허용은 macOS가 관리하므로 KeyHue가 대신 승인할 수 없습니다. macOS 26에서는 설치·업데이트에 성공하면 KeyHue만 자동 재시작합니다.

한글은 현재 음절만 밑줄로 표시하고, 영문은 밑줄 없이 친 그대로 입력합니다(터미널에서 Return 한 번으로 명령 실행). 그래서 macOS의 자동 대문자가 문장 첫 단어에 적용되며, 단축키 고침이 치지 않은 대문자를 읽지 않도록 키보드 › 텍스트 입력 › 편집…에서 자동 대문자를 끄는 것을 권장합니다. 한자 변환은 아직 제공하지 않습니다. 모드 유지는 단축키를 바꾸지 않고 ⌘Space·Caps Lock·Control Space·Fn·메뉴의 소스 변경을 관찰합니다. KeyHue 모드에서 ABC나 시스템 두벌식을 고르면 반대쪽 KeyHue 모드로 연결하고 회색으로 표시하며, 다른 언어는 유지합니다. 잠금 화면이나 비밀번호 칸이 ABC를 고른 뒤에는 두 KeyHue 모드를 ABC 앞으로 되돌려 ⌘Space가 바로 오가게 합니다. 관리 › 연동 끄고 ABC로 전환으로 파일을 남긴 채 쉬어 갈 수 있고 원래 기본 소스 설정도 보존합니다. 연동 중에는 앱·창에서 기억했거나 기본값으로 저장한 ABC·두벌식을 짝이 되는 KeyHue 모드로 읽고, 연동을 끄거나 모드를 지우면 기억한 KeyHue 모드를 다시 두벌식·ABC로 읽습니다(그 입력 소스가 켜져 있을 때). 빠른 전환·첫 키 타이밍은 실험 단계이므로 사용하는 앱에서 확인해 주세요.

단어 고침: KeyHue 입력기를 쓰는 동안 한/영을 잘못 놓고 친 글자를 단축키(기본 ⌥↩)로 고칩니다. 선택한 글자를, 선택이 없으면 커서 바로 앞 단어를 반대 언어로 바꾸고(dkssud → 안녕, ㅗ디ㅣㅐ → hello) 입력 모드도 바꿉니다. 바로 한 번 더 누르면 되돌립니다. 설정 › 입력기 › 단어 고침에서 끄거나, 단축키를 바꾸거나, Space에서 자동으로도 고치게 하고, 고치지 않을 앱을 고를 수 있습니다. 자동 고침은 영문 모드로 친 한글 단어만 고치며, 터미널에서는 명령어가 바뀌지 않도록 자동으로 고치지 않습니다. 터미널에서는 단축키를 쓰세요. 터미널에서는 방금 친 단어를 Delete 키로 지우고 다시 넣습니다. 이 키는 KeyHue가 보내므로 KeyHue가 실행 중이어야 하고 KeyHue에 손쉬운 사용 권한이 필요합니다. 입력기에는 따로 권한을 주지 않아도 됩니다. 터미널 고침은 Ghostty에서 확인했고, Terminal 등 다른 터미널은 아직 확인하지 않았습니다. 터미널은 선택한 글자를 입력기에 알려 주지 않으므로, 터미널에서 Shift+방향키로 선택한 글자는 고치지 않고 이유를 알려 줍니다. 선택을 풀고 단어 바로 뒤에서 단축키를 누르세요. 비밀번호 칸은 바꾸지 않습니다.

설치 위치는 ~/Library/Input Methods/KeyHueInputMethodSpike.app이며 예전 실험 등록과 호환되도록 내부 이름은 유지합니다. KeyHue를 종료해도 기본 입력은 남고 자동 연동은 중단됩니다. 제거하려면 먼저 시스템 설정 › 키보드 › 텍스트 입력 › 편집에서 KeyHue 두 모드를 제거한 뒤 관리 › 입력기 제거를 선택하세요. 모드가 남아 있으면 설정을 여는 버튼과 함께 제거를 안내하고 파일을 유지합니다. macOS 26에서는 시스템 설정이 마지막으로 지운 모드를 남겨 둘 때가 있습니다. 목록에서는 사라지지만 macOS에는 남습니다. 두 모드를 다 지웠는데도 모드가 남아 있다고 나오면 그래도 제거를 고르세요. 이후 KeyHue는 자기 항목을 끄고 서비스를 정지한 뒤 설치본만 삭제하며, 다른 입력기·KeyHue 설정은 바꾸지 않습니다. macOS가 남긴 항목은 입력기가 없으면 아무 동작도 하지 않습니다(macOS가 남긴 항목 지우기 참고). macOS 26에서는 완료 후 KeyHue만 자동 재시작합니다. 이미 열어 둔 키보드 설정 화면은 닫았다가 다시 열어 갱신하세요.

문제가 계속되면 ~/Library/Logs/KeyHue/KeyHue.log에서 등록·입력 소스 상태를, ~/Library/Logs/KeyHue/KeyHueInputMethod.log에서 IMK 서버와 모드 전환 기록을 확인하세요. 한영 전환을 연달아 누르거나 입력 중에 세션 복구가 일어난 순간은 [Suspect]로, 막대·HUD가 어느 화면에 무슨 색으로 표시됐는지는 display로 남습니다. 입력한 글자와 키 코드는 기록하지 않습니다.

업데이트와 삭제

업데이트: 메뉴에서 KeyHue를 종료하고, 최신 버전을 받아 응용 프로그램 폴더의 KeyHue.app을 바꿉니다. 설정은 그대로 남습니다. 실험적 입력기를 쓴다면 앱 교체 후 입력기 업데이트 및 사용…을 선택하세요. 앱 교체만으로 설치된 입력기를 자동 교체하지 않습니다. ESC나 텍스트 필드 옵션을 쓴다면 업데이트 후 권한을 다시 허용해야 할 수 있습니다.

삭제: 입력기를 설치했다면 먼저 입력기 제거를 선택하세요. 그다음 KeyHue를 종료하고 로그인 시 실행을 끈 뒤, KeyHue.app을 휴지통으로 옮깁니다. 설정까지 지우려면 터미널에서 defaults delete io.github.sejoung.keyhue를 실행하고, 시스템 설정의 입력 모니터링과 손쉬운 사용에서 KeyHue를 빼세요.

macOS가 남긴 항목 지우기

그래도 제거 뒤에도 macOS가 입력 소스 목록에 KeyHue 두벌식이나 영문을 남길 수 있습니다. 입력기가 없으면 어디에도 보이지 않고 아무 동작도 하지 않습니다. 입력기를 다시 설치하면 추가된 모드로 돌아오고, KeyHue는 나머지 하나만 추가하라고 안내합니다. 이 목록은 전체 디스크 접근 권한이 있는 앱만 바꿀 수 있고 KeyHue는 이 권한을 요청하지 않으므로 KeyHue가 지울 수는 없습니다. 직접 지우려면 시스템 설정 › 개인정보 보호 및 보안 › 전체 디스크 접근 권한에서 터미널을 허용한 뒤 터미널에서 아래 명령을 실행하고, 로그아웃했다가 다시 로그인하세요. KeyHue 항목만 지우며 다른 입력기는 그대로 둡니다. 끝나면 터미널의 전체 디스크 접근 권한은 다시 꺼도 됩니다.

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"

문제 해결

메뉴바에 카멜레온이 안 보여요

노치가 있는 MacBook에서는 메뉴바 아이콘이 많으면 노치 뒤로 가려집니다. 메뉴바 앱을 몇 개 종료하거나, ⌘를 누른 채 아이콘을 끌어 순서를 바꾸세요. macOS 26 이상이라면 시스템 설정 › 메뉴 막대도 확인하세요. 아이콘이 보이지 않아도 Spotlight나 응용 프로그램 폴더에서 KeyHue를 다시 실행하면 설정 창이 열립니다.

전환해도 색이 안 바뀌어요

KeyHue는 macOS가 알려주는 입력 소스를 따릅니다. 입력 소스를 바꾸지 않고 입력기 안에서만 모드를 바꾸는 경우(예: 일부 중국어 입력기의 Shift 전환)는 KeyHue가 알 수 없습니다.

업데이트한 뒤 ESC로 전환이 안 돼요

macOS는 입력 모니터링 권한을 앱의 서명에 묶어 둡니다. KeyHue를 업데이트하면 서명이 바뀌어, 시스템 설정에 켜져 있는 것처럼 보여도 이전 허용이 적용되지 않습니다. 이런 경우 KeyHue가 알려 줍니다. 다시 허용…(또는 메뉴의 입력 모니터링 권한 허용…)을 누른 뒤 시스템 설정 › 개인정보 보호 및 보안 › 입력 모니터링에서 KeyHue를 켜세요. 텍스트 필드 옵션의 손쉬운 사용 권한도 같습니다.

터미널에서 Shift·Option·Ctrl+방향키를 누르면 A~D가 입력돼요

터미널은 수정키와 함께 누른 방향키를 ESC[1;2A(Shift+↑), ESC[1;3D(Option+←), ESC[1;5C(Ctrl+→)처럼 보냅니다. zsh에는 이 키들이 연결돼 있지 않아서 끝의 A~D가 글자로 들어가고, 2A·3D처럼 숫자가 함께 보이기도 합니다. KeyHue 입력기와 상관없이 ABC에서도 같습니다. 터미널에서 cat -v를 실행하고 키를 누르면 터미널이 보내는 값을 볼 수 있습니다.

셸에서도 Shift+방향키로 글자를 선택하려면 zsh 플러그인 zsh-shift-select(GitHub jirutka/zsh-shift-select)를 설치하세요. oh-my-zsh라면 터미널에서 git clone https://github.com/jirutka/zsh-shift-select ~/.oh-my-zsh/custom/plugins/zsh-shift-select를 실행하고, ~/.zshrc의 plugins=(...)에 zsh-shift-select를 더한 뒤 터미널을 다시 여세요. 선택은 필요 없고 글자만 안 나오면 된다면 ~/.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+↓

Option·Ctrl+←·→로 단어 단위로 움직이려면 다음을 넣으세요. Ctrl+방향키는 macOS가 Mission Control·데스크탑 전환에 먼저 쓰므로, 시스템 설정 › 키보드 › 키보드 단축키 › 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+→

저장한 뒤 터미널을 다시 열면 적용됩니다.

Ghostty에서 한글을 치다가 Tab·방향키를 누르면 한 번 더 눌러야 해요

Ghostty는 한글 조합 중에 Tab·방향키·Home·End·Page Up/Down·forward Delete를 누르면 조합 중인 마지막 글자를 버립니다. KeyHue 입력기는 글자를 잃지 않도록 그 키로 조합만 끝내고 키는 한 번 소비합니다. 그래서 글자는 남고, 키는 한 번 더 눌러야 합니다. Return·Esc도 Ghostty에서 같은 이유로 조합 중에는 한 번 더 눌러야 합니다. 조합 중이 아니거나 영문 모드라면 한 번으로 동작하고, ⌃C 같은 ⌘·⌃·⌥ 단축키는 항상 바로 갑니다.

macOS가 KeyHue가 손상되었거나 확인할 수 없다고 해요

Apple Developer ID가 없는 앱을 처음 열 때 나오는 차단입니다. 설치의 3단계를 따라 주세요.

이상한 동작을 알리고 싶어요

설정 › 일반의 로그 파일 보기를 누르면 Finder에서 ~/Library/Logs/KeyHue/KeyHue.log가 열립니다. 문제가 생긴 시각과 함께 이 파일을 문제 신고에 첨부해 주세요. 실행 시점의 버전·설정·권한과, 앱·창 전환, 입력 소스 변경, 자동 전환 결과가 시각과 함께 남아 있어 원인을 찾는 데 도움이 됩니다.

개인정보

KeyHue는 입력한 내용을 기록하지 않습니다. 선택된 입력 소스, Caps Lock 상태, 활성 앱을 읽습니다. 선택 기능을 켜면 누른 키가 ESC인지, 포커스된 요소가 어떤 종류인지도 확인하지만 텍스트는 읽지 않습니다. 실험적인 한/영 알림은 지금 치는 단어의 키 위치를 보고, 그 단어를 끝날 때까지만 메모리에 두며 저장하거나 기록하지 않습니다. 선택 설치하는 KeyHue 입력기는 클라이언트 세션에 전달된 입력만 메모리에서 조합하고 텍스트를 저장·기록·전송하지 않습니다. 단어 고침은 단축키를 누를 때 선택한 글자나 커서 앞 단어(터미널은 입력기가 방금 받은 키)를 읽고 고친 뒤 버립니다. 자동 고침의 되돌린 고침 기록(기본 꺼짐)을 켠 경우에만 되돌린 고침(친 단어, 바뀐 글자, 앱)을 이 Mac에 최근 50개까지 저장하며, 끄면 지웁니다. 모드 유지는 문서 텍스트를 읽지 않고 입력 소스 변화와 입력 시작 시점만 관찰합니다. 문제를 확인하기 위한 로그 파일(~/Library/Logs/KeyHue/, 최대 3MB)에는 앱의 번들 ID와 입력 소스 전환 기록이 남지만, 입력한 내용이나 창 제목은 남지 않으며 어디로도 보내지 않습니다. 네트워크는 GitHub 공개 릴리즈 확인에만 사용합니다. 자동으로 하루 한 번, 또는 업데이트 확인을 선택할 때 조회하며 설정 › 일반에서 자동 확인을 끌 수 있습니다. 입력 내용·앱 활동·로그를 보내지 않고 분석 도구도 없으며, 소스 코드는 MIT 라이선스로 공개돼 있습니다. 한/영 알림의 한글 음절 모델은 한국어 위키백과에서 만든 것이라 CC BY-SA 4.0입니다.