Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

QMK Toolbox

Latest Release GitHub Workflow Status Discord

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

Windows macOS
Windows macOS


QMK Toolbox supports the following bootloaders:

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, you can print messages with xprintf(), useful for debugging:

Hello world from Console

See the QMK Docs for more information.


System Requirements

  • 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 use Zadig to fix the issue.


The current version of QMK Toolbox is 0.3.3.

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

brew install qmk-toolbox