Skip to content

koolhip/HanglishIME

Repository files navigation

HanglishIME

한글리쉬 - macOS용 QWERTY → 한글 입력기

QWERTY 키보드로 영어를 입력하면 실시간으로 한글로 변환되어 보여지는 오버레이 창을 통해 한글 입력을 도와줍니다. 앱에는 실제 한글 입력이 전달되지 않아 Electron 앱 등에서도 안정적으로 작동합니다.

특징

  • 🔤 QWERTY 입력 → 한글 변환: 영어로 입력하면 한글로 표시
  • 👁️ 실시간 오버레이: 화면 하단 중앙에 변환된 한글 표시
  • 🔒 비밀번호 모드: 민감한 입력 시 오버레이 숨김
  • 가벼운 동작: 백그라운드 상주, 빠른 전환
  • 🎯 Electron 앱 호환: VS Code, Slack, Discord 등에서도 사용 가능

설치 방법

1. 다운로드

Releases 페이지에서 최신 버전의 .zip 파일을 다운로드합니다.

2. 실행 허용

처음 실행 시 "개발자를 확인할 수 없음" 경고가 나타나면:

  1. Finder → 앱 우클릭 → 열기 클릭
  2. 또는 시스템 설정개인정보 보호 및 보안보안 → "확인 없이 열기" 클릭

3. 접근성 권한 부여

실행 후 자동으로 접근성 권한을 요청합니다:

  1. 시스템 설정개인정보 보호 및 보안손쉬운 사용
  2. HanglishIME 토글 ON

사용 방법

단축키 기능
⌃⌥⌘Space (Ctrl+Opt+Cmd+Space) IME 켜기/끄기
⌃⌥⌘P 비밀번호 모드 토글

입력 예시

  1. IME 켜기: ⌃⌥⌘Space
  2. gksrmf 입력 → 오버레이에 한글 표시
  3. Space 또는 Enter → 한글 확정 입력

시스템 요구사항

  • macOS 14.0 (Sonoma) 이상
  • Apple Silicon 또는 Intel Mac

개발

# 클론
git clone https://github.com/YOUR_USERNAME/HanglishIME.git
cd HanglishIME

# 빌드
xcodebuild -project HanglishIME.xcodeproj -scheme HanglishIME -configuration Release

# 실행
open build/Release/HanglishIME.app

라이선스

MIT License - 자유로운 사용 및 수정 가능

문의 및 기여

  • Issue: 버그 리포트 및 기능 제안
  • Pull Request: 코드 기여 환영

주의: 이 앱은 Apple 공증(Notarization)을 받지 않았습니다. 첫 실행 시 보안 설정에서 허용이 필요합니다.

About

한글과 영어의 자유로운 타이핑은 한글리시로

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors