

SpiritTotemMX
A port of the TOTEM split keyboard to MX-style hot-swap switches, with a few of my own additions (per-half battery-charge LEDs on the dongle, an on-demand battery check, and sleep management for each half — see…
- Size
- 307.3 × 103.8 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 111
- Nets
- 69
- Pads
- 620
- Tracks, vias
- 8,380, 17
- Pours
- 185
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 5 Sep 2026
- Updated
- 5 Sep 2026
Overview
SpiritTotemMX is an open-source printed circuit board by The-Architects727, from the The-Architects727/SpiritTotemMX repository on GitHub. It is a 2-layer board of 307.3 × 103.8 mm with 111 parts on 69 nets, routed with 8,380 tracks and 17 vias.
Its parts include 40 diodes and 38 switches. It belongs with the keyboards and input boards and the nRF52 and nRF5x boards of this library.
README
README.mdSpiritTotemMX
A port of the TOTEM split keyboard to MX-style hot-swap switches, with a few of my own additions (per-half battery-charge LEDs on the dongle, an on-demand battery check, and sleep management for each half — see Firmware).
This repo has everything needed to build one from scratch: the 3D-printable case, the PCB design and fabrication files, ready-to-flash firmware, and the full assembly guide below.
The layout is inspired by the original TOTEM — a printed test of that shape was comfortable enough for my hands that I built the rest of this board around it, redesigning the PCB and case for MX switches from scratch. The XIAO boards sit on hot-swap headers rather than being soldered in directly, so they can move to a different project later if needed. Currently FDM printed in PLA with no tenting solution yet — both are on the list for a future revision.
Contents
What's in this repo
| Folder | Contents |
|---|---|
Case/ | STL files for 3D printing the case and keycaps |
PCB/ | KiCad project source and fabrication-ready Gerbers/BOM/positions |
Firmware/ | Pre-built .uf2 firmware, ready to flash |
Bill of materials
Links are the specific listings used for this build, not strict requirements — quantities are usually a bulk pack, and most of these have plenty of equivalent alternatives if a listing goes stale.
- 1 PCB — the left half, right half, and dongle are all panelized onto a
single board you order as one piece (see
PCB/) - 38× key switches — Keychron Super Switch, tactile, 110-pack
- 38× Kailh hot-swap sockets — Kailh CPG151101S11, 50-pack
- 38× diodes (through-hole or SMD) — 1N4001, DO-41, 120-pack (1N4148 is the more common choice for keyboard matrices, but 1N4001 works fine here too)
- 3× Seeed Studio XIAO nRF52840 boards, with headers on — Seeed Studio, 3-pack
- 2× JST 2.0 female wire connectors (battery leads for the two hand boards) and 4× JST 2.0 male PCB connectors — one kit covers both: JST-PH 2.0mm 2-pin, male+female with 10cm wire, 20 sets
- 2× through-hole PCB slide switches (mounted sideways so they poke out the side of the case) — Chanzon SPDT 3mm slide switch, 70-pack
- 2.54mm pitch headers for the XIAO standoffs — 60 pin positions total — 2.54mm male/female pin headers, 30-pack
- 2× 3.7V JST 2.0 batteries, no more than 7mm thick × 20mm wide × 45mm long — AKZYTUE 3.7V 750mAh LiPo, JST PH2.0
- 2× 5mm LEDs
- 2× 330Ω resistors (through-hole or SMD)
- M2 brass heat-set inserts — Pofsnnx M2 brass heat-set inserts, 250-pack
- M2 screws: 6× 12mm, 1× 4mm — KADRICK M2 hex socket button head screw assortment, 1000-pack
Assembly
PCB and soldering
- Break the panelized PCB apart into its 3 boards (left, right, dongle) along the mouse-bite tabs, and lightly sand the broken edges smooth.
- Solder the diodes to the top face and the hot-swap sockets to the underside. The switchplate has cutouts to clear the diodes as long as they're soldered close to the board.
- Solder the 2.54mm headers to the top face of each hand's board, where the XIAO will sit.
- Solder the JST connectors and the slide power switch into place.
- Solder a JST female connector pigtail to the underside of each hand's XIAO board, for its battery. This is the fiddliest step — put a small blob of solder on the pad first, then push the wire into the molten blob with the iron in one hand and a small pair of pliers in the other.
- For the dongle: solder on the headers, then solder the two 5mm LEDs to the underside so they shine from the inside toward the outside edge, along with their resistors.
Case
Top.stlandBottom.stlare single files — print one of each and mirror a second copy of each in your slicer for the other hand.Switchplate.stlandSwitchplate-left.stlare not mirror images of each other — print each one exactly once.Case/KeyCaps/has the keycap profiles, designed to be printed flat on the bed while still having a swept (sculpted) profile — no supports needed despite the curve. Print 12×Home, 20×Top-Bottom, and 6×Thumb(38 keycaps total).- Press a 2mm brass insert into the hole in the dongle base's dovetail.
- Press a heat-set insert into every standoff hole in each hand's bottom case piece.
- Dongle: drop the PCB+XIAO assembly into the bottom housing, slide the top piece on and push it forward to lock the board in place, then secure with a single M2×4mm screw.
- Each hand: place the PCB on the bottom case, then the switchplate over it (press a few switches into place to hold the sandwich together while you work), then the top plate, and secure with a 12–16mm screw in each top hole.
First power-on
The dongle learns which half is "left" and which is "right" by whichever one it bonds to first — so the very first time, power things on in this order:
- Everything off.
- Plug in the dongle.
- Power on the left half, and wait a moment.
- Power on the right half.
After this first pairing, the two halves can be powered on in any order.
Keymap
Colemak-DH based, 5 layers. ... means "transparent" (falls through to
the layer below). A printable version with a visual key-by-key diagram of
every layer is at keymap-reference.pdf.
Base
Q W F P B J L U Y '
A R S T G M N E I O
Esc Z X C D V K H , . / -
Ctrl/Del Nav/Tab Space Shift/Ent Sym/Bspc Fun/\Nav
Hold the left thumb's Nav/Tab key.
... ... ... ... ... ... Home Up PgUp End
Gui Alt Ctrl ... ... Del Left Down Right PgDn
... ... ... ... ... ... Ins ... ... ... ... ...
... ... ... ... ... ...Sym
Hold the right thumb's Sym/Bspc key.
1 2 3 4 5 6 7 8 9 0
! @ # $ % ^ & * ( )
Studio ( [ { < ` ~ > } ] ) ...
... ... ... ... ... ...Fun
Hold the right thumb's Fun/\ key.
F1 F2 F3 F4 F5 F6 F7 F8 F9 F10
... ... ... ... ... ... ... ... F11 F12
BatChk Boot ... ... ... ... ... ... ... ... ToGame ...
... ... ... ... ... ...BatChk blinks the dongle's LEDs to report each half's battery charge in
10% steps. Boot reboots that half into its UF2 bootloader. ToGame
switches to the Game layer.
Game
Toggled from Fun's ToGame key; ToBase returns to Base.
T Q X E R Y U I O P
G A W D F H J K L ;
... B Z S C V N M , . / ...
Shift Ctrl Space Enter Bspc ToBaseQWERTY, except W/S/X are rotated one column so A, W, and D all land on the home row together with S directly beneath — this columnar layout puts W a row above A/D by default, which doesn't rest as naturally for WASD as a traditional keyboard's row stagger does. X moves up to W's old spot. The thumb cluster is set up for typical games (Shift, Ctrl, Space on the left; Enter, Backspace on the right) rather than mod-taps, since a key's brief "tap" behavior is exactly the kind of thing you don't want fighting with WASD-style movement.
Firmware
Firmware/Colemak/ has four ready-to-flash .uf2
files — one each for the left half, right half, dongle, and a
settings_reset image used to clear Bluetooth pairings if you ever need
to re-pair from scratch.
To flash a board: plug it into USB, double-tap its reset button to
drop it into bootloader mode (it shows up as a USB drive), then drag the
matching .uf2 file onto that drive. Flash all three main boards; only
use settings_reset if you need to re-pair.
This firmware also includes a few extras beyond the stock TOTEM build: per-half battery-charge LEDs on the dongle, an on-demand battery-level check from the keyboard itself, and independent sleep for each half (with a warning flash) that's triggered either manually or automatically when the dongle's out of reach.
Want to build it yourself, or modify it? The buildable source and GitHub Actions build workflow live in a separate repo, zmk-config-spirittotem, released under the MIT license.
License
- Case and PCB (everything in
Case/andPCB/) are licensed CC BY-SA 4.0: use, modify, and share freely, with credit, and any modified version you share stays under the same license. - Firmware is not included as source here (see Firmware) —
the buildable source lives in
zmk-config-spirittotem
under the MIT license. The pre-built
.uf2binaries inFirmware/Colemak/are just compiled output from that source.
Parts
111| Qty | Value | Footprint | References |
|---|---|---|---|
| 40 | Diode_SMD:ComboDiode-SOD-Through | D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +24 | |
| 38 | Library:MX-ergogen | S1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22, S23 +22 | |
| 9 | , , , , , , , , | ||
| 4 | JST_PH_B2B-PH-K_1x02_P2.00mm_Vertical | Connector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_Vertical | L_Bat_Bat, L_Xiao_Bat, R_Bat_Bat, R_Xiao_Bat |
| 3 | xiao-ble-thruhole | Kleeb-mcu:xiao-ble-tht | U?, U?, U? |
| 2 | PinSocket_1x03_P2.54mm_Vertical | Connector_PinSocket_2.54mm:PinSocket_1x03_P2.54mm_Vertical | L_Switch_Socket, R_Switch_Socket |
The 96 most common of 111 parts.
Similar boards
- 2 layers90 × 135 mm

- 2 layers79 × 38 mm

Ethersweep
Neumi/ethersweep
Open Source, easy to use Ethernet connected stepper motor controller. Built in FreeCAD, KiCAD and Arduino.
111 parts587 - 2 layers50.8 × 62.2 mm

ESP32-GATEWAY Rev I
OLIMEX/ESP32-GATEWAY
ESP32 IoT Gateway board with BLE WIFI and Ethernet
111 parts322Apache-2.0 - 2 layers224 × 72 mm

- 2 layers58.4 × 50 mm

- 2 layers164 × 95.3 mm

TPS
DreaM117er/Explorer-Keyboard-Blank
The 3rd Explorer Keyboard series, a Planck like split keyboard with muti cursor unit.
111 parts77MIT - 2 layers85 × 56.5 mm

- 2 layers145 × 145 mm

Neofighter
w4ilun/neofighter
A MIDI controller using arcade buttons with RGB lighting effects
111 parts51
Questions
How big is the SpiritTotemMX PCB?
It measures 307.3 × 103.8 mm and has 2 copper layers, 1.6 mm thick.
What parts does the SpiritTotemMX use?
111 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 SpiritTotemMX KiCad files?
From the The-Architects727/SpiritTotemMX repository on GitHub, at the commit this page was made from: the board is PCB/SpiritTotemMX.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
Can I use the SpiritTotemMX design in my own project?
Its repository states no licence, so its author keeps all rights: ask The-Architects727 before reusing the design.