macOS 기본 입력 흐름에 맞춘 빠른 한글 입력기
한글은 PriType 조합, 영어는 ABC 레이아웃 pass-through. 전환은 빠르게, 조합은 가볍게.
PriType은 Swift와 InputMethodKit으로 만든 macOS용 한글 입력기입니다. 한글 조합 엔진은 libhangul-swift를 사용합니다.
-
빠르고 안정적인 한/영 전환 PriType은 한 입력기 안에서 한글 모드와 영어 모드를 함께 관리합니다. 사용자 지정 전환키는 실제
ABC입력 소스를 선택하지 않고 PriType 내부 모드만 전환해, 전환 직후 첫 글자 씹힘과 한/영 상태 불일치를 줄입니다. -
ABC 레이아웃 pass-through 영어 모드에서는 PriType이 문자를 직접 삽입하지 않고, macOS
ABC/US키보드 레이아웃을 요청한 뒤 host 앱의 기본 입력 흐름으로 통과시킵니다. -
빠른 한글 조합 두벌식 표준, 세벌식 390, 두벌식 옛한글, 세벌식 옛한글을 지원합니다.
-
한자와 자모 특수문자 한글 입력 중 한자키를 눌러 한자 후보를 고를 수 있습니다. 자음 입력 후 한자키를 누르면
♥,★같은 자모 특수문자도 입력할 수 있습니다. -
선택 가능한 전환키 macOS Caps Lock 입력 소스 전환을 쓰지 않는 경우, 우측 Command 등 원하는 키를 PriType 한/영 전환키로 지정할 수 있습니다. Caps Lock 전환이 켜져 있으면 PriType 전환키는 자동으로 비활성화됩니다.
-
macOS 설정 연동 스페이스 두 번으로 마침표 입력은 PriType 별도 설정이 아니라 macOS 텍스트 입력 설정을 따릅니다.
-
공증된 설치 패키지 릴리즈 PKG는 Developer ID 서명, Apple 공증, Gatekeeper 검증을 거쳐 배포합니다.
- 최신 릴리즈에서
PriTypeV2_Release.pkg를 다운로드합니다. - PKG를 실행해 설치합니다.
시스템 설정 > 키보드 > 텍스트 입력 > 입력 소스에서 PriType한글입력 소스를 추가합니다.- PriType 내부의 한/영 모드는 사용자 지정 전환키로 즉시 전환됩니다.
PriType 앱 번들은 기본적으로 /Library/Input Methods/PriTypeV2.app에 설치됩니다.
macOS 설정에서 Caps Lock 키로 ABC 입력 소스 전환을 켜면, Caps Lock 전환은 macOS가 직접 관리합니다.
이 모드에서는 PriType 설정의 별도 한/영 전환키가 비활성화됩니다. 전환 경로가 둘로 갈라지지 않도록 macOS 입력 소스 전환을 단일 기준으로 사용합니다.
Caps Lock 입력 소스 전환을 쓰지 않는다면 PriType 설정에서 한/영 전환키를 지정할 수 있습니다. 기본값은 우측 Command입니다.
우측 Command 전환이 동작하지 않으면 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용에서 PriType 권한을 확인한 뒤, 필요하면 권한을 껐다 켜고 Mac을 재시동해 주세요.
| 영역 | 내용 |
|---|---|
| 자판 배열 | 두벌식 표준, 세벌식 390, 두벌식 옛한글, 세벌식 옛한글 |
| 입력 소스 | PriType 단일 입력 소스, 영어는 내부 모드 + ABC/US 레이아웃 pass-through |
| 전환 | macOS Caps Lock 입력 소스 전환 또는 PriType 내부 사용자 지정 전환키 |
| 한자 | 한자 후보창, 자모 특수문자 입력 |
| 텍스트 편의 기능 | macOS 더블스페이스 마침표 설정 연동 |
| 업데이트 | GitHub Releases 기반 자동 업데이트 확인 |
- macOS 14.0 Sonoma 이상
- Swift 6.2 이상
# 개발 빌드
swift build
# 릴리즈 PKG 생성, 서명, 공증, Gatekeeper 검증
./build_release.sh-
입력 소스가 중복으로 보일 때 최신 버전 설치 후 로그아웃/로그인하거나 재시동해 macOS 입력 소스 캐시를 새로 고쳐 주세요.
-
Caps Lock 전환이 안 될 때 macOS 입력 소스 설정에서 Caps Lock 전환 옵션이 켜져 있는지 확인해 주세요. PriType 설정에서 Caps Lock을 직접 전환키로 지정하는 방식은 사용하지 않습니다.
-
우측 Command 전환이 안 될 때 손쉬운 사용 권한이 필요합니다. 권한을 부여한 뒤에도 동작하지 않으면 PriType을 재실행하거나 Mac을 재시동해 주세요.
- ARCHITECTURE.md: 내부 구조, 입력 처리 흐름, 주요 모듈
- Docs/InputArchitectureHybridRollbackPlan.md: 2.6.5 기반 통합 입력 방식과 2.7.2 입력 소스 구조의 하이브리드 재설계 계획
- BENCHMARK.md: 성능 측정 결과
- CHANGELOG.md: 버전별 변경 사항
MIT License