Skip to content

MechWild/mw_firmware

Repository files navigation

MechWild Firmware

Prebuilt firmware for MechWild products.

Use the releases section on the right of the page to download prebuilt binaries for each board that you are interested in.

The firmware here is intended to provide functionality unavailable through QMK Configurator. Primarily this means compatibility with dynamic remapping tools like Vial and VIA, but also experiments and pre-release firmware.

If you have feedback that needs to be addressed, please feel to open an issue stating the problem you are facing.

Common Questions/Problems

Which file do I choose?

BlackPill boards (OBE, Waka60, PuckBuddy...)

  • All boards should use F401 firmware files unless you know exactly why not. The only BlackPills MechWild currently sells are the F401 model, so there is a 99% chance this means you!
  • If your board has an EEPROM chip installed, you may use the eeprom firmware. If it doesn't, avoid anything with eeprom in the filename.

vial files are built for Vial. via files are built for VIA. Recent VIA firmware is no longer compatible with the Vial program, so flash with the firmware for the program you prefer to use.

What do I do with these files?

First, download the appropriate zip file from Releases and extract the contents.

The firmware of your choice will need to be flashed onto your keyboard. Instructions for doing this can likely be found in your board's build guide.

If there is a *_via_layout_defn.json file in the zip, you may need to sideload this file to make the board remappable in VIA.

I downloaded a .hex/.bin/.uf2 file from GitHub and flashed it, but nothing changed!

If QMK Toolbox looks like the following, the flash didn't complete because the file is corrupt.

QMK Toolbox screenshot of a failed flash

Please use the releases page for downloads instead of hunting through the repo; that's why it's there!