Keyboard Tester
Professional online keyboard testing tool supporting multiple mechanical keyboard layouts and display styles. Real-time key response detection helps test keyboard functionality, troubleshoot issues, and familiarize yourself with different layouts.
Keyboard Layouts
The tool supports mainstream mechanical keyboard configurations, from compact to full-size:
Compact Layouts
- 40%: Ultra-compact, 40-50 keys
- 45%: Balanced portability and practicality
- 60%: Standard compact layout without arrow keys and function keys
- 60% HHKB: HHKB signature layout with unique Control key placement
- 60% WKL: Winkeyless 60% layout without Windows keys
- 65%: 60% plus arrow keys and navigation cluster
Standard Layouts
- 75%: Compact layout retaining function keys
- 80% TKL: Tenkeyless full-size keyboard without numpad
- 95%: Near-complete keyboard layout
- 100%: Full-size keyboard with all keys
After selecting the corresponding layout, the page displays a virtual keyboard of that configuration. When you press a physical key, the corresponding virtual key highlights.
Display Styles
Cherry Profile
Standard keycap character display supporting sublegends (such as function layer indicators).
SA Profile
Rounded spherical keycap style with centered characters, no sublegend support.
Sublegend Options
In Cherry style, additional keycap markings can be displayed:
- None: No sublegends displayed
- Function Layer: Function layer indicators
- Vim Layer: Vim editor shortcuts
- Media Layer: Media control keys
- Navigation Layer: Navigation function keys
- Other Custom Layers: Based on keyboard firmware configuration
Sublegends are typically marked in the bottom-right corner of keycaps, used for keyboards with multi-layer key mappings.
How to Use
- Select the layout matching your keyboard
- Choose your preferred character display style
- If sublegends are needed, select the corresponding type
- Press any key on your keyboard
- The corresponding virtual key will highlight (darker gray)
- Test all keys one by one to check response
- Click the "Fullscreen" button for fullscreen display
Use Cases
Functionality Testing
- Comprehensive testing after new keyboard arrival
- Check if keys respond normally
- Verify all key functions are intact
- Validation after DIY keyboard assembly
Troubleshooting
- Detect malfunctioning or poorly-contacted keys
- Identify specific key issues
- Verify functionality restoration after cleaning
- Locate keyboard hardware failures
Learning and Research
- Familiarize yourself with new keyboard layouts
- Understand differences between various configurations
- Learn about mechanical keyboard knowledge
- Showcase keyboard layout characteristics
Technical Features
- Real-time key response detection
- Supports standard QMK keycode mapping
- Multiple layout and style switching
- Fullscreen mode for optimized display
- Pure frontend implementation, no key logging
Usage Instructions
Focus Requirement
Page must have focus before testing. Click anywhere on the page to ensure focus.
Key Highlighting
Virtual keys turn dark gray when pressed, returning to normal color when released.
Special Keys
Some system shortcuts (such as Alt+F4, Ctrl+W) may be intercepted by the browser or system and cannot trigger test effects.
Input Field Exclusion
Keypresses in text boxes or input areas will not trigger testing. Click other areas first.
Fullscreen Display
Fullscreen mode provides clearer observation of key effects, suitable for demonstrations and detailed inspection.
Compatibility
Supported Browsers
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Safari
Platform Limitations
This tool is for desktop use only and does not support mobile devices. Browser must support keyboard event API.
Keycode Standards
Uses standard QMK keycode mapping, compatible with mainstream mechanical keyboard firmware.
Privacy Protection
- Runs completely locally in the browser
- Does not record or upload any keypress information
- Does not collect keyboard usage data
- Safe and reliable local tool
Notes
- Ensure the test page has keyboard focus
- Avoid testing in input fields
- Some system shortcuts cannot be detected
- Modern browsers recommended
- Desktop use only