Keyboard Builders' Digest
Check out MMkeyboard! Code: KBDNEWS
Keyboard Builders' Digest / Tips & Tricks

Ergogen tutorials

FlatFootFox published a comprehensive series of tutorials on how to use Ergogen V4.
Published May 3, 2023

FlatFootFox aka TheStuChef published a series of tutorials on how to use Ergogen V4: Let's Design A Keyboard With Ergogen v4 – A Beginner's Guide To Designing Custom Ergonomic Keyboard PCBs.

Ergogen, the ergonomic keyboard layout generator app, recently hit v4! I've been enjoying using this tool for a while now, so I decided to collect everything I've learned into a series of step-by-step articles outlining the basics of Ergonomic keyboard PCB creation – TheStuChef.

As many of you may know, also explained by project owner Dénes Bán in the MK Advent Calendar, V4 of Ergogen stirred things up by introducing some breaking changes last December, thus rendering older YAML scripts incompatible and earlier examples, tutorials and documentation unusable.

This series of articles by FlatFootFox tries to incorporate these changes and address many of the issues, while guiding you through the process of creating a keyboard PCB with a unibody Sofle-like layout.

I'm sure this will be helpful for uninitiated first-time users and confused Ergogen V3 pros as well.


The series covers:


Published on Wed 3rd May 2023. Featured in KBD #121 (source).

Did you like reading this post?

Donate to keep this project alive


3D printable keycap tutorial

A video tutorial by mcass_37 on how to merge files and create your own custom 3D printable keycap file (base keycap, source).

PS/2 protocol in action

A video on how the PS/2 keyboard protocol works. Posted by nucatus (source).

Keyboard Case Design

Sadek Baroudi provides a detailed walkthrough of how he designs 3D models – Starting with a PCB, and ending with a model that you can export for 3D printing.

QMK RGB Matrix configuration

The focus of Sadek Baroudi's tutorial is how to properly configure RGB Matrix especially for non-trivial ergo keyboards with angles and column stagger.

Soldering a YC8 connector

A video tutorial on soldering the YC8 detachable connector by actionspacecake.

Make a Keyboard

A handwired project and detailed tutorial on how to design and make a keyboard by berkstone.