⌨️ 키 테스트 — 수동입력
- 풀사이즈 104키 + 한국어 키보드 레이아웃 표시
- 누르는 중은 앰버, 확인된 키는 초록
- 진행률 바 — 전부 누르면 완료 배너
- 테스트 중에는
Win·Alt+Tab·Alt+F4가 실제로 동작하지 않음 - 키 입력 히스토리, 미매핑 keycode 패널
키보드의 모든 키,
제대로 눌리는지 확인하세요
Windows 키·한/영·Fn 키까지. 설치 없이 실행하는 포터블 키보드 테스터.
VIA / Vial 키보드는 스위치 매트릭스 테스트와 키 매핑 변경까지 지원합니다.
기능
메뉴는 키 테스트와 매핑 변경 두 가지. 키 테스트는 VIA(기본)와 수동입력 방식으로 나뉩니다.
모든 키보드
VIA / Vial 키보드
🔌 키 테스트 — VIA 매트릭스
- 키보드 스위치 매트릭스를 raw HID로 직접 읽어 Fn 키·리매핑된 키도 확인
- Alice 등 회전 키를 포함한 실제 배열을 그대로 표시
- 공식 VIA 정의 약 2,000종 자동 인식, Vial은 키보드에서 레이아웃 직접 읽기
- 화면에 들어가면 키보드에 자동 연결
VIA / Vial 키보드
🎛️ 매핑 변경
- 레이어별 키맵을 실제 배열 위에 표시하고 클릭으로 변경
- 수정키 조합, 레이어, 미디어, 조명 키, 16진수 키코드 직접 입력
- 변경은 키보드에 즉시 저장 — 다른 PC에서도 유지
- 첫 변경 전 자동 백업, 언제든 복원 / 펌웨어 기본값 되돌리기
- 부트로더·EEPROM 초기화 키는 지정 불가 (안전장치)
사용법
설치가 필요 없습니다. 받아서 바로 실행하세요.
다운로드
아래 버튼으로 키보드테스트.zip을 받아 압축을 풉니다.
실행
KeyboardTester.exe를 더블클릭. SmartScreen 경고가 뜨면 추가 정보 → 실행.
모든 키 누르기
키를 하나씩 누르면 화면의 키가 초록색으로 바뀝니다.
결과 확인
100%가 되면 정상. 안 바뀌는 키가 있다면 그 키가 문제입니다.
💡 VIA / Vial 키보드라면 상단에서 VIA 방식을 고르면 자동 연결됩니다.
Vial 키보드는 매트릭스 테스트 전에 화면에 강조된 키를 눌러 잠금 해제하세요.
목록에 없는 VIA 키보드는 정의 JSON 파일을 한 번 불러오면 다음부터 자동으로 인식합니다.
지금 바로 테스트하세요
무료 · 오픈소스 · 설치 불필요
⬇ 키보드테스트.zip 다운로드- 🪟 Windows 10 / 11 (64bit)
- 📦 압축만 풀면 바로 실행되는 포터블 exe
- 🔒 키보드 장치 정보 외부 전송 없음
자주 묻는 질문
왜 웹사이트가 아니라 프로그램인가요?
브라우저는 보안 샌드박스 때문에 Windows 키, 시스템 단축키 등 일부 키를 받을 수 없습니다. 이 앱은 OS 저수준 키보드 훅으로 모든 키를 포착합니다.
Fn 키가 감지되지 않아요.
Fn 키는 키보드 펌웨어에서 처리되어 OS까지 전달되지 않습니다. VIA / Vial 키보드라면 VIA 방식 테스트에서 확인할 수 있습니다.
인터넷 연결이 필요한가요?
필요 없습니다. VIA 정의 동기화를 위해 하루 한 번 GitHub에서 공개 정의 아카이브(약 1.6MB)를 받으며, 오프라인이면 기존 사본을 씁니다. 연결한 키보드의 VID/PID 등 장치 정보는 어디에도 전송하지 않습니다.
매핑 변경이 잘못되면 어떻게 하나요?
첫 변경 전에 현재 키맵이 자동 백업되며, 언제든 백업으로 복원하거나 펌웨어 기본값으로 되돌릴 수 있습니다.
미디어 키가 화면에 표시되지 않아요.
수동입력 화면의 "미매핑 키" 패널에서 해당 키의 keycode를 확인할 수 있습니다.