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
OrbStackOrbStack is a fast, light and simple way to run Docker containers and Linux machines on your Mac. It is a drop-in replacement for Docker Desktop: your docker and docker compose commands keep working, and on first start OrbStack offers to copy over your existing Docker Desktop containers, images and volumes. It starts in seconds, uses less than 0.1% background CPU on Apple Silicon and returns unused memory to macOS. Besides containers it runs full Linux machines from 16 distributions, and a lightweight Kubernetes cluster for local development. OrbStack is made by Orbital Labs.Developer Tools- RazorSQLRazorSQL is an SQL query tool, database browser, SQL editor and database administration tool from Richardson Software, LLC. It has been tested on over 40 databases and connects through JDBC or ODBC, with support for systems such as MySQL, PostgreSQL, Oracle, MS SQL Server, SQLite, MariaDB, MongoDB, Snowflake, DuckDB and Redshift. A database navigator lets you browse schemas, tables, columns, keys, views, indexes, procedures and functions, and visual tools create, alter, describe and drop these objects without writing the statements by hand. RazorSQL is also available for Windows, Linux and Solaris.Developer Tools
CorkCork is a graphical companion app for Homebrew, the popular package manager for macOS. Instead of typing commands in the Terminal, you look up formulae and casks, press Install, and Cork does the rest. You can add taps for more packages, uninstall anything you no longer need, see detailed information about packages and taps that Homebrew does not show easily, clear old caches to free up space, and start and stop Homebrew services. Cork needs Homebrew itself to be installed.Developer Tools
SerialSerial is a terminal app for connecting your Mac to just about anything: routers, switches, firewalls, servers, industrial control and IoT devices. It has built-in support for almost every USB serial adapter, from FTDI, Silicon Labs, Prolific, TI, Microchip and more, so you do not need to find and install drivers. It is also a full SSH client with an identity manager, and supports Telnet with RFC2217 remote serial port control and raw TCP sockets.Developer Tools
Cocoa Packet AnalyzerCocoa Packet Analyzer is a native Mac network protocol analyzer and packet sniffer. It captures traffic on Ethernet and Wi-Fi, dissects each packet as it arrives and shows it field by field, with more than 50 protocol analyzers. It can record which app sent or received each packet, so you see Safari or your own app rather than an anonymous connection, and an Applications window adds up packets and bytes per app while the capture runs. It reads and writes pcap and pcapng files, so you can also open traces made with other tools.Developer Tools
SharkSpaceSharkSpace, also called Shark, is a free virtual workspace manager for Mac. It creates a real folder for each workspace and mounts your project and component folders inside it with symbolic links, so Codex, Claude Code, Cursor, the terminal and other agent tools can open the whole workspace like an ordinary project. The window shows your workspaces in a sidebar, the folders of the selected workspace with their Git branch, latest tag and sync status, and the Codex sessions that belong to it.Developer Tools
FULLMAC.app does not host this app. Download buttons lead to the developer’s own pages.