HangulSync

한국어 | English | 日本語 | 简体中文 | 繁體中文 | ไทย | Русский | Italiano

원격 데스크탑 연결 시 한글 자소 분리(ㅎㅏㄴㄱㅡㄹ)를 해결하는 macOS 메뉴바 앱입니다. Jump Desktop, 화면 공유, Screens 등에서 로컬과 원격의 입력 상태가 어긋나며 생기는 문제를 근본에서 차단합니다.

한·영 입력 상태가 Mac 간 자동으로 동기화됩니다. IP 입력이나 별도 설정 없이, 서로를 자동으로 찾아 연결합니다.

왜 필요한가요?

원격 데스크탑으로 다른 Mac을 조작하면 로컬과 원격의 입력 소스가 쉽게 어긋납니다. 나는 한글을 친다고 생각하는데 원격 Mac은 영문 모드라 자소가 분리되거나, 반대로 cmd 단축키가 눌린 것처럼 동작하죠. HangulSync는 양쪽의 입력 소스 상태를 실시간으로 미러링해 문제를 원천 차단합니다.

기능

• 🔄 실시간 양방향 동기화 — 한·영 전환이 즉시 전파
• 🌐 자동 탐지, 무설정
  • 같은 네트워크: Bonjour 자동 탐지 (근거리에서는 AWDL P2P Wi-Fi 포함)
  • 다른 네트워크: Tailscale 이 켜져 있으면 같은 tailnet의 피어를 자동 탐지 (20초 주기)
• 🧠 스마트 폴백 — 상대 Mac에 같은 입력기가 없어도(예: 구름입력기 vs 기본 두벌식) 언어 기준으로 알아서 매칭
• 🔁 루프 방지 — 원격에서 적용된 변경은 재전파되지 않음
• 🖥 가볍게 상주 — 메뉴바에서 제어, Dock 아이콘 표시/숨김 선택 가능, 로그인 시 자동 실행 지원
• 🌍 다국어 UI — 한국어, English, 日本語, 简体中文, 繁體中文, ไทย, Русский, Italiano
• 🎯 원격 접속 중에만 작동 — Jump Desktop, 화면 공유, Screens, TeamViewer, AnyDesk, RustDesk 등 원격 데스크탑 앱을 쓰는 동안에만 동기화 (메뉴에서 항상 켜기로 변경 가능)
• ☁️ 인터넷 릴레이 — Tailscale 없이도 두 Mac이 한 번이라도 직접 연결된 적 있으면 이후 어디서든 자동 동기화

설치 (두 Mac 모두)

📦 빌드 없이 사용하려면 Releases에서 최신 HangulSync.zip을 받아 /Applications에 넣으세요. (첫 실행 시 우클릭 → 열기)

빌드된 HangulSync.app을 복사해도 됩니다.

git clone https://github.com/catgarret/HangulSync.git
cd HangulSync
./install.sh

Xcode Command Line Tools 필요 (xcode-select --install).

1. 첫 실행 시 로컬 네트워크 접근 허용 팝업에서 반드시 허용
2. 메뉴바 ⇄한 / ⇄A 아이콘 클릭 → 로그인 시 자동 실행 체크

메뉴바 아이콘

표시	의미
⇄한 / ⇄A	동기화 중 (현재 입력: 한글/영문)
⏸한 / ⏸A	일시정지
흐린 아이콘	대기 중 (원격 세션 없음)

메뉴에서 연결된 Mac 수 확인, 일시정지/재개, "원격 접속 중에만 동기화" 전환, 자동 실행 설정, 종료가 가능합니다.

라이선스

MIT © dongri.me · AI 바이브코딩으로 만들었습니다.