Customizing your keymap with Vial

What's Vial?

Vial is a feature-rich open-source cross-platform (Windows, Linux and Mac) GUI and a QMK fork for configuring your keyboard in real time.

It is a completely open project with sources for all components publicly available on GitHub. For more information about Vial, head to https://get.vial.today/

Your keyboard will be automatically detected by the Vial GUI if it did come pre-loaded with Vial firmware.

First time use

1. Download Vial

Hop over to the download page to make sure you have the latest build.

2. Run Vial

On Windows and MacOS simply run the installer/executable.

Linux

Make sure that your downloaded file can be executed. You can either do this through your graphical file explorer or use the following command:

chmod +x ~/Downloads/Vial*.AppImage

After that simply launch the application by either double clicking on it or executing the following command:

~/Downloads/Vial*.AppImage

If you discover any bugs please raise an issue on the Vial GitHub.

Programming your keyboard

Using Vial is extremely simple, just click on a key you would like to change the value of in the top palette then select your replacement key or macro in the bottom palette.

Your new key will be automatically saved onto the keyboard and immediately ready for use.