How To Use VIA To Program Your Keyboard

How to Remap a Key on VIA?

1, Connect your keyboard to our cable and click here to open the VIA. (Note: Online VIA can currently only be opened using Chromium-based browsers.)

2, If the VIA fails to authorize your keyboard, please download the correct keymap JSON file. Since it takes time for GitHub to approve our VIA code submissions, some keymap JSON files may not be automatically recognized at the moment. You can find the keymap JSON file by searching for "keymap working on VIA" on the keyboard product page. Alternatively, you can visit this link to locate the JSON file for your specific keyboard, which can be found in the latter portion of the firmware page.

视频

3, Once you have downloaded the keymap JSON file, go to the VIA and turn on the "Show Design tab" in the "Settings" tab. (If it's already on, you can skip this step.)

4, Drag the JSON file into the "Design" tab on the VIA.

5, In the "Configure" tab, select the "KEYMAP" section. Click on the key you want to program, and it will start flashing slowly. Then, click on the key you want to remap in the "BASIC/MEDIA/MACRO/LAYERS/SPECIAL/QMK LIGHTING/CUSTOM" section. Your key remapping is now complete.

Here's a video example for your reference.

How to Use Different Layers to Set the Combination Keys

You can customize each key on each layer of your keyboard with VIA, there are two layers for Mac, and two layers for Windows. For example, the Q1 keyboard comes with 81 keys, so you can remap up to 324 keys (81 x 4) you want.

The default layer for the keyboard is layer 0.

The button M0(1) = layer 1

The button M0(3) = layer 3

Example: Use the layer function in VIA to set power button = fn + INS on macOS.

1. We have the "fn" key (aka MO(1) on VIA). Now we need to set the power button = "fn" + "upper right corner key".

How to Use Different Layers to Set the Combination Keys

You can customize each key on each layer of your keyboard with VIA, there are two layers for Mac, and two layers for Windows. For example, the Q1 keyboard comes with 81 keys, so you can remap up to 324 keys (81 x 4) you want.

The default layer for the keyboard is layer 0.

The button M0(1) = layer 1

The button M0(3) = layer 3

Example: Use the layer function in VIA to set power button = fn + INS on macOS.

1. We have the "fn" key (aka MO(1) on VIA). Now we need to set the power button = "fn" + "upper right corner key".

2. Click LAYER 1.

3. Click the "ins" key on the upper right corner (the key will then flash slowly). Then, find the "power" key on the SPECIAL section, click it.

4. Hold fn and the upper right key to power off your computer.

PS: The shutdown option will normally pop up and let you choose "Shut Down", "Sleep", or "Restart". However, please check if the system has the pop up option on just in case the system shuts down directly and the file is not saved.