Key Chatter Test
Diagnose keyboard double typing and switch bounce instantly. Press any key to start — chattering keys are flagged in real-time with timing data. Adjust the threshold, review the visual heatmap, and export results for warranty claims.
Chatter Log
| # | Key | Interval (ms) | Status |
|---|---|---|---|
| Press any key to begin testing... | |||
What is Key Chatter?
Key chatter (switch bounce) is a mechanical keyboard defect where a single keypress registers as two or more inputs. It's caused by worn metal contacts inside the switch that "bounce" — making and breaking the circuit multiple times within milliseconds.
How to Test
- Set the threshold to 50-80ms (recommended).
- Tap the suspicious key — each press is logged with timing.
- Keys with detected chatter glow red on the heatmap.
- Export CSV for warranty claims or documentation.
Common Causes
| Cause | Description | Fix |
|---|---|---|
| Dust & Debris | Particles between contacts | Compressed air, keycap removal |
| Contact Oxidation | Metal contacts corrode over time | Isopropyl alcohol cleaning |
| Physical Wear | Heavy use degrades contacts | Switch replacement (hot-swap) |
| Moisture Damage | Liquid spills cause erratic contacts | Thorough drying, switch replacement |
| Low Debounce | Firmware debounce set too low | Increase to 10-15ms in firmware |
How to Fix
- Compressed air — blow into the switch while clicking to clear debris.
- Isopropyl alcohol (90%+) — drop into switch, press repeatedly, dry fully.
- Increase debounce — set to 10-15ms via QMK/VIA/manufacturer software.
- Replace switch — pull and swap on hot-swap boards; desolder on fixed boards.
Frequently Asked Questions
What threshold should I use?
50-80ms is ideal. Healthy switches bounce for ~5ms, so any double input faster than 50ms is almost certainly a hardware fault.
Is key chatter covered by warranty?
Yes. Export the CSV results as proof for an RMA request to brands like Logitech, Corsair, Razer, or SteelSeries.
Can software fix chatter permanently?
Software debounce masks the issue temporarily but doesn't fix the hardware. Over time, chatter typically worsens — cleaning or replacing the switch is the permanent fix.