Files
qmk/INSTALL.md
mindfulminun b000b06305
Build firmware / build (push) Successful in 3m18s
build on push, add flashing instructions
:)
2026-11-20 00:11:53 +00:00

30 lines
1.1 KiB
Markdown

# how to install (qmk not needed!)
1. Download `preonic_rev3_mindfulminun.bin` from the
[latest release](https://gitea.benjic.xyz/mindfulminun/qmk/releases/tag/latest).
2. Put the keyboard in bootloader mode.
3. Flash it with one of the options below.
## Option A (ez): QMK Toolbox (graphical)
Get it from the [QMK Toolbox releases](https://github.com/qmk/qmk_toolbox/releases)
(Windows and macOS; check the latest release for Linux support). Open the `.bin`
file, tick "Auto-Flash" or click Flash, and the Toolbox installs any drivers it needs.
## Option B (leet): dfu-util (cli, all systems)
Install it:
- **macOS:** `brew install dfu-util`
- **Linux:** install the `dfu-util` package from your distro
(e.g. `sudo apt install dfu-util` or `sudo pacman -S dfu-util`)
- **Windows:** download it from <https://dfu-util.sourceforge.net/releases/>
and unzip it. If the keyboard isn't detected, install the WinUSB driver for the
"STM32 BOOTLOADER" device with [Zadig](https://zadig.akeo.ie/).
```
dfu-util -a 0 -d 0483:df11 -s 0x08000000:leave -D preonic_rev3_mindfulminun.bin
```
The keyboard restarts on its own when the flash finishes.