QMK + VIA Flashing Instructions

These instructions will assume you are on windows, and will use our pre-compiled .hex files.
  1. Download the latest flashing tool here (QMK Toolbox).
  2. Downloading the appropriate .hex file from the table in the downloads page.
  3. Run QMK Toolbox, pick the .hex file in the Local file box, and choose the correct MCU for your keyboard based on the below information.
  4. If needed or prompted, install available drivers for your computer. This can also be done by following these instructions.
  5. Connect your keyboard PCB to your computer with an appropriate usb cable.
  6. Press the physical reset button on the PCB (labeled "RESET").
  7. Hit Flash.
Once flashed, you can download VIA here and run it to start configuration your keyboard in real time. If you would like to configure it offline, please download the appropriate VIA .json file from the table in the downloads page, run VIA and select "Show design tab" in the settings tab, and load that .json file in the design tab. Your keyboard should now appear and be ready for configuring.

    QMK Troubleshooting

    1. Message in QMK toolbox says >dfu programmer: no device present. You will most likely need to download drivers using these instructions.

     

    ZMK Flashing Instructions

    These instructions will assume you are on Windows.
    1. Download the appropriate .uf2 file from the table below, OR generate your own with a fork of our ZMK repository using these instructions.
    2. Connect your keyboard PCB to your computer with an appropriate USB cable.
    3. Reset your PCB by quickly double tapping the reset button on the PCB.
    4. A USB storage device should show up in your file explorer. Copy the firmware UF2 file to the USB storage device.
    5. The USB storage device should automatically disappear, and once this happens you may safely unplug your PCB (if desired) and use the new firmware, or remain plugged in.