Build QMK firmware on gentoo

by Gregor Uhlenheuer on September 1, 2018

A few days ago I finally received my Planck keyboard by OLKB. It is a mechanical keyboard you usually have to assemble by yourself and moreover have the possibility to program the layout by yourself too.

The firmware that is used is called QMK and is open-sourced (here on github). In order to customize the keyboard layout you have to modify the default keymap, compile the firmware and finally flash it onto your keyboard.


Although the QMK project is pretty well-documented, there are no build or setup instructions for the Gentoo distribution at all. Let’s go through these few steps together:


First you have to make sure your gcc is installed with multilib support:


Now you can install crossdev:

AVR cross compile environment

Install the AVR compiler toolchain after that:


The remaining build toolchain dependencies can be easily installed via portage:


Now you are ready to create your customized firmware in no time.


This post is tagged with programming, qmk, gentoo, planck and firmware