# libhangul

> 한글 입력기 구현 라이브러리. 한글 입력기를 만들 때 쓰는 오픈소스 라이브러리로, 15년째 유지되고 있습니다.

- 페이지: https://dreamboat.kr/discover/libhangul
- 공식 사이트: https://github.com/libhangul/libhangul
- 분야: 개발도구
- 쓰는 환경: 라이브러리
- 상태: 운영 중
- 등재: 2026-08-24 · 마지막 갱신: 2026-10-23


## 소개

libhangul은 **한글 입력기(IME)를 만들기 위한 오픈소스 라이브러리**입니다.

GitHub 현황 (2026년 8월 기준):
- 스타 **227** · 포크 **101**
- 라이선스 **LGPL-2.1** · 저장소 `libhangul/libhangul`
- 생성 **2011-11-03** · 마지막 push **2026-02-01**

**15년째 유지되고 있고 포크가 101개**입니다. 여러 입력기가 이걸 바탕으로 만들어졌습니다.

입력기가 어려운 이유:
한글은 **자음과 모음이 모여 한 글자가 됩니다.** 타이핑 중에는 글자가 계속 변하고(ㅎ → 하 → 한 → 한ㄱ → 항), 어디서 글자가 끝나는지 판단해야 합니다. 이걸 **오토마타**라고 부릅니다.

여기에 두벌식·세벌식, 옛한글, 조합 중 삭제 규칙까지 붙습니다. **직접 만들면 예외가 끝없이 나오는** 영역이라 검증된 구현을 쓰는 것이 정석입니다.

그리고 입력기는 **OS와 밀접하게 붙습니다.** 라이브러리가 오토마타를 처리해도 리눅스·macOS·윈도우 각각의 입력 프레임워크에 연결하는 일은 따로 남습니다. 라이브러리 하나로 입력기가 완성되지는 않습니다.

함께 볼 한글 처리 오픈소스:
- Hangul.js·es-hangul: 자바스크립트 자모 처리
- go-hangul: Go용 한글 처리
- SokIM: macOS 한글 입력기
- Josa.js: 조사 판별

**libhangul만 “입력되는 순간”을 다룹니다.** 나머지가 이미 완성된 글자를 다룬다면, 이쪽은 아직 조합 중인 상태를 처리합니다. 층이 하나 더 아래에 있습니다.

타겟 사용자:
- 한글 입력기를 만들거나 고치는 개발자
- 임베디드·키오스크에 한글 입력을 넣어야 하는 사람
- 한글 오토마타 구현을 배우려는 학습자
- (LGPL 조건 확인이 선행돼야 합니다)

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/libhangul)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt