Skip to the content
2 layers345 × 120 mmKeeb, the printed circuit board in 3D

Keyboard for Hack Club KEEB

Size
345 × 120 mm
Copper layers
2
Thickness
1.6 mm
Parts
204
Nets
135
Pads
653
Tracks, vias
859, 20
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
20 Aug 2026
Updated
8 Oct 2026

Overview

Keeb is an open-source printed circuit board by qubixal, from the qubixal/qbMX repository on GitHub. It is a 2-layer board of 345 × 120 mm with 204 parts on 135 nets, routed with 859 tracks and 20 vias.

It is built around the 1N4148W and SK6812MINI-E. Its parts include 86 diodes, 85 switches, 15 capacitors, 15 inductors and 1 IC. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

2

README

README.md

qbMX

A custom mechanical keyboard built from scratch for Hack Club Keeb YSWS.

Full Render

Overview

qbMX is a fully custom mechanical keyboard designed in KiCad and Fusion. It features:

  • 85-key (79+6) layout with a rotary encoder, modelled after Apple's Magic Keyboard.
  • Cherry MX Low-Profile Red switches, and on-plate stabalisers (instead of on-pcb)
  • Uses the RP2040 microcontroller (Orpheus Pico)
  • A 0.91" 128x32 OLED display
  • 15 mini-LEDs at the top of the keyboard
  • Custom PCB, ordered and assembled by me

Why I Built qbMX

I wanted to learn about and build a keyboard myself, since I'd never done it before. Designing the matrix and optimising GPIO lanes with functionality was a cool challenge. Oh, and I just wanted a keyboard; and Keeb gave me an excuse to make it.

What's in This Repo

PathDescription
keeb.kicad_schSchematic
keeb.kicad_pcb / keeb.kicad_proKiCad PCB layout & project
pcb/ + pcb.zipGerbers & drill files (F.Cu, B.Cu, silkscreen, mask, Edge.Cuts)
*.step3D models (board, OLED, rotary encoder, plate)
key-switches.pretty/, extra_key.pretty/Footprint libraries
readme-library/Photos & renders
bom.csvBill of materials

Use Guide

After building all physical hardware, download the firmware folder then:

cmd
export PICO_SDK_PATH=/path/to/pico-sdk

cd firmware && mkdir build && cd build

cmake .. && make

hold BOOTSEL on the Pico, plug in the USB and drag qbmx.uf2 to the mass storage device.

OLED Shows 5 pages: 0. Current keyboard layer

  1. Custom text/bitmap
  2. LED mode + brightness
  3. WPM counter with bar graph
  4. Host temps (CPU avg, GPU avg, Pico internal temp)

For temperature tracking to work properly,

  1. Install pyserial
cmd
pip3 install pyserial
  1. Run host script which auto-detects the Pico port
cmd
python3 firmware/host_temp.py

Note: osx-cpu-temp will return 0.0°C on Apple Silicon Macs without SMC entitlements; where the OLED will show N/A in this case. You may instead compile osx-cpu-temp from source or use sudo powermetrics.

Programmable Keys (Column 14, Rows 0-5)

By default they are mapped to F13-F18 (USB HID keycodes 0x68 -> 0x6D), which is recognised by every major OS. It can be remapped in system settings.

Other functions include: Short press rotary encoder to pause, Long press rotary encoder to toggle between volume and brightness (backlight) mode

Build Log / Journal

See JOURNAL.md.

BOM

See bom.csv.

Acknowledgements

Parts

204
QtyValueFootprintReferences
861N4148WDiode_SMD:D_SOD-123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +70
76Pushkeys:SW_MX_LowProfile_THTSW2, SW10, SW11, SW12, SW13, SW14, SW15, SW16, SW17, SW18, SW19, SW20, SW21, SW22, SW23, SW24 +60
150.1uFCapacitor_SMD:C_0603_1608MetricC1, C2, C3, C4, C5, C6, C7, C8, C9, C10, C11, C12, C13, C14, C15
15SK6812MINI-ELED_SMD:LED_SK6812MINI-E_3.2x2.8mm_P1.5mm_ReverseMountL1, L2, L3, L4, L5, L6, L7, L8, L9, L10, L11, L12, L13, L14, L15
9Pushkeys:SW_MX_LowProfile_THT_NoKeySW1, SW28, SW30, SW45, SW57, SW59, SW70, SW76, SW77
1ER_OLEDM0.91_1x-I2CDisplay:ER_OLEDM0.91_1x-I2CU1
1RE Swtchrotary_encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm_CircularMountingHolesRE1
1RaspberryPi_PicoModule:RaspberryPi_Pico_Common_THTA1

Similar boards

  • 2 layers99.1 × 90.7 mmBgkeeb, the printed circuit board in 3D

    Bgkeeb

    sadekbaroudi/bgkeeb

    This is a reversible 100mm x 100mm pcb with support for mx or choc switches (no hotswap), per key led, rotary encoders, and exposes the SDA/SCL/GND/VCC lines in the form of the pimoroni trackball pins (meaning you can…

    108 parts108
  • 2 layers291.8 × 134.6 mmMegaXE keyboard, the printed circuit board in 3D

    MegaXE keyboard

    bleroy/3d-junkyard

    Random 3D models

    359 parts69
  • 2 layers243.9 × 136.5 mmBarobord, the printed circuit board in 3D

    Barobord

    sadekbaroudi/barobord

    I have spent a lot of time and money designing prototypes, testing, developing, etc. Any contributions would be greatly appreciated!

    157 parts57
  • 2 layers227.3 × 84.9 mmStm32 hotswap chiffre, the printed circuit board in 3D

    Stm32 hotswap chiffre

    sporkus/le_chiffre_keyboard_stm32

    Le Chiffre keyboard pcb with stm32F072

    110 parts53CERN-OHL-W-2.0
  • 2 layers43.5 × 33.9 mmAdapter, the printed circuit board in 3D

    Adapter

    Bastardkb/Charybdis-EC11

    EC11 PCB to be used in place of the trackball in the Charybdis keyboard.

    26 parts24
  • 2 layers142.6 × 120 mmUrsula, the printed circuit board in 3D

    Ursula

    jimmerricks/ursula

    124 parts21
  • 2 layers100 × 95.3 mmDaNumPad Glow 20, the printed circuit board in 3D

    DaNumPad Glow 20

    TweetyDaBird/DaNumPad

    A Numpad

    117 parts19
  • 2 layers289.7 × 109.1 mmWlfkbd, the printed circuit board in 3D

    Wlfkbd

    WillACosta/wlfkbd

    The WLF is a 40-key split keyboard (20 keys per half) with a column-staggered matrix and a splayed thumb cluster.

    214 parts19MIT

Questions

How big is the Keeb PCB?

It measures 345 × 120 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Keeb use?

204 parts, built around the 1N4148W and SK6812MINI-E. 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 Keeb KiCad files?

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

Can I use the Keeb design in my own project?

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