Keyboard chatter: how to confirm it and what actually fixes it

A key that types twice from one press is almost always a switch bouncing past the firmware's debounce window. How to prove it in a minute, and the fixes in the order worth trying.

Published 2026-10-27

What chatter is, mechanically

A mechanical switch closes a circuit with two metal contacts. When they meet they do not settle cleanly: they bounce apart and together several times over the first few milliseconds. Every keyboard expects this and runs a debounce filter in its firmware that ignores changes for a short window after the first contact.

Chatter, also called double-stroke, is what happens when the bouncing outlasts that window. The keyboard sees the contact open and close again after the filter has already let the first press through, and reports a second press you never made. Dirt, oxidation on the contacts, a worn contact leaf or a splash of something sugary all make a switch bounce for longer.

Rule out the three things that look like it

• Auto-repeat. Holding a key makes your operating system repeat it after a delay. That is normal, and it only happens while the key stays down.
• Ghosting and rollover limits. These lose presses when several keys are held together. They never add one, so a keyboard that drops letters in fast combos has a different problem; check it with the Key Rollover test.
• Software doubling. A macro tool, a remote-desktop session or a misbehaving input driver can duplicate keystrokes too. If the doubling follows you to a second keyboard, the keyboard is not the cause.

Confirming it in a minute

Open the Key Chatter Tester, click into the test area and type normally for a while, then press the suspect key on its own a few dozen times at a natural pace. The tester records the gap between two presses of the same key and flags any second press that lands under its threshold (50ms by default).

Real chatter usually shows up as a gap of a few milliseconds to a few tens of milliseconds, far quicker than a finger can deliberately press the same key twice. If a key is flagged once in a hundred presses, it is starting to fail. If it is flagged every few presses, it has failed. Lower the threshold if fast, deliberate double letters are being flagged while you type, and raise it if a key you know is faulty slips through.

Test the keys you use most. Chatter tends to appear first on the space bar, E, A and the other letters that take the most presses.

The fixes, in the order worth trying

• Clean it. Pull the keycap, blow compressed air into the switch from a few angles, then press the switch quickly fifty to a hundred times. Working the contacts often wipes off the film that was making them bounce. Retest before doing anything else.
• Lengthen the debounce window. Some vendor apps expose a debounce or "chatter protection" setting. On keyboards running QMK firmware it is the DEBOUNCE value in milliseconds, 5 by default; raising it to 10 or 15 hides most chatter at the cost of a few milliseconds of input delay that nobody can feel while typing.
• Swap the switch. On a hot-swap board this takes a minute with a switch puller, and a spare switch is cheap. On a soldered board it means desoldering, or trying a contact cleaner sprayed into the switch before going that far.
• Use the warranty. Chatter inside the first year or two on a premium keyboard is a defect, not wear, and most manufacturers treat it that way.

What not to rely on

Operating systems include accessibility filters that ignore repeated keystrokes, such as Filter Keys on Windows. They work against chatter, but their shortest window is measured in tenths of a second, so they also swallow deliberate double letters like the "ee" in "keep". They are a stopgap for a keyboard you cannot fix yet, not a fix.

The same physics applies to mice: a worn switch that double-fires is chatter in a mouse button, and the Double-Click Tester measures it the same way.

Tools used in this guide