Skip to content
프로젝트

Riey/kime has 633 GitHub stars and 70 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 07:51 UTC. Last push 2026-10-31.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
0
in 7 days
기록 수집 중
in 15 days
기록 수집 중
in 1 month
기록 수집 중

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

Korean IME

개발 도구

README.ko.md

Original

kime

한글 입력기

다른 언어로 보기

English, 한국어


build discord release version aur version license

Changelog

kime을 써야 하는 이유?

  • 잘 테스트된 입력 엔진
  • 빠른 속도
  • 적은 메모리 사용량
  • 대부분의 코드가 세그멘테이션 오류가 없는 Rust로 작성됨
  • 사용자 설정 자판 지원

궁금한 게 있으신가요?

디스코드 채널에 와서 연락하시거나 이슈를 올려주세요.

지원되는 프론트엔드

  • XIM
  • Wayland
  • GTK3
  • GTK4
  • Qt5
  • Qt6

설치

NixOS

이 코드를 configuration.nix에 추가해주세요

i18n = {
  defaultLocale = "en_US.UTF-8";
  inputMethod = {
    enable = true;
    type = "kime";
    kime.iconColor = "White";
    };
  };
};

아치 리눅스

최신 릴리스는 AUR의 kime에 있으며, 만약 소스에서 빌드하시려면 kime-git에서 설치할 수 있습니다.

데비안, 우분투

releases 탭에 있는 .deb 파일을 설치할 수 있습니다.

페도라

비공식 패키지가 Fedora Copr 에서 운영되고 있습니다.

dnf copr enable toroidalfox/kime
dnf install kime # 개발 버전은 `kime-git`

젠투

eselect repository add riey git https://github.com/Riey/overlay
eselect repository enable riey
emaint sync -r riey
emerge -av kime

오픈수세 (텀블위드)

zypper in kime

소스에서 빌드하기

도커

도커를 쓰시는 경우엔 따로 의존성을 설치하지 않아도 되어서 편리합니다.

git clone https://github.com/riey/kime
cd kime

docker build --file build-docker/<배포판 경로>/Dockerfile --tag kime-build:git .
docker run --name kime kime-build:git
docker cp kime:/opt/kime-out/kime.tar.zst .
# deb 파일을 얻으시려면 대신 이 명령어를 실행하세요
# docker cp kime:/opt/kime-out/kime_amd64.deb .

직접 빌드

빌드하기 전에 cargo, meson, ninja 및 아래 나열되어 있는 기타 종속성이 설치되어 있는지 확인하세요.

git clone https://github.com/Riey/kime
cd kime

meson setup build
ninja -C build
sudo ninja -C build install

필요한 프론트엔드만 -Dgtk3=true, -Dqt5=true 등으로 선택 또는 해제 하세요.

GTK

대부분 배포판들은 이걸 자동으로 해주므로

패키지로 설치하실 경우에는 필요 없을 수도 있습니다.

# GTK3 설치 시
sudo gtk-query-immodules-3.0 --update-cache
# GTK4 설치 시
sudo gio-querymodules /usr/lib/gtk-4.0/4.0.0/immodules

설정

데비안 계열

언어 설정에서 입력기 kime를 선택해주세요.

그 외

init 스크립트에 다음을 추가하세요.

export GTK_IM_MODULE=kime
export QT_IM_MODULE=kime
export XMODIFIERS=@im=kime

만약 X를 사용하신다면 .xprofile에 설정하시면 됩니다.

Wayland에서 zsh를 쓰는 데비안/우분투

kime의 deb 패키지는 im-config과 연동되지만, Wayland에서는 im-config 설정이 /etc/profile.d/im-config_wayland.sh를 통해 적용되는데 zsh는 /etc/profile을 읽지 않기 때문에 이 파일이 실행되지 않습니다. 다음 중 하나로 해결할 수 있습니다.

  • /etc/zsh/zprofile에 emulate sh -c 'source /etc/profile' 추가

  • im-config 대신 ~/.config/environment.d/kime.conf 파일을 만들어 다음 내용 넣기:

    GTK_IM_MODULE=kime
    QT_IM_MODULE=kime
    XMODIFIERS=@im=kime
    

    이 방법은 셸과 무관하며 Wayland 세션에서 환경 변수를 설정하는 올바른 방법입니다.

#423을 참고하세요.

추가적인 서버를 실행

kime은 kime 데몬을 위한 kime.desktop 파일을 /etc/xdg/autostart에 설치합니다

혹시 i3나 sway처럼 시작 프로그램을 지원하지 않는다면 해당 WM의 설정파일에서 kime 혹은 원하시는 서버 커맨드를 실행해주세요

KDE Plasma Wayland

시스템 설정 > 입력과 출력 > 키보드 > 가상 키보드에서 kime 데몬을 선택해야 합니다. 이후에 로그아웃 후 재로그인을 하는 것을 권장합니다.

GNOME Wayland

Mutter는 zwp_input_method_v2와 v1 중 어느 것도 구현하지 않기 때문에 GNOME Wayland 세션에서는 kime-wayland가 동작하지 않습니다. GTK/Qt 앱은 kime의 입력기 모듈을 통해 계속 사용할 수 있지만, Wayland 네이티브 앱이나 샌드박스 앱에서는 입력할 수 없습니다. #422에서 추적하고 있습니다.

Weston

~/.config/weston.ini에 해당 내용이 있어야 합니다.

[input-method]
path=/usr/bin/kime

샌드박스 앱 (snap, flatpak)

snap이나 flatpak 샌드박스 안에서는 kime의 GTK/Qt 입력기 모듈을 불러올 수 없습니다. 샌드박스가 자체 GTK/Qt 런타임을 포함하고 있어서 GTK_IM_MODULE=kime, QT_IM_MODULE=kime이 불러올 모듈이 없기 때문입니다. 가장 흔한 경우는 우분투 22.04 이상에서 snap으로 기본 설치되는 파이어폭스로, 한글 입력이 필요하다면 mozilla.org 빌드를 사용하는 것을 권장합니다.

다만 zwp_input_method_v2를 구현한 Wayland 컴포지터(KDE Plasma, sway 등 wlroots 계열)에서는 text-input-v3를 사용하는 샌드박스 앱도 컴포지터를 통해 입력이 되므로, 이 문제는 주로 X11 세션과 GNOME에서 발생합니다. #346, #422를 참고하세요.

Configuration

자세한 옵션은 CONFIGURATION.md를 참고하세요.

종속성 목록

런타임 종속성

참고로 필요하신 종속성만 있으면 됩니다 예를 들어 qt6를 사용하지 않으신다면 필요하지 않습니다.

  • gtk3
  • gtk4
  • qt5
  • qt6
  • libdbus (indicator)
  • xcb (candidate)
  • fontconfig (xim)
  • freetype (xim)
  • libxkbcommon (wayland)

빌드타임 종속성 (바이너리 실행 시엔 필요 없습니다)

필수

  • meson
  • ninja
  • cargo
  • libclang
  • pkg-config

선택적

  • gtk3
  • gtk4
  • qtbase5-private
  • qtbase6-private
  • libdbus
  • xcb
  • fontconfig
  • freetype
  • libxkbcommon