Awesome
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 12 (Monterey) or higher
- Windows 10 May 2020 Update (20H1) or higher
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
The current version of QMK Toolbox is 0.3.3.
- Windows: standalone, installer
- macOS: standalone, installer
For Homebrew users, it is also available as a Cask:
brew install qmk-toolbox