QMK Toolbox
This is a collection of flashing tools packaged into one app. It supports auto-detection and auto-flashing of firmware to keyboards.
| Windows | macOS |
|---|---|
 |
 |
Flashing
QMK Toolbox supports the following bootloaders:
- ARM DFU (APM32, Kiibohd, STM32, STM32duino) via dfu-util
- Atmel/LUFA/QMK DFU via dfu-programmer
- Atmel SAM-BA (Massdrop) via Massdrop Loader
- BootloadHID (Atmel, PS2AVRGB) via bootloadHID
- Caterina (Arduino, Pro Micro) via avrdude
- HalfKay (Teensy, Ergodox EZ) via Teensy Loader
- LUFA/QMK HID via hid_bootloader_cli
- WB32 DFU (WB32) via wb32-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.
HID Console
The Toolbox also listens to HID messages on usage page 0xFF31 and usage 0x0074, compatible with PJRC's hid_listen.
If you have CONSOLE_ENABLE = yes in your keyboard's rules.mk, you can print messages with xprintf(), useful for debugging:
See the QMK Docs for more information.
Installation
System Requirements
- macOS 10.15 (Catalina) or higher
- Windows 10 May 2019 Update or higher (earlier with .NET Framework 4.8)
Dependencies
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 use Zadig to fix the issue.
Download
Get the latest release here.
For Homebrew users, it is also available as a Cask:
$ brew tap homebrew/cask-drivers
$ brew install --cask qmk-toolbox