QMK Logo QMK Firmware

An open source firmware for AVR and ARM based keyboards

View on GitHub

Download Zip Download Tar

Current Version Build Status Discord Docs Status GitHub contributors GitHub forks


How to support QMK

This project is maintained by QMK collaborators and contributors like you!

Hosted on GitHub Pages — Theme by orderedlist

Making from root and no more Makefiles

After merging in the implementation of #1659, the only way to compile QMK is in the root directory, with the full command:

make <keyboard>[-<subproject>]-<keymap>-<target>

where the subproject is optional. Errors associated with trying to build anywhere else may be:

QMK Firmware v0.5.125
error: pathspec 'keyboards/<keyboard>/lib/chibios' did not match any file(s) known to git.
Did you forget to 'git add'?
make: *** [<keyboard>-allsp-allkm] Error 1


make: *** No rule to make target `default'.  Stop.

In addition to this change, the only Makefile that should exist is the one in the QMK root - all others have been/should be converted to rules.mk, which is now included in its stead, at every level:

If you see any Makefile in any of these locations, you can feel free to delete it.