Skip to the content
2 layers42.9 × 44 mmCustom keeb, the printed circuit board in 3D

I built my first keyboard from scratch using KiCad 10.0. I'm using Hack Club's Keeb project to learn how to build this project

Size
42.9 × 44 mm
Copper layers
2
Thickness
1.6 mm
Parts
31
Nets
52
Pads
143
Tracks, vias
272, 20
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
31 Aug 2026
Updated
31 Oct 2026

Overview

Custom keeb is an open-source printed circuit board by bo-aryan, from the bo-aryan/custom-keeb repository on GitHub. It is a 2-layer board of 42.9 × 44 mm with 31 parts on 52 nets, routed with 272 tracks and 20 vias.

Its parts include 16 diodes, 9 switches and 1 connector. It belongs with the keyboards and input and lEDs and displays boards and the RP2040 boards of this library.

README

README.md

custom-keeb

A custom 8-key mechanical macropad designed from scratch as a two-layer PCB around an RP2040-based Orpheus Pico, featuring a diode-isolated switch matrix, per-key RGB lighting, a rotary encoder, and an external OLED display. Designed primarily for controlling music and video playback, with programmable shortcuts for desktop applications. image

Overview

  • Designed an 8-key mechanical media macropad around an RP2040-based Orpheus Pico.
  • Designed the complete two-layer PCB, including schematic, component placement, routing, and manufacturing files using KiCad.
  • Integrated an MX switch matrix, SK6812 RGB LEDs, EC11 rotary encoder, and external I2C OLED.
  • Developing CircuitPython firmware for media controls, programmable shortcuts, volume adjustment, and RGB lighting.
  • Building a Python companion application to retrieve Windows media metadata and display song information and playback progress on the OLED.

What I Learned

This project took me through the complete PCB design process rather than just the schematic stage.

The main learning areas included:

  • Designing and routing a diode-isolated switch matrix
  • Understanding PCB footprints and physical component placement
  • Managing a two-layer PCB
  • Routing around dense components
  • Using vias and copper fills
  • Connecting addressable RGB LEDs as a chain
  • Integrating an encoder and I2C peripheral
  • Understanding USB HID and media-control commands
  • Developing firmware for an RP2040 microcontroller
  • Integrating hardware with a Windows application through USB serial
  • Running design-rule checks before manufacturing
  • Preparing a PCB for fabrication

PCB Design

The PCB was designed as a two-layer board using KiCad. image

Routing

The design uses both copper layers for routing, with vias used where necessary to move between layers.

Ground connectivity is provided through copper fills rather than routing every ground connection individually.

Schematic

image

The schematic defines the complete electrical system, including:

  • RP2040-based controller
  • 8-switch matrix
  • 1N4148 switch diodes
  • SK6812 RGB LED chain
  • EC11 rotary encoder
  • External OLED connector
  • Power and ground connections

Case Design

image

The macropad enclosure was designed using Autodesk Fusion, with the case modelled to accommodate the PCB, mechanical switches, rotary encoder, and external OLED display.

The enclosure was designed around the PCB dimensions and component placement to ensure proper fitment and accessibility. Particular attention was given to the switch openings, encoder placement, OLED visibility, and USB access.

The design brings the electronics and mechanical components together into a compact enclosure while maintaining the overall layout and functionality of the macropad.

Assembly Challenges & Electrical Debugging

  • Incorrect OLED footprint orientation: Discovered that the OLED connector footprint was mirrored relative to the schematic, reversing the connections. Identified the mismatch through continuity testing and manually modified the PCB traces to isolate the incorrect connections.

    image
  • Unintended ground connections: Found that multiple ground paths were causing unexpected continuity during OLED connector testing. Scraped away excess copper around the affected connections and verified electrical isolation using a multimeter.

    image
  • Damaged RGB LEDs during SMD soldering: Encountered difficulties during my first SMD soldering experience due to the small connection pads and tight component spacing. Damaged two LEDs during assembly, requiring greater attention to polarity and soldering precision.

  • Incorrect hot-swap socket placement: Discovered an incorrectly soldered hot-swap socket during assembly. Desoldered the component, cleaned the affected pads and reinstalled it correctly.

    image

At a Glance

ComponentSpecification
ControllerOrpheus Pico (RP2040)
Layout8-key macropad + encoder
Switches8 × MX-style mechanical switches
Key matrix3 rows × 3 columns, 8 populated positions
Switch diodes1N4148
RGB10 × SK6812 MINI-E
Rotary encoderEC11
Display0.91" I2C OLED
PCB2-layer
EDAKiCad
FirmwareCircuitPython
CommunicationUSB HID + USB serial
Companion softwarePython (Windows)

Media-Control Functionality

The macropad is designed primarily as a dedicated music and video controller.

ControlFunction
Key 1Previous track
Key 2Play / Pause
Key 3Next track
Encoder press (Key 4)Mute / Unmute
Key 5Launch Spotify Desktop
Key 6Windows + Shift + S (Snipping Tool)
Key 7Windows + Shift + T
Key 8Configurable shortcut
Key 9Configurable shortcut
Encoder clockwiseVolume up
Encoder anticlockwiseVolume down

The two configurable keys can be assigned custom keyboard shortcuts through the firmware configuration.

USB HID allows the macropad to send standard keyboard and media-control commands without requiring a dedicated application for basic functionality.

Firmware Architecture

The firmware is being developed using CircuitPython for the RP2040.

The software is divided into two components:

1. Macropad Firmware

  • Matrix scanning and switch debouncing
  • USB HID media and keyboard commands
  • Rotary encoder input handling
  • RGB LED control
  • OLED updates
  • USB serial communication

2. Windows Companion Application

  • Retrieves active media-session information
  • Reads song title and artist metadata
  • Retrieves playback position and duration
  • Calculates elapsed and remaining playback time
  • Sends media information to the macropad over USB serial

This separation allows the hardware to handle physical inputs and outputs while the Windows application provides access to desktop media information.

Design Files

All source files are included in the project repository.

FilePurpose
hardware/KiCad source files
production/gerbers.zipManufacturing files
production/bom.csvBill of materials
docs/schematic.pdfReadable schematic export
firmware/CircuitPython firmware and Windows companion application

Final Result

The project brings together custom PCB design, mechanical switches, addressable RGB lighting, rotary input, embedded firmware, and desktop software into a dedicated media-control peripheral.

Beyond designing the physical board, the project explores how a custom hardware interface can communicate with a desktop operating system to control applications and display live information.

The KiCad source, manufacturing files, bill of materials, firmware, and supporting documentation are maintained as part of the project repository.

Acknowledgements

Built using KiCad and inspired by Hack Club's KEEB PCB-design resources.

The project is my own hardware design and implementation.

Parts

31
QtyValueFootprintReferences
81N4148Diode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD2, D3, D4, D5, D7, D8, D9, D10
8MX_SK6812MINI-EPCM_marbastlib-mx:LED_MX_6028RLED2, LED3, LED4, LED5, LED7, LED8, LED9, LED10
8SW_PushPCM_marbastlib-mx:SW_MX_1uSW2, SW3, SW4, SW5, SW7, SW8, SW9, SW10
4MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4
1Conn_01x04Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ1
1RaspberryPi_PicoModule:RaspberryPi_Pico_Common_THTA1
1RotaryEncoder_SwitchPCM_marbastlib-various:ROT_Alps_EC11E-SwitchSW11

Similar boards

  • 2 layers44.5 × 46.9 mmOSO SWAT B1-jig, the printed circuit board in 3D

    OSO SWAT B1-jig

    joeycastillo/Sensor-Watch

    A board replacement for the classic Casio F-91W wristwatch

    31 parts2.1k
  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    31 parts1kGPL-3.0
  • 2 layers191 × 98.5 mmMacroKeypad, the printed circuit board in 3D

    MacroKeypad

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    31 parts915
  • 2 layers39 × 45.2 mmCH32V003F4P6-R0-1v1, the printed circuit board in 3D

    CH32V003F4P6-R0-1v1

    openwch/ch32v003

    CH32V003 is an ultra-cheap RISC-V MCU with 2KB SRAM, 16KB flash, and up to 18 GPIOs that sells for under $0.10

    31 parts599
  • 2 layers26.7 × 27.9 mmBreakout board, the printed circuit board in 3D

    Breakout board

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    31 parts546MIT
  • 2 layers100 × 50 mmPixelix, the printed circuit board in 3D

    Pixelix

    BlueAndi/Pixelix

    Full RGB LED matrix, based on an ESP32 and WS2812B LEDs or emulated LEDs on TFT.

    31 parts447MIT
  • 2 layers77.2 × 69.8 mmCubesatsim solar, the printed circuit board in 3D

    Cubesatsim solar

    alanbjohnston/CubeSatSim

    CubeSatSim, the AMSAT CubeSat Simulator

    31 parts419GPL-3.0
  • 2 layers103 × 55 mmTd neck-294, the printed circuit board in 3D

    Td neck-294

    tdaede/td-crt

    tubes

    31 parts373

Questions

How big is the Custom keeb PCB?

It measures 42.9 × 44 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Custom keeb use?

31 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Custom keeb KiCad files?

From the bo-aryan/custom-keeb repository on GitHub, at the commit this page was made from: the board is hardware/custom keeb.kicad_pcb and its schematic hardware/custom keeb.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Custom keeb design in my own project?

Its repository states no licence, so its author keeps all rights: ask bo-aryan before reusing the design.