7x4 ortho linear split keyboard - The Answer to the Ultimate Question of Life, the Universe, and at least Keyboards
Alternatives To Ergo42
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Atmega Soldering Station752
4 months ago7otherC++
T12 Quick Heating Soldering Station
2 years ago5other
KiCAD footprint library for kailh choc and MX-style mechanical switches and their associated sockets
4 months ago2mitRust
KeySeeBee is a split ergo keyboard. It is only 2 PCB (so the name) with (almost) only SMD components on it. It's only a keyboard, no LED, no display, nothing more than keys and USB.
6 months ago4otherSmarty
Generates a KiCAD schematic and PCB layout using a Keyboard Layout Editor json file as input
2 months ago10otherC
Euclid probe, a magnetically coupled Z Probe
2 years ago5otherPython
A low profile split keyboard designed to satisfy one single use case elegantly
6 months ago1other
7x4 ortho linear split keyboard - The Answer to the Ultimate Question of Life, the Universe, and at least Keyboards
Zx Sizif 512133
a month ago2mitKiCad Layout
ZX Spectrum CPLD-based clone for rubber case
4 years ago2otherPython
Eagle device library used by Clueboard
For Science Keyboard45
2 years ago2mit
A split ergo 4x5 keyboard with 3 thumb keys where each half is smaller than the 100x100mm cheap PCB production size.
Alternatives To Ergo42
Select To Compare

Alternative Project Comparisons


The Answer to the Ultimate Question of Life, the Universe, and at least Keyboards.

7x4 ortho linear split keyboard.


Caution! Ergo42 after version 3.0.0 Towel is not compatible with both version 1 and 2 series design. If you build Ergo42 not version 3 Towel series, please refer to the 1.x or 2.x branch.


  • 2 PCB
  • 2 5V/16MHz Pro Micro compatible boards
  • 56 1N4148 (THD) or 1N4148w (SMD) diodes
  • 2 MJ-4PP-9 TRRS jacks
  • 2 Case plate set (design available on this repo)
  • 10 5 mm (Cherry MX) / 3 mm (Kailh low profile) height M2 standoffs (3 mm height standoffs are under verifing)
  • 8 15 mm height M2 standoffs
  • 36 4 ~ 6 mm M2 screws (Height corresponds to your plate thickness)
  • 2 2 pin tact switch
  • 56 Switches of your choice
  • 1 TRRS / TRS cable

The screws may have a slight clearance issue with the keycaps. Use a screw with a lower profile head.

Mount the diodes

Place the PCB as TRRS jacks on the inside, closest to one another.

  • The left PCB will have the TRRS jack on the right
  • The right PCB will have the TRRS jack on the left

Which side you solder the diodes on depends on your switch plate's thickness and key switch type, which is Cherry MX compatible or Kailh low profile. Acrylic plate thickness < 3 mm with Cherry MX compatibles should have diodes on the same side as the key switches. Acrylic plate with Kailh low profile switches should have diodes on the opposite side of the key switches.

Double check your work. Black lines (THD) / White lines (SMD) should be facing the square pad.


[Optional] Mount the resistors and bridge jumper

If you want to use I2C, not UART, to comunicate with other side PCB, you should add 2.2 k ohm resistors on the left side PCB's R1 and R2 printed silk. Also bridge to short W1 pad by solder jumper on each side PCB. Usually you don't have to do this step.

Mount the TRRS Jack and tact switch

Mount the TRRS jack and tact switch on the same side as your switches. It should be on the upper face.

Mount the Pro Micro

Ergo42's PCB is symmetrical but Pro Micro mount is different between the left and right PCB. This spec is changed from version 2.

Pro Micro and pin header

Solder pin headers on the Pro Micro's component side. Both left side and right side one are same.

Soldered pin header

Through hole connector

If you use through hole connectors, you should solder that on the Pro Micro board, not on the PCB.

The through hole connector has sides and directions. There is recommended mount direction.

Through hole connector directions and sides

Please mount the through hole connector on the Pro Micro referencing the direction on the image above. Also be careful to mount the through hole connectors to face same side on same direction. You can see the holes on both through hole connectors simultaneously. Please check that the holes of the through hole connector is visible at the same time in the image below.

Soldered pin header

Solder (or set) the Pro Micro

Solder (or set when you use through hole connector) the Pro Micro on the PCB in the white line silk.

Soldered pin header

Soldered pin header

Be careful to refer the white line on the Pro Micro side (not soldering side).

Mount switches

Mount switches on the acrylic plate, set PCB to fit and solder switches.
When you use Cherry MX compatibles with Acrylic plate thickness < 3 mm and 5 mm height stand-offs, please cut off the tip of the electricity terminal of the switch. The electricity terminal of the switch interferences with bottom plate.

Assemble the case

Tighten the screws with standoffs. Some vinyl pads may help the keyboard's stability. Install your keycaps.

From version 3 Towel, there are some tent/tilt leg options. You can set the legs and put on some silicon tape for stability.

Flash QMK Firmware

To flash the pre-built firmware hosted by Remap

Now you can flash the pre-built firmware that supports VIA / Remap keymap edit in Remap.

To build your own firmware

QMK firmware for Ergo42 is now available on QMK firmware. This document doesn't cover how to build QMK. Prease refer to QMK documents.

Connect the keyboard by USB cable to a PC and run

$ make ergo42:default:avrdude

on the left and right side keyboard individually.

It will build and try to flash your firmware. Follow the instructions that require to reset the Pro Micro.

This process may require privileges. If you have some Permission denied error, please try

$ sudo make ergo42/rev1:default:avrdude

All done!

Popular Switch Projects
Popular Pcb Projects
Popular Games Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.