qmk / qmk_toolbox

A Toolbox companion for QMK Firmware

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.2.

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

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

brew install qmk-toolbox