# qmk/qmk_toolbox

A Toolbox companion for QMK Firmware

Repository: https://github.com/qmk/qmk_toolbox
Canonical: https://ross.abutalabs.com/products/qmk_toolbox
Homepage: https://qmk.fm/toolbox
Language: C#
License: MIT
License Family: permissive
Topics: qmk, qmk-firmware, dfu, atmel, macos, avr, caterina, stm32
Last push: 2026-08-20T10:47:05+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 66, longevity 100
- inputs: {"age_days": 3288, "days_push": 13, "days_rel": 15, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3071, forks 558 (observed 2026-08-28T04:07:41.589892+00:00)

## What it is
A cross-platform desktop application that packages multiple firmware flashing tools for QMK keyboards into one GUI, supporting auto-detection and auto-flashing across many bootloaders. It also includes an HID console for debugging keyboard firmware output and a built-in key tester.

## Use cases
- flash qmk firmware onto a mechanical keyboard
- flash firmware to a pro micro or teensy bootloader
- debug keyboard firmware via hid console
- install usb drivers for keyboard bootloaders on windows
- test keys on a newly flashed keyboard
- auto-detect and flash a keyboard in dfu mode

## When to choose
- you use QMK Firmware and want a GUI flashing tool on Windows or macOS
- you need to support many bootloaders (DFU, Caterina, HalfKay, BootloadHID, etc.) in one app
- you want automatic device detection and driver installation

## When to avoid
- you flash firmware on Linux, where the qmk CLI is preferred
- you need to flash non-keyboard embedded devices
- you want fully scripted/automated flashing without a GUI

## Facets
- artifact type: application
- maturity: active
- function: developer-tools, gui, embedded
- domain: hardware, developer-tools, embedded-systems
- platform: windows
- tags: qmk, firmware-flashing, keyboard, bootloader, dfu, hid-console, mechanical-keyboards, macos, desktop

## Member repositories
- qmk/qmk_toolbox (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:41.589892+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:28:01.130566+00:00, confidence not recorded.
  - readme: https://github.com/qmk/qmk_toolbox (fetched 2026-08-28T04:07:41.589892+00:00, sha 792c5a5c5dd6)
  - homepage: https://qmk.fm/toolbox (fetched 2026-08-29T09:43:17.890817+00:00, sha fa626d62be2f)
  - site_page: https://docs.qmk.fm (fetched 2026-08-29T09:43:17.893304+00:00, sha 9c5b37c789db)
- Data as of 2026-08-30T08:39:29.467469+00:00.