02/01/26 - More soldering, testing and discovery!

The Aliexpress parts arrived today!

I spent some time developing the firmware, soldering the LEDs, the 3.5mm connector, and the hotswap sockets. As with any prototype, a few challenges appeared:

1. The first LED in the matrix is currently acting only as a signal amplifier. To stabilize the data for the rest of the chain, I had to keep it turned off. This is a functional workaround for now. For the future I'll add an LED spot only for signal amplification, outside of the matrix.
2. I realized I accidentally used a TRS (3-pin) connector instead of a TRRS (4-pin). Since I’m short on pins for wired data, I’ve pivoted: the 3.5mm cable will now only provide power to the secondary half, and I’ll use ESP-NOW for wireless communication between the two sides.
3. The switch spacing is a bit too tight, which means my standard keycap set won't fit. My immediate solution is to 3D print custom, more compact keycaps for this specific revision.

Errors are how you learn. I’ve applied lessons from past failures to fix old bugs, even if new ones took their place. I’m still aiming for a "perfectly baked" Nibunkatsu keyboard, so for now, I’ll bridge these gaps to get it functional and prepare for the next board revision!

01/01/26 - Soldering and coding...

Before anything, Happy new year! :D

The PCB arrived and most components too! I soldered the minimal components to get the ESP32 chip working through the USB port so I could start developing some code. Little did I know that getting the ESP32-S3 N4 would bring nothing but issues... (if you're getting an N4, get at least the N4R2)

My initial plans for the project was to use Circuit Python and KMK, but no builds are available for the N4 apparently. I tried developing in Platformio something then, and oh boy I couldn't get the ESP to boot normally without bootlooping. I spent the whole day troubleshooting and making a semi-custom compiler in Platformio for this chip... (yes Grok Code Fast 1 did most of the heavy lifting here, but I had to research some old solutions that worked in the past but no longer now too)

For now I started development using the Arduino Framework but I will try to move into ESP-IDF instead.

I got the RGB working and some kind of key scanning and basic hid input working.

13/12/25 - Repository organization and fixes

Fixed plenty of things in the repository, and made changes to the BOM and License choice reasoning.

This post will also serve as a fix for the project banner, as I've discovered why it kept being white in spite of all images I added! This is the hero image I used for the github repository of the project.

11/12/2025 - 3D Model Improvements

After procrastinating for a while, I finally decided to improve on the 3D models more. Added support cylinders to hold the PCBs in the right height, and made the plates where the switches will be mounted on! Now there are 4 models to be printed: Left case, Right case, Left plate and Right plate.

10/12/2025 - Oled display UI design

Made a sample UI design that fits the vertical layout of the 0.91 inch display, and tested it on an actual display module. I looked up online and didn't find anyone using this display in vertical orientation, so I had to improvise a bit. But it is turning out great! This is by no means the final, but gives a taste. :P Everything was designed using lopaka.app, which is an amazing tool for making pixel art and small UIs for displays like this.

08/12/2025 - 3D CAD Modeling

Following Joe Scotto's tutorial on youtube, I made the 3D case model for both sides of Nibunkatsu using Shapr3D! This is my first time modeling something in 3D, and I'm absolutely impressed by the result!! This is so much easier than I've ever expected it to be :D

06/12/2025 - Final PCB design

Fixed various schematic errors some I spotted by myself, and others with the help of Gemini too. With these fixes routing the PCBs was finalized as well.

05/12/2025 - Even more planning and design

After getting the left keyboard side mostly wired up, I began the right side by cloning the left side outline and flipping it, like this I ensured that both sides are as similar as I can possibly get them.

Also I made custom artwork stars in Figma and added them into the PCBs. I went for some sort of a cybersigilism look, which I love <3

04/12/2025 - More planning and design

Today focused on refining the PCB design and schematics, primarily for the left half of the keyboard. A major part of the work involved researching protection mechanisms for the TRRS connection—specifically, how to prevent 5V shorts to the UART pins during hot-plugging, which is critical for protecting the MCU from high-voltage damage.

03/12/2025 - Research, Planning and Design

I kicked off the project by deep-diving into split keyboard videos to fully grasp the mechanics and standard build processes.

From there, I moved on to designing the layout and picking components. I started the schematics and PCB for the left side today—already factoring in the rotary encoder for the right half—and spent quite a while manually placing every single switch to get the spacing just right.