What is qmk via

Overview

VIA is a graphical configuration tool designed to work alongside QMK firmware, bridging the gap between advanced keyboard customization and user-friendly accessibility. While QMK firmware requires technical knowledge to modify key mappings and create macros through code, VIA provides a visual interface where users can make the same changes through simple point-and-click operations. This democratizes mechanical keyboard customization, enabling users without programming experience to create personalized keyboard layouts matching their specific needs.

Core Features

VIA's main interface displays a visual representation of the keyboard layout with each key clickable and remappable. Users can reassign any key to perform different functions, organize keys into multiple layers (similar to Shift or Alt modifiers), and program complex macros for automated keystroke sequences. Additional features include RGB lighting control to synchronize light patterns with layer switching, and customization of timing parameters for key behavior. The interface updates the keyboard in real-time without requiring a restart.

How VIA Works

VIA operates through a communication protocol built into compatible QMK firmware. When you launch VIA and connect a supported keyboard, it automatically detects the keyboard model and loads the appropriate layout file. Changes made through the VIA interface are sent directly to the keyboard's microcontroller using this protocol. Most QMK-enabled keyboards store VIA configurations in onboard memory, meaning your custom setup persists even when switching between computers.

Supported Keyboards

The VIA project maintains a public registry of supported keyboards, which includes hundreds of mechanical keyboard models from custom builders and mainstream manufacturers. Popular keyboards with built-in VIA support include the KBD67, Drop keyboards, Keychron models, and many community-designed keyboards available on platforms like GitHub and PCPartPicker. Keyboard designers can add VIA support to their products by implementing the required firmware protocol, expanding the ecosystem continuously.

Getting Started with VIA

Using VIA requires downloading the application from the official website, connecting a VIA-compatible QMK keyboard via USB, and opening the software. The interface automatically recognizes your keyboard and displays an interactive layout. Users can then click on individual keys to reassign them, switch between layers, or customize lighting settings. Configurations are typically saved automatically to the keyboard's memory, making VIA an efficient and immediate customization solution for keyboard enthusiasts.