ScottoErgo Handwired Keyboard

ScottoErgo Handwired Keyboard

The ScottoErgo a 36-key column staggered ortholinear ergonomic keyboard with an exposed controller, aviator connector for USB, 10° of tilt, and 20° of angle. The board uses Akko Lavender Purple switches which have quickly become one of my personal favorites. It connects to the computer over a custom-made GX16-4 aviator connector using the test points on the controller. In order to do this I had to rip off the Micro-USB port in order to make it fit within the case.


Getting One

If you’re interested in getting one assembled, contact me and we can discuss the components and other details for a commissioned build. However, the files are available for free here if you want to build one yourself.

In addition to the 3D printed case, heat shink tubing, wire, and copper, you'll also need tools along with the following components:



Annotated ScottoErgo wiring.

When looking at the back of the board, the columns (blue) go to the following pins on the controller from right to left: GP0, GP1, GP2, GP3, GP4, GP22, GP21, GP20, GP19, GP18

Then the rows (red) go from top to bottom: GP12, GP13, GP14, GP15

Keep in mind, you can connect anywhere on the column or row to the controller, it doesn't need to just be at the end.



You can find the firmware files on the qmk_firmware repository or you can compile them online using the QMK Configurator. However, QMK is often slow at getting changes merged and because of that you can find the most up-to-date firmware on the ScottoKeebs Github repository. Also available are the pre-compiled firmware files that are ready to flash:

default.uf2 - Default QMK keymap in QWERTY.
vial.uf2 - Default QMK keymap in QWERTY with Vial configurator support.
scotto.uf2 - My personal QMK keymap in Colemak.

After flashing vial.uf2, you should load the vial.vil configuration file within the Vial application to ensure everything functions as expected.





ScottoErgo wiring.ScottoErgo connector.ScottoErgo switches.

Back to blog


Hi, could this keyboard be made wireless somehow?


Hey Joe, I really enjoy your designs and love the element of adding a screen to a keyboard. I’d like to modify the ScottoErgo keyboard to have a screen in the middle for my first project. Could you go into more detail on how to add a screen? Thanks.


Leave a comment