Kontroll

프로그램 소개

Kontroll은 ZSA 키보드를 명령줄에서 제어할 수 있게 해주는 오픈소스 도구입니다. ZSA의 Keymapp API를 통해 키보드의 레이어, RGB LED, 상태 LED 등을 프로그래밍 방식으로 조작할 수 있으며, 이를 통해 시스템 이벤트에 반응하는 키보드 동작을 스크립트로 구현할 수 있습니다.

주요 기능

키보드 연결 및 상태 확인

사용자는 kontroll list 명령으로 연결된 키보드 목록을 확인하고, kontroll connect 또는 kontroll connect-any로 특정 키보드에 연결할 수 있습니다. kontroll status 명령으로 현재 연결된 키보드의 상태를 확인할 수 있습니다.

레이어 및 LED 제어

kontroll set-layer 명령으로 키보드의 레이어를 전환할 수 있으며, kontroll set-rgb 또는 kontroll set-rgb-all로 개별 또는 전체 LED의 RGB 색상을 설정할 수 있습니다. kontroll set-status-led로 상태 LED를 켜거나 끌 수 있습니다.

밝기 및 복원 기능

kontroll increase-brightness 및 kontroll decrease-brightness 명령으로 LED 밝기를 조절할 수 있으며, kontroll restore-rgb-leds 및 kontroll restore-status-leds 명령으로 LED 색상과 상태를 기본값으로 복원할 수 있습니다.

다운로드 및 설치 방법

최신 버전은 GitHub releases 페이지에서 다운로드할 수 있습니다. 다운로드 후 실행 파일을 PATH에 추가하면 터미널에서 kontroll 명령으로 사용할 수 있습니다. Rust 개발 환경이 갖춰진 경우 cargo build --release 명령으로 직접 빌드할 수도 있습니다.

기본 사용법

Kontroll은 서브커맨드 기반으로 동작합니다. 일반적인 사용법은 kontroll <COMMAND> 형태이며, kontroll help로 사용 가능한 모든 명령어를 확인할 수 있습니다. 예를 들어, kontroll list로 키보드 목록을 확인한 후 kontroll connect-any로 첫 번째 키보드에 연결하고, kontroll set-layer 1로 레이어를 전환할 수 있습니다.

이런 경우에 유용합니다

특정 애플리케이션이 실행될 때 자동으로 키보드 레이어를 전환하거나, 중요한 이메일을 받을 때 RGB LED 색상을 변경하여 시각적 알림을 제공하고자 하는 사용자에게 유용합니다. 스크립트에서 Kontroll을 호출하여 시스템 이벤트에 반응하는 키보드 동작을 구현할 수 있습니다.

지원 환경·시스템 요구사항

Kontroll은 Windows, Linux, macOS에서 실행할 수 있습니다. 사용 전에는 Keymapp(v1.3.2 이상)이 설치되어 있고 ZSA 키보드가 연결되어 있어야 하며, Keymapp의 설정에서 API가 활성화되어 있어야 합니다. Windows에서는 기본적으로 포트 50051을 사용하며, 포트를 변경한 경우 KEYMAPP_PORT 환경 변수로 지정할 수 있습니다.

제한 사항·확인 사항

ErgoDox EZ 모델은 다른 프로세서(Teensy)를 사용하기 때문에 RGB LED 제어 기능은 지원되지 않으며, 레이어 전환 및 상태 LED 제어만 가능합니다. 모든 기능은 Moonlander 및 Voyager 모델에서 완전히 지원됩니다.