A downloadable tool for Windows, macOS, and Linux

Download NowName your own price

Quick links: web version · source code

Takes your Vial .vil layouts and converts them to YAML that you can pass to keymap-drawer to render your layout to SVG/PNG images that you can show to people instead of taking screenshots of Vial configurator.

Also lets you label your layers and keys to make the keymap easier to read.

Inevitable caveats

Apparently the order in which Vial stores keys in .vil files does not necessarily match up with how keys are defined in QMK, therefore the keys may appear out of order, depending on the keyboard.

For this I am giving you a couple checkboxes for common oddities and ability to move a key based on row-column.

Please accept my condolences in advance, but good news - you'll only need to do this once per keyboard.


For the web version, hopefully the use should be apparent enough, and you can load an example configuration to see how to deal with keys being out of order.

The native version is invoked through command-line/terminal.

On Windows this is done as following:

.\VialToKeymapDrawer.exe <...options> 

On Mac/Linux this is done as following (you'll need Neko VM installed):

neko ./VialToKeymapDrawer.n <...options> 

For a full list of supported options, run without arguments or with --help;

Options might look like this, for instance (for a Sofle Choc):

--keyboard splitkb/aurora/sofle_v2/rev1 --half-after-half --mirror-right-half --move-defs yal-sofle/move-defs.txt --key-labels yal-sofle/key-labels.txt --layer-names yal-sofle/layer-names.txt --vil yal-sofle/yal-sofle.vil yal-sofle.yaml 

Other keyboards may require less tinkering.

PlatformsWindows, macOS, Linux
Rated 5.0 out of 5 stars
(1 total ratings)


Download NowName your own price

Click download now to get access to the following files:

vial-to-keymap-drawer-windows.zip 396 kB
Version 2023-09-21
vial-to-keymap-drawer-unix.zip 45 kB
Version 2023-09-21