Skip to the content
2 layers307.3 × 103.8 mmSpiritTotemMX, the printed circuit board in 3D

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.md

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 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

FolderContents
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.

Assembly

PCB and soldering

  1. Break the panelized PCB apart into its 3 boards (left, right, dongle) along the mouse-bite tabs, and lightly sand the broken edges smooth.
  2. 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.
  3. Solder the 2.54mm headers to the top face of each hand's board, where the XIAO will sit.
  4. Solder the JST connectors and the slide power switch into place.
  5. 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.
  6. 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.stl and Bottom.stl are single files — print one of each and mirror a second copy of each in your slicer for the other hand. Switchplate.stl and Switchplate-left.stl are 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:

  1. Everything off.
  2. Plug in the dongle.
  3. Power on the left half, and wait a moment.
  4. 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

text
  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.

text
 ...    ...    ...    ...    ...      ...    Home    Up    PgUp   End
 Gui    Alt    Ctrl   ...    ...      Del    Left   Down  Right   PgDn
 ...    ...    ...    ...    ...    ...      Ins    ...    ...    ...    ...    ...
     ...       ...       ...         ...       ...       ...

Sym

Hold the right thumb's Sym/Bspc key.

text
  1      2      3      4      5        6      7      8      9      0
  !      @      #      $      %        ^      &      *      (      )
Studio   (      [      {      <      `        ~      >      }      ]      )     ...
     ...       ...       ...         ...       ...       ...

Fun

Hold the right thumb's Fun/\ key.

text
  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.

text
  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     ToBase

QWERTY, 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/ and PCB/) 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 .uf2 binaries in Firmware/Colemak/ are just compiled output from that source.

Parts

111
QtyValueFootprintReferences
40Diode_SMD:ComboDiode-SOD-ThroughD1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +24
38Library:MX-ergogenS1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22, S23 +22
9, , , , , , , ,
4JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalConnector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalL_Bat_Bat, L_Xiao_Bat, R_Bat_Bat, R_Xiao_Bat
3xiao-ble-thruholeKleeb-mcu:xiao-ble-thtU?, U?, U?
2PinSocket_1x03_P2.54mm_VerticalConnector_PinSocket_2.54mm:PinSocket_1x03_P2.54mm_VerticalL_Switch_Socket, R_Switch_Socket

The 96 most common of 111 parts.

Similar boards

  • 2 layers90 × 135 mmVoron badge, the printed circuit board in 3D

    Voron badge

    tanaes/whopping_Voron_mods

    111 parts787GPL-3.0
  • 2 layers79 × 38 mmEthersweep, the printed circuit board in 3D

    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 mmESP32-GATEWAY Rev I, the printed circuit board in 3D

    ESP32-GATEWAY Rev I

    OLIMEX/ESP32-GATEWAY

    ESP32 IoT Gateway board with BLE WIFI and Ethernet

    111 parts322Apache-2.0
  • 2 layers224 × 72 mmTanuki pcb3, the printed circuit board in 3D

    Tanuki pcb3

    SethSenpai/Tanuki

    An open source 40% keyboard

    111 parts286MIT
  • 2 layers58.4 × 50 mmPinpoint core, the printed circuit board in 3D

    Pinpoint core

    lab11/polypoint

    Indoor localization based on the DecaWave DW1000.

    111 parts143Apache-2.0
  • 2 layers164 × 95.3 mmTPS, the printed circuit board in 3D

    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 mmModemHAT, the printed circuit board in 3D

    ModemHAT

    astuder/ModemHAT

    Classic Phone Modem HAT for the Raspberry Pi

    111 parts56
  • 2 layers145 × 145 mmNeofighter, the printed circuit board in 3D

    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.