QMK Toolchains

Builds of baremetal cross-compilation *-gcc primarily for QMK Firmware use.

Currently provides GCC 14.2.0, for the following baremetal targets:

• arm-none-eabi
• avr
• riscv32-unknown-elf

Toolchain host machines supported:

• Linux/x86_64
• Linux/aarch64
• Linux/riscv64
• macOS/aarch64
• macOS/x86_64
• Windows/x86_64

All builds for the above toolchain variants are done on GitHub actions -- the latest release provides tarballs for each of the target+host combinations.

Repacked toolchain downloads can be found on qmk/qmk_toolchains releases; these offer merged distributions for all baremetal targets for each host type.

Containers

Two prerequisite container images are created through GitHub actions -- ghcr.io/tzarc/qmk_toolchains:base and ghcr.io/tzarc/qmk_toolchains:builder; the latter includes all the required cross-compilers for:

• x86_64-qmk-linux-gnu
• aarch64-unknown-linux-gnu
• riscv64-unknown-linux-gnu
• x86_64-w64-mingw32
• aarch64-apple-darwin24
• x86_64-apple-darwin24

These containers need an environment variable -- $TC_WORKDIR -- with a corresponding volume mounted to that location inside the container as the user/group permissions will be updated to match during execution.