QMK 키보드 테스터

온라인 QMK 키보드 테스트 도구 소개

이 QMK 키보드 테스터는 기계식 키보드 사용자와 펌웨어 개발자를 위해 만든 브라우저 기반 QMK 전용 테스트 도구입니다. 일반적인 키보드 테스터와 달리 레이어 개념을 이해하고, 레이어별 라벨·NKRO·이벤트 로그까지 한 번에 보여 줍니다. 한국 사용자도 쉽게 사용할 수 있도록 인터페이스와 설명을 모두 한국어로 구성했습니다.

“비디오 카드 검사기”, “알바 모집 사이트”처럼 다른 하드웨어 도구나 구직 사이트와는 전혀 관계가 없습니다. 이 페이지는 오직 QMK 키보드의 키 입력, 레이어, 회로 상태를 확인하기 위한 전문 테스트 도구입니다.

왜 브라우저 기반 QMK 테스터인가요?

브라우저에서 실행되기 때문에 설치가 필요 없고, Windows · macOS · Linux · ChromeOS 어디서나 빠르게 열어 사용할 수 있습니다. 펌웨어를 빌드하거나 레이어를 수정할 때, 이 페이지를 옆에 띄워 두고 바로 테스트하면 디버깅 시간이 크게 줄어듭니다.

개인정보 및 한계

이 QMK 키보드 테스터는 100% 클라이언트 사이드로 동작하므로, 키 입력 데이터가 서버로 전송되지 않습니다. 다만 운영체제가 가로채는 시스템 단축키(예: Alt+Tab)나 일부 미디어 키는 브라우저에 전달되지 않을 수 있습니다. 훨씬 더 낮은 수준의 USB 트레이스가 필요하다면 QMK 콘솔 로그나 별도의 하드웨어 로직 애널라이저와 함께 사용하는 것을 권장합니다.

개발 메모

내부적으로는 keydown / keyup 이벤트를 사용하여 event.code 값을 ANSI 레이아웃에 매핑합니다. 레이어 라벨은 현재 세션 메모리에 저장되며, JSON 파일로 내보내기·가져오기가 가능합니다. HTML·CSS·바닐라 자바스크립트만 사용했기 때문에, 이 파일을 /QMKKeyboardTester/ko/index.html 경로에 바로 업로드해도 문제 없이 작동합니다.

자주 묻는 질문 (FAQ)

Q. QMK 키보드를 온라인에서 테스트하려면 어떻게 하나요?

이 페이지를 연 뒤 입력 감지 시작을 누르고 키를 눌러 보세요. 가상 키보드에 해당 키가 밝게 표시되고, 아래 이벤트 로그에 시간·이벤트·코드·레이어 정보가 기록됩니다.

Q. NKRO(무한 동시 입력)도 확인할 수 있나요?

가능합니다. 여러 키를 동시에 누르면 우측 상단 “최대 동시 입력”값이 증가합니다. 이 값은 브라우저와 OS가 인식한 수준의 NKRO를 보여 주며, 실제 이론적인 한계와 다를 수 있습니다.

Q. 펌웨어를 플래시하지 않고 테스트할 수 있나요?

네. 이 QMK 키보드 테스터는 현재 OS에서 보고하는 키 이벤트만 읽어옵니다. 펌웨어를 변경하지 않으므로 안심하고 테스트할 수 있습니다.

Q. Windows, macOS, Linux 모두 지원하나요?

최신 크롬, 엣지, 파이어폭스, 사파리 같은 현대적인 브라우저에서 잘 작동합니다. 일부 시스템 단축키는 OS에서 먼저 처리하기 때문에 로그에 나타나지 않을 수 있습니다.

Q. 이 도구는 무료인가요?

네. MouseTest.online에서 제공하는 다른 마우스·키보드 도구들과 마찬가지로, QMK 키보드 테스터도 완전히 무료이며 계정 생성이나 로그인 없이 사용할 수 있습니다.

Q. 라벨이나 설정을 저장할 수 있나요?

매핑 내보내기 버튼을 이용하면 현재 레이어 라벨 구성을 JSON 파일로 저장할 수 있습니다. 이후 다른 브라우저나 PC에서 매핑 가져오기에 JSON을 붙여넣으면 동일한 구성을 복원할 수 있습니다.