한영딱 · HanTtak

한영 전환, 딱 한 키.

맥의 오른쪽 ⌘를 한영키로. 설정 후 앱은 종료하세요.

다운로드 · 웹사이트 · English

한영딱은 원하는 키 하나를 한영 전환 전용키로 만드는 무료 macOS 앱입니다. 오른쪽 Command, Option, Caps Lock 등 지원하는 키를 선택하면 macOS의 키 매핑과 입력 소스 단축키를 함께 설정합니다.

설정 후에는 앱을 켜 둘 필요가 없습니다. 키 전환은 macOS가 처리하므로, 한영딱을 종료해도 계속 사용할 수 있습니다.

_{현재 배포 버전의 화면입니다. 이전 이름인 Hangul Key Changer로 표시됩니다.}

이런 분을 위해 만들었습니다

• 맥에서도 오른쪽 엄지로 한영 전환을 하고 싶은 분
• Caps Lock이나 Fn 대신 손에 익은 키를 쓰고 싶은 분
• 한영키 하나를 설정하기 위해 앱을 계속 실행해 두고 싶지 않은 분
• 기존 두벌식·세벌식 입력기를 유지하면서 전환키만 바꾸고 싶은 분

오른쪽 Command ⌘  →  한 / 영

키 선택  →  활성화  →  앱 종료  →  그대로 사용

한영딱의 장점

장점	실제로 달라지는 점
상주 앱 없이 동작	설정 후 종료하면 한영딱 프로세스가 메모리나 CPU를 계속 점유하지 않습니다.
별도 드라이버 설치 없음	macOS 내장 키 매핑 기능을 사용합니다. 추가 드라이버나 커널 확장을 설치하지 않습니다.
간단한 설정	키를 고르고 활성화하면 키 매핑과 입력 소스 단축키를 함께 설정합니다.
접근성·입력 모니터링 권한 불필요	평소 키 입력을 감시하는 상주 프로세스 없이 동작합니다.
로그인 시 자동 적용	로그인 항목이 허용되어 있으면 매핑을 다시 적용하고 앱은 자동 종료합니다.
기존 입력기 유지	새 입력기를 설치하지 않고 macOS에 등록된 입력 소스를 전환합니다.
한국어·영어 지원	앱의 KO / EN 버튼으로 표시 언어를 바꿀 수 있습니다.
무료·오픈소스	MIT 라이선스로 소스를 공개합니다. 자유롭게 사용하고 수정할 수 있습니다.

메모리를 계속 차지하지 않는 이유

한영딱은 키를 누를 때마다 뒤에서 동작하는 프로그램이 아니라, macOS에 키 매핑을 설정하는 앱입니다. 설정이 끝나면 앱의 역할도 끝납니다.

시점	한영딱의 동작
앱을 열어 설정할 때	일반 앱처럼 메모리와 CPU를 사용합니다.
설정 후 앱을 종료했을 때	한영딱 프로세스는 종료되고, macOS가 매핑을 처리합니다.
다음 로그인 때	로그인 항목으로 잠시 실행되어 매핑을 적용한 뒤 종료합니다.

따라서 앱 종료 후 상주 프로세스에 드는 메모리·CPU 사용이 없습니다. 앱 실행 중이거나 로그인 시에도 항상 0MB라는 뜻은 아니며, macOS 자체의 키보드 처리 비용까지 없어지는 것은 아닙니다.

확인하고 싶다면 설정 후 앱을 종료하고 활성 상태 보기에서 HanTtak 또는 이전 앱 이름인 Hangul Key Changer를 검색해 보세요.

설치

macOS 14 Sonoma 이상이 필요합니다. 사용 전에 한국어와 영어 입력 소스를 등록해 주세요.

이름 변경 안내: Hangul Key Changer가 **한영딱 (HanTtak)**으로 바뀝니다. 현재 배포된 앱 이름과 Homebrew 설치 명령은 이전 이름을 사용합니다. 아래 명령으로 설치하세요.

Homebrew

brew install --cask hulryung/tap/hangulkeychanger

직접 다운로드

1. Releases에서 DMG 파일을 다운로드합니다.
2. DMG를 열고 앱을 응용 프로그램(/Applications) 폴더로 옮깁니다.
3. 응용 프로그램 폴더에서 앱을 실행합니다.

사용법

1. 키 선택 — 기본값은 오른쪽 Command입니다. 다른 키를 쓰려면 변경을 누르고 사용할 키를 입력하세요.
2. 활성화 — 키 매핑과 입력 소스 전환 단축키가 설정됩니다.
3. 전환 확인 — 텍스트 편집기 등에서 선택한 키를 눌러 한글·영문 전환을 확인하세요.
4. 앱 종료 — 창을 닫거나 ⌘Q로 종료해도 매핑은 유지됩니다.

로그인 항목 승인이 필요한 경우 macOS 시스템 설정에서 허용해 주세요. 이후 로그인할 때 저장된 매핑을 다시 적용합니다.

어떤 키를 고르면 좋을까요?

키	사용 방식
오른쪽 Command ⌘	기본 설정입니다. 오른쪽 키를 한영 전용으로 쓰고, 복사·붙여넣기는 왼쪽 Command로 합니다.
오른쪽 Option ⌥	오른쪽 Command를 유지하고 Option을 한영 전용으로 쓸 수 있습니다.
Caps Lock ⇪	Caps Lock을 한영 전용으로 사용합니다. 해당 키의 대문자 잠금 기능은 사용할 수 없습니다.

선택한 키는 원래 기능 대신 한영 전환을 수행합니다. 짧게 누르기와 길게 누르기를 구분하지 않습니다. 외장 키보드는 Mac / Windows 모드에 따라 실제 전달되는 키가 다를 수 있으므로 앱에서 직접 눌러 확인하세요.

작동 원리

선택한 키
   │
   │  macOS 내장 hidutil로 매핑
   ▼
  F18
   │
   │  “이전 입력 소스 선택” 단축키
   ▼
입력 소스 전환

• 키 매핑: macOS 내장 hidutil로 선택한 키를 F18로 바꿉니다.
• 단축키 설정: “이전 입력 소스 선택”을 F18에 연결합니다.
• 로그인 시 적용: SMAppService로 앱을 로그인 항목에 등록합니다. 로그인 실행 시 매핑을 적용한 뒤 종료합니다.

구현은 KeyMappingManager.swift와 AppDelegate.swift에서 확인할 수 있습니다. UI는 Swift와 AppKit으로 작성했습니다.

자주 묻는 질문

앱을 종료하는 것과 비활성화하는 것은 다른가요?

네. 앱 종료는 설정 창과 앱 프로세스만 닫습니다. 키 매핑은 유지됩니다. 비활성화는 키 매핑을 해제하고 로그인 자동 적용을 끕니다.

관리자 비밀번호나 별도 권한이 필요한가요?

일반적인 신규 설치와 활성화에는 관리자 비밀번호, 접근성 권한, 입력 모니터링 권한이 필요하지 않습니다. 로그인 시 자동 적용을 위해서는 로그인 항목 허용이 필요할 수 있습니다.

이전 버전이 설치한 시스템 LaunchAgent 파일이 남아 있다면, 해당 파일을 정리하는 과정에서 관리자 비밀번호를 요청할 수 있습니다.

한영 전환 딜레이도 해결되나요?

한영딱은 전환키를 바꾸는 도구입니다. 입력기 자체를 교체하거나 조합 중인 글자를 처리하지 않습니다. 모든 환경의 전환 지연이나 입력 누락을 해결한다고 보장하지 않습니다.

입력 소스가 세 개 이상이어도 한글과 영어만 오가나요?

특정 두 언어를 고정하는 방식은 아닙니다. macOS의 “이전 입력 소스 선택” 동작을 따릅니다. 등록된 입력 소스와 사용 순서에 따라 다른 입력 소스로 전환될 수 있습니다.

다른 키 매핑 도구와 함께 사용할 수 있나요?

현재 구현은 hidutil의 기존 사용자 키 매핑 목록을 덮어씁니다. 기존 매핑을 자동으로 보존하거나 병합하지 않습니다. 이미 사용자 지정 매핑을 사용한다면 먼저 내용을 기록해 두세요. 다른 도구에서 같은 키를 매핑하면 충돌할 수 있습니다.

재로그인하거나 키보드를 다시 연결한 뒤 동작하지 않아요.

로그인 항목이 허용되어 있는지 확인하고 앱을 다시 실행해 보세요. 문제가 계속되면 아래 정보와 함께 이슈를 남겨 주세요.

• macOS 버전
• 키보드 모델과 연결 방식: 내장 / USB / Bluetooth
• 선택한 전환키
• 문제가 생기는 시점과 재현 순서

비활성화 및 제거

1. 앱을 열고 비활성화를 누릅니다.
2. 앱을 종료합니다.
3. 응용 프로그램 폴더에서 앱을 삭제하거나, Homebrew로 설치했다면 다음 명령을 실행합니다.

brew uninstall --cask hangulkeychanger

비활성화하면 hidutil 사용자 키 매핑 목록을 비우고, 입력 소스 단축키를 Control+Space로 설정합니다. 설치 전 사용자 지정 설정을 자동 복원하는 방식은 아닙니다. 기존 단축키나 매핑은 직접 다시 설정해야 합니다.

v2.3.0 이하에서 Homebrew 업그레이드가 실패하는 경우

이전 앱 이름 변경으로 업그레이드가 실패한다면, 앱에서 먼저 비활성화하고 종료한 뒤 재설치하세요.

brew uninstall --cask hangulkeychanger --force
brew install --cask hulryung/tap/hangulkeychanger

개발 및 기여

전체 앱 빌드에는 Xcode가 필요합니다. 제품 이름은 HanTtak.app이며 기존 프로젝트와 scheme 이름은 HangulCommandApp을 유지합니다.

git clone https://github.com/hulryung/HangulKeyChanger.git
cd HangulKeyChanger
xcodebuild -project HangulCommandApp.xcodeproj \
  -scheme HangulCommandApp \
  -configuration Debug \
  -derivedDataPath build/DerivedData \
  CODE_SIGNING_ALLOWED=NO build

위 명령은 개발용 서명 없는 빌드입니다. 배포용 서명·공증 절차는 빌드 가이드, 이름 변경에 따른 릴리스 준비는 전환 안내를 참고하세요.

버그 제보, 키보드 호환성 공유, 문서 개선, 코드 기여 모두 환영합니다. 변경 이력과 배포 파일은 Releases에서 확인할 수 있습니다.

라이선스와 링크

MIT 라이선스 · 웹사이트 · GitHub · X

---

한영 전환, 딱 한 키.

저는 여전히 3벌식을 사랑합니다.