What You Can Configure with Vial

Updated

Vial is an open-source, cross-platform (Windows, Linux, Mac) GUI and a QMK fork for configuring a compatible keyboard in real time. You can configure layers and keymaps, advanced behaviors such as macros, Tap Dance, Combos, and Alt Repeat Key, QMK settings, Any Key and custom keycodes, backlight and RGB lighting, and rotary encoders. The prerequisite is that the keyboard runs Vial-compatible firmware; if it did not ship with one, you install it first, and the Vial GUI detects the keyboard automatically.

Layers and key mapping

Vial's core job is remapping what each key does across layers. The manual lists Layers as a primary section, so you can assign keys per layer and switch between them rather than being limited to a single fixed layout. This is the starting point for most users: change a key, test it, and adjust.

Advanced key behaviors

Beyond simple remapping, Vial exposes several QMK behaviors through its GUI:

  • Macros — record or define sequences that run from a single keypress.
  • Tap Dance — assign different actions depending on whether a key is tapped, held, or tapped multiple times.
  • Combos — trigger an action by pressing several keys together.
  • Alt Repeat Key — repeat the previous key with an alternate output.
  • Any Key — enter a keycode directly when it is not available in the standard picker.

These are documented as separate manual entries, which is a useful signal: each behavior has its own configuration surface in the GUI rather than being buried in one generic editor.

QMK settings and custom keycodes

Because Vial is a QMK fork, it also exposes QMK Settings in the GUI, letting you adjust firmware-level options without rebuilding from source. Custom Keycode support is listed separately, so you can define your own keycodes where the built-in set is insufficient. For users porting a keyboard, the manual includes a porting guide and a JSON creation step, but that is a firmware-development task rather than everyday configuration.

Lighting and rotary encoders

Backlight and RGB lighting have dedicated support, and rotary encoder support is documented as its own topic. If your keyboard has a knob or an illuminated PCB, check those manual sections before assuming the feature is configurable — support depends on the hardware and the firmware build.

Practical notes before you start

  • Firmware first. Install a Vial-compatible firmware if your keyboard did not come preloaded with one; the GUI then detects it automatically.
  • Linux permissions. The manual includes a section on configuring udev on Linux, which is the usual stumbling block when the GUI cannot see the keyboard.
  • Try before installing. A Vial Web option is available alongside the downloadable GUI, which is handy for checking the interface.
  • Size matters for features. The manual notes selecting Vial GUI features for size, implying that firmware space constrains which features you can enable on a given board.

The project is fully open, with sources for all components on GitHub, and feature suggestions go through a dedicated feedback site.