Repository files navigation

This is a collection of flashing tools packaged into one app. It supports auto-detection and auto-flashing of firmware to keyboards.

Windows	macOS

QMK Toolbox supports the following bootloaders:

• ARM DFU (APM32, Kiibohd, STM32, STM32duino) viadfu-util
• Atmel/LUFA/QMK DFU viadfu-programmer
• Atmel SAM-BA (Massdrop) viaMassdrop Loader
• BootloadHID (Atmel, PS2AVRGB) viabootloadHID
• Caterina (Arduino, Pro Micro) viaavrdude
• HalfKay (Teensy, Ergodox EZ) viaTeensy Loader
• LUFA/QMK HID viahid_bootloader_cli
• WB32 DFU (WB32) viawb32-dfu-updater_cli
• LUFA Mass Storage

And the following ISP flashers:

• AVRISP (Arduino ISP)
• USBasp (AVR ISP)
• USBTiny (AVR Pocket)

If there's an interest in any others, they can be added if their commands are known.

The Toolbox also listens to HID messages on usage page0xFF31 and usage0x0074, compatible with PJRC'shid_listen.

If you haveCONSOLE_ENABLE = yes in your keyboard'srules.mk, you can print messages withxprintf(), useful for debugging:

See theQMK Docs for more information.

• macOS 12 (Monterey) or higher
• Windows 10 May 2020 Update (20H1) or higher

When using the QMK Toolbox on Windows, it will prompt at first run to install the necessary drivers.

If you run into any issues with "Device not found" when flashing, then you may need to useZadig to fix the issue.

Thecurrent version of QMK Toolbox is0.3.3.

• Windows:standalone,installer
• macOS:standalone,installer

For Homebrew users, it is also available as a Cask:

brew install qmk-toolbox