QMK Toolbox for MAC

Free, open-source tool for Mac that flashes QMK firmware to custom keyboards, with bootloader auto-detection and an HID console for debugging.

QMK Toolbox Overview

QMK Toolbox is a free, open-source app that flashes firmware to mechanical keyboards. It packages a collection of flashing tools into one app and supports auto-detection and auto-flashing of firmware to keyboards. It is made by the team behind QMK Firmware, the open-source keyboard firmware.

The app supports a long list of bootloaders, including ARM DFU (STM32, APM32, Kiibohd), Atmel/LUFA/QMK DFU, Atmel SAM-BA, BootloadHID, Caterina (Arduino, Pro Micro), HalfKay (Teensy, Ergodox EZ), LUFA/QMK HID, WB32 DFU and LUFA Mass Storage, plus the AVRISP, USBasp and USBTiny ISP flashers. It also listens for debug messages from your keyboard through its HID console. QMK Toolbox is made by the QMK project and released under the MIT licence. Version 0.3.4 adds macOS code signing and recognises the Arduino Leonardo ETH as a Caterina bootloader. The Mac app is universal and needs macOS 12 or later; it is offered as a standalone app and as a .pkg installer.

Key Features

QMK Toolbox puts keyboard flashing and debugging in one app.

  • Auto-detection: recognises keyboards in bootloader mode.
  • Auto-flash: flash the chosen firmware as soon as a keyboard is found.
  • DFU support: ARM DFU, Atmel/LUFA/QMK DFU and WB32 DFU bootloaders.
  • AVR boards: Caterina, HalfKay, BootloadHID and LUFA HID bootloaders.
  • ISP flashers: AVRISP, USBasp and USBTiny.
  • SAM-BA: flash Massdrop boards through the Massdrop Loader.
  • HID console: read debug messages printed by your keyboard firmware.
  • Key tester: check that each key registers.

What’s New in Version 0.3.4

QMK Toolbox 0.3.4 adds Mac signing and several fixes.

  • macOS code signing
  • Recognises 2A03:0040 (Arduino Leonardo ETH) as a Caterina bootloader
  • Fixes the reference to handed .eep files on Mac
  • Minor tweaks to key tester labels
  • Fixes the link in the About box

QMK Toolbox FAQ

Is QMK Toolbox free?

Yes. QMK Toolbox is free and open source under the MIT licence.

Which macOS version does QMK Toolbox need?

QMK Toolbox 0.3.4 needs macOS 12 (Monterey) or later.

Does QMK Toolbox run on Apple Silicon?

Yes. The Mac app is universal and runs natively on Apple Silicon and Intel Macs.

What is QMK Toolbox used for?

It flashes firmware, usually built with QMK Firmware, to mechanical keyboards, and shows debug messages from the keyboard in its HID console.

Which bootloaders does QMK Toolbox support?

ARM DFU, Atmel/LUFA/QMK DFU, Atmel SAM-BA, BootloadHID, Caterina, HalfKay, LUFA/QMK HID, WB32 DFU and LUFA Mass Storage, plus the AVRISP, USBasp and USBTiny ISP flashers.

Can QMK Toolbox flash a keyboard automatically?

Yes. With auto-flash on, it flashes the selected firmware as soon as it detects a keyboard in bootloader mode.

How do I see debug output from my keyboard?

Enable CONSOLE_ENABLE = yes in your keyboard’s rules.mk and print messages with xprintf(). QMK Toolbox shows them in its HID console.

Is there an installer for QMK Toolbox?

Yes. The Mac version comes as a standalone app in a .zip file and as a .pkg installer.

Can I install QMK Toolbox with Homebrew?

Yes. Run brew install --cask qmk-toolbox.

Where does the QMK Toolbox download on qmk-toolbox.FULLMAC.app come from?

The download button leads to the official QMK Toolbox releases page on GitHub at https://github.com/qmk/qmk_toolbox/releases/latest. qmk-toolbox.FULLMAC.app does not change or repackage the app.

Similar Apps

FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.