Every keyboard runs firmware: a small program on its microcontroller that scans the switches and tells your computer which keys are pressed. On most keyboards that firmware is closed and fixed, and any remapping happens in vendor software on your computer. QMK replaces it with open-source firmware you can configure, and the configuration lives on the keyboard itself. Plug the board into another computer and your layout comes with it, no software needed.
The three names
QMK (Quantum Mechanical Keyboard) is the firmware. It supports a very large number of keyboards and a long list of features. Changing it the traditional way means editing a keymap, compiling the firmware and flashing it to the board.
VIA is a configurator. If a board runs QMK built with VIA support, the VIA app can change the keymap live: click a key, choose what it should do, done. No compiling, no flashing. VIA is available as a web app in Chromium-based browsers and as a desktop app.
Vial is a fork of QMK with its own configurator that exposes more advanced features without recompiling. Some boards ship with Vial instead of VIA.
What you can do with it
Remap any key. Move Caps Lock to Control or Escape, put Delete where you want it, swap modifiers for macOS. This alone justifies the feature for many people.
Layers. A layer is a second (or third, or fourth) keymap you reach by holding a key. Small keyboards depend on layers: on a 60%, the arrows, function keys and navigation usually live on a layer. With QMK you decide exactly where. See our layout guides for 60% and 40% boards to see how much depends on them.
Mod-tap. One key, two jobs: tap it for a letter, hold it for a modifier. A common setup puts Control under the A key when held, or Escape on Caps Lock when tapped and Control when held.
Tap dance and combos. Tap dance gives a key different actions for one, two or three taps. Combos trigger an action when two keys are pressed together. Both are popular on very small boards. Availability in the configurator depends on whether you use VIA or Vial.
Macros. Send a sequence of keys from one key press. Useful for repetitive text and shortcuts.
How to check if your keyboard supports it
- Look for "QMK", "VIA" or "Vial" on the product page or the maker's site.
- Open the VIA web app in Chrome or Edge and try to connect the keyboard.
- Check the QMK repository's list of supported keyboards if you are comfortable flashing firmware yourself.
Many enthusiast boards support VIA out of the box. Many mass-market gaming keyboards do not, and use vendor software instead.
Debounce and key chatter
Mechanical switch contacts bounce for a moment when they close, and firmware waits a few milliseconds before trusting the signal. This waiting period is called debounce. If a switch is worn or dirty, its contacts can bounce for longer than the debounce window, and one press produces two characters. That is key chatter.
QMK lets you change the debounce time and algorithm. Raising it slightly can hide chatter on a worn switch, at the cost of a few milliseconds of delay. It is a workaround rather than a fix; a chattering switch is usually on its way out. Use the chatter test to see which keys double fire, and read key chatter explained for causes and fixes.
VIA vs vendor software
- VIA: settings stored on the keyboard, works on any computer, no background software.
- Vendor software: often adds lighting and macro features, but may need to run in the background and usually stores some settings on the computer.
If you remap with vendor tools or with operating system utilities, remember that those can intercept keys. If a key seems dead, check that no remapping software is running before assuming a hardware fault. Our fix a key guides cover this.
Test your keymap
After remapping, open the keyboard tester and press each changed key to check that it sends what you expect. The tester shows the key code each press produces. Note that the Fn key and layer keys are handled inside the keyboard and never reach a website on their own; you will only see the key they produce in combination.
Frequently asked questions
What is the difference between QMK and VIA?
QMK is the open-source firmware that runs on the keyboard's microcontroller. VIA is a configurator app that talks to keyboards running VIA-enabled QMK firmware and lets you change the keymap live, without compiling or flashing anything. You need QMK (with VIA support) on the board to use VIA.
How do I know if my keyboard supports VIA?
Check the product listing or the maker's site for "QMK/VIA" support. You can also open the VIA web app in a Chromium-based browser and connect the keyboard: if it is detected, it is supported. Some boards need a definition file from the maker loaded into VIA first.
Is VIA safe to use?
VIA changes the keymap stored on the keyboard; it does not install drivers on your computer. Remapping is easy to undo, and most boards let you reset the keymap to default. Flashing new firmware is the riskier operation, and VIA does not do that.
What is Vial?
Vial is a fork of QMK with its own configurator. It exposes more features than VIA without recompiling, such as tap dance, combos and more detailed settings, and it is supported by a growing number of boards and custom firmware builds.
Keep learning
- How to choose a mechanical keyboard.
- Split and ergonomic keyboards: where layers matter most.
- What is NKRO?