KeyboardTester Logo
⚙️

Mechanical Keyboard Test — Check Every Switch

Test every switch on a mechanical keyboard and watch the per-key press count, so a switch firing twice from one tap shows up immediately.

READY
Press or tap any key
Live Key Display
Tested0/104Presses0Max Simultaneous0Progress0%
Tap keys on screen or swipe to view full layoutScroll ↔

Press physical keys or tap virtual keys above. Hover over keys for JavaScript keycode data.

Health Summary
Status Not Started
Keys Tested0 / 104
x

Total Presses

0

Max Rollover

0

Not Tested

Press Count per Key

Press keys to see counts

Key History

What to look for when testing individual switches

The advantage of a mechanical keyboard when something goes wrong is that the fault is almost always confined to one switch, and one switch is a repairable unit. A membrane keyboard with a dead key is usually a keyboard to replace. A mechanical keyboard with a dead key is a five-minute job on a hot-swap board and a soldering job on everything else. So the goal of testing here is narrower than on other layouts: find the specific switch, and work out which of the handful of switch failures you are looking at.

The panel beside the layout counts presses per key, which is what makes the most common mechanical fault visible. Tap a key once, firmly, and watch its count. If it goes up by two, the switch is chattering — the metal leaf inside is bouncing on contact and the controller is reading each bounce as a keystroke. Every mechanical switch bounces; the firmware normally hides it with a debounce window, typically around five milliseconds. A switch chatters when its bounce outlasts that window, which happens as contacts oxidise, pick up contamination, or lose spring tension with age.

For the actual millisecond figures, the double typing test measures the gap between the two events and tells you whether it is inside or outside a plausible debounce window — useful evidence before you replace anything. If you want to hear what a switch type sounds like before buying, the keyboard sound test plays the common profiles.

Work across the board row by row rather than jumping to the key you suspect. A single misbehaving switch and a whole dead row mean different things: switches fail individually, but a row failing at once points at the controller or a trace, and no amount of switch swapping will fix that.

Key Capabilities & Features

Per-Key Press Count

A live count for each key, so a switch registering twice from one deliberate tap is immediately obvious.

Timestamped Event History

Every keydown and keyup logged in order with its timestamp, which is what you need to see a double event rather than infer it.

Full Board Coverage

A complete 104-key layout with a health summary, so you can sweep every switch and see what you have not reached.

Any Switch Technology

Linear, tactile, clicky, silent, optical and magnetic Hall effect switches all send standard key codes and register identically here.

Hot-Swap Verification

Test a freshly installed switch straight away, which catches the bent pin that causes most hot-swap failures.

Works With Custom Firmware

Reads the code your controller actually sends, so QMK and VIA remaps show up as they are, not as the legends claim.

How to Perform This Test

  1. Chatter check: tap one key once, firmly and deliberately, and watch its row in the press count panel. A single tap should increment by exactly one.
  2. Repeat on the suspect key: tap it ten times and confirm the count reads ten. Intermittent chatter will not show on every press, so one clean tap is not proof.
  3. Full board sweep: work row by row from the top left, watching the health summary climb rather than the individual keys.
  4. Check the large keys separately: Space, Enter, both Shifts and Backspace sit on stabilisers, and an off-centre press on a poorly stabilised key can fail to actuate.
  5. Test the modifiers on both sides: left and right Shift, Control and Alt are separate switches, and it is easy to confirm one and assume the other.
  6. Read the event history for anything odd: a keydown with no matching keyup, or two keydowns in quick succession, is the pattern worth chasing.

Troubleshooting Common Hardware Issues

  • One key registers twice from a single press: that is chatter. On a hot-swap board, pull the switch and try it in a different socket — if the fault moves with the switch it is the switch, and if it stays in the socket the problem is the socket. Cleaning sometimes works: a drop of isopropyl alcohol into the switch housing with the stem actuated repeatedly can clear contamination off the leaf.
  • A newly installed hot-swap switch does nothing: almost always a bent pin. Pull it out and look at both legs side on — they bend on insertion far more easily than people expect, and a bent pin folds under the switch instead of entering the socket. Straighten with tweezers and reinsert.
  • A switch works when pressed hard or dead centre only: the stem or the stabiliser is binding. Check the keycap is fully seated, then check the stabiliser wire is properly clipped in on the large keys.
  • Raising the debounce window can mask chatter without fixing it: QMK defaults to about five milliseconds, and increasing it will stop the double keystrokes at the cost of a slightly less responsive key. It is a legitimate stopgap on a soldered board, not a repair.
  • A whole row or column is dead: not the switches. Keys in a row share a trace, so suspect the controller, the trace, or on a split or wireless board the interconnect. Swapping switches here wastes time.
  • Optical and Hall effect switches behaving oddly: no metal contacts to clean, so look at dust in the light path or the sensor, and at the actuation point setting in the vendor software, which can be set so shallow that a resting finger triggers the key.
  • Keys send the wrong characters after a firmware flash: check your VIA or QMK keymap rather than the hardware. The event inspector shows the code the controller is actually sending, which settles it immediately.

Switch types, and what each one is for

Weights and travel distances vary between manufacturers; these are the common Cherry MX reference figures, which most other brands are built to match.

TypeFeelTypical examplesSuits
LinearSmooth all the way down, no bump, quiet-ish.Cherry MX Red and Black, Gateron YellowGaming, shared offices
TactileA distinct bump at the actuation point.Cherry MX Brown, Boba U4T, ZealiosTyping, mixed use
ClickyA bump plus a loud mechanical click.Cherry MX Blue, Kailh Box JadeTyping alone in a room
SilentLinear or tactile with dampening pads.Cherry MX Silent Red, Boba U4Calls, open-plan offices
OpticalLight beam instead of metal contact.Razer Optical, Gateron opticalLongevity, no contact chatter
Magnetic / HallAnalog travel, adjustable actuation.Wooting Lekker, SteelSeries OmniPointRapid Trigger, tuning

A standard MX-style switch actuates around 2 mm into roughly 4 mm of total travel, and is typically rated somewhere between 50 and 100 million presses. Those ratings are why a chattering switch at two years old is usually contamination rather than wear — the leaf has not been actuated anywhere near its limit.

Maintenance that is worth doing, and mods that are not repairs

Cleaning. Pull the keycaps with a wire puller, clear debris with compressed air held upright, and wipe the plate with isopropyl alcohol. Keycaps themselves can be washed in warm water with a little soap and left to dry fully. This is the whole of routine maintenance for most boards.

Stabilisers. The rattle on Space, Enter, Shift and Backspace is almost never a fault — it is the wire moving in its housing. A small amount of thick grease on the wire ends and a strip of tape under the stabiliser on the PCB quiet it considerably. Worth doing before concluding a large key feels wrong.

Lubricating switches. Improves smoothness and sound on linears and tactiles. One firm caution: do not lubricate the click mechanism of a clicky switch — the click is produced mechanically and lubricant kills it, permanently and irreversibly.

Keycap material, if legends are wearing off. ABS caps develop a shine with use and pad-printed legends rub away; PBT resists both, and doubleshot or dye-sublimated legends are moulded or dyed in rather than printed on top. Worth knowing when replacing caps, since it is the single clearest quality difference at a glance.

A note on 3-pin and 5-pin switches. Five-pin switches have two extra plastic legs for alignment, and some PCBs only accept three. The legs can be clipped off with flush cutters — a normal step in this hobby, not damage — but check your board before ordering.

None of these mods fixes a dead or chattering switch. Replace the switch for that, and use the double typing test to confirm the problem is gone afterwards rather than trusting the feel.

Frequently Asked Questions

What is key chatter?
Chatter is one physical press producing two or more keystrokes. Inside a mechanical switch a metal leaf closes a contact, and it bounces briefly as it lands — that is normal physics, and firmware hides it with a debounce window of roughly five milliseconds. A switch chatters when its bounce lasts longer than that window, which happens as the contacts oxidise, pick up contamination, or lose spring tension. It shows up here as a press count incrementing by two from one deliberate tap.
How do I fix a chattering switch?
On a hot-swap board, replace it — that is the reliable fix, and testing the suspect switch in a different socket first tells you whether the fault is the switch or the socket. Cleaning is worth trying: a drop of isopropyl alcohol into the housing while actuating the stem repeatedly can clear contamination off the leaf. On a soldered board without desoldering equipment, raising the debounce setting in QMK or the vendor software will suppress the symptom, though it does not repair the switch.
What is debouncing?
A short window during which the controller ignores further changes on a key after it registers one. Since every metal contact bounces on closing, without debouncing a single press would send several keystrokes. QMK defaults to about five milliseconds, which is long enough to swallow a healthy switch's bounce and short enough that nobody notices the delay. Raising it hides marginal chatter at the cost of a slightly less responsive key.
Does this test work with Hall effect and optical switches?
Yes. Optical switches interrupt a light beam and magnetic Hall effect switches sense a moving magnet, but both send ordinary USB HID key codes, so the page treats them exactly like a contact switch. Neither has metal contacts, so neither suffers contact chatter — if one of those keys misbehaves, look at dust in the light path or at the actuation point setting in the vendor software.
Can I test a custom QMK or VIA keymap?
Yes, and this is one of the better uses of the page. The inspector shows the code your controller is actually transmitting, independent of what the keycap says. If a remap has not applied, or a layer is stuck, the discrepancy is visible on the first press rather than after a confusing hour in a text editor.
A key I just hot-swapped does nothing. What went wrong?
Almost certainly a bent pin. Pull the switch and look at both legs from the side — they bend on insertion much more easily than people expect, and a bent leg folds underneath the switch rather than entering the socket. Straighten it with tweezers and reinsert with even pressure. If the switch then works in a different socket but not the original one, the socket itself has failed, which is a soldering repair.
How long should mechanical switches last?
Manufacturers rate MX-style switches somewhere between 50 and 100 million actuations, which is far more than most people will ever reach on any single key. That is why a switch chattering after a year or two is usually contamination rather than wear, and why cleaning is worth attempting before replacement.
Should I lubricate my switches?
It genuinely improves smoothness and sound on linear and tactile switches, and it is the most popular modification in the hobby for good reason. One firm exception: never lubricate the click mechanism of a clicky switch. The click is produced mechanically, lubricant deadens it, and the change cannot be undone.
Why do my Space and Enter keys rattle?
Those keys sit on stabilisers, and the rattle is the metal wire moving in its housing rather than anything failing. A little thick grease on the wire ends and a strip of tape on the PCB under the stabiliser quiet it substantially. It is a comfort issue, not a fault, and it has no effect on whether the key registers.

Further Reading

Related Tools