komokana

자동 레이어 전환

실행 중인 애플리케이션의 창이 활성화될 때 미리 정의된 규칙에 따라 kanata 키보드 레이어를 자동으로 전환합니다.

세부 규칙 설정

실행 파일 이름, 창 제목, 가상 키 상태에 따라 전환 규칙을 세밀하게 지정할 수 있습니다.

레이어 상태 표시

-t 플래그로 실행하면 레이어 변경 시 임시 폴더에 텍스트 파일을 업데이트하여 yasb 위젯 등에서 현재 레이어를 표시할 수 있습니다.

사전 요구 사항

• komorebi 최신 버전 (scoop 또는 WinGet으로 설치)
• kanata 최신 버전 (cargo install kanata)

설치 방법

WinGet을 사용하는 경우 다음 명령으로 설치할 수 있습니다:

winget install LGUG2Z.komokana

Scoop을 사용하는 경우:

scoop bucket add extras
scoop install komokana

GitHub Releases에서 zip 아카이브를 다운로드하여 komokana.exe를 PATH에 포함된 디렉터리로 이동할 수도 있습니다.

실행

komorebi와 kanata가 실행 중이어야 하며, kanata는 --port 플래그로 TCP 서버를 활성화해야 합니다. 그런 다음 PowerShell에서 다음 명령으로 실행합니다:

komokana -p [KANATA_PORT] -d [DEFAULT_LAYER] -c [PATH_TO_YOUR_CONFIG]

구성

YAML 파일로 구성하며 -c 플래그로 지정합니다. 예를 들어, firefox.exe가 활성화되면 ‘firefox’ 레이어로 전환하고, 창 제목이 특정 문자열로 시작하면 다른 레이어로 전환하는 규칙을 정의할 수 있습니다.

지원 환경

Windows 10 이상에서 동작하며, x64 아키텍처용 바이너리가 제공됩니다. 소스에서 빌드하려면 Rust 개발 환경(x86_64-pc-windows-msvc 툴체인)이 필요합니다.

버전 및 업데이트

현재 버전은 0.1.6이며, 2026년 3월 21일에 릴리스되었습니다. 버그 수정, 기능 개선, 의존성 업데이트가 포함되어 있습니다.

라이선스 및 제한 사항

komokana는 Komorebi 2.0.0 라이선스로 배포됩니다. 이 라이선스는 개인적 사용을 허용하지만 재배포나 상업적 사용을 금지합니다. 자세한 내용은 저장소의 LICENSE.md를 참조하세요.