Temporal

A 40/44 key split ergonomic keyboard with wireless support. Features a breakoff pinky column with an optional encoder in the thumb cluster.

Design

Layout

• 40/44 keys with breakoff pinky column
• Column stagger and splay on pinky and ring columns

Hardware

• Kailh Choc v1 low-profile switches with hotswap sockets
• nice!nano or Pro Micro compatible microcontrollers
• Optional nice!view display
• Optional EC12 rotary encoder in thumb cluster
• Wireless with battery support
• Reversible PCB

Tools

• Ergogen generates the layout, PCB, plates and cases (config.yaml)
• KiCad v9 for via stitching and traces

Firmware

Temporal is designed to be used with ZMK. You can find the ZMK-config repository and keymap here.

Development

Prerequisites

• Node.js and npm
• Homebrew (for installing dependencies)

Setup

1. Install dependencies (OpenSCAD, KiCad, Inkscape, Maple Mono NF font, and KiCad plugins):

make deps

2. Generate PCBs and cases:

make gen

This will:

• Run Ergogen to generate PCB and case files
• Post-process PCBs (fix edge cuts, add ground planes)
• Configure KiCad project files with defaults from scripts/kicad_defaults.yaml
• Generate STL case files
• Export Gerbers for manufacturing

Note: The main pcbs/temporal/ PCB requires manual steps in KiCad after generation. See pcbs/temporal/README.md for details.

Build Guide

See docs/build-guide.md for assembly instructions and ordering information.

For a complete list of components needed, see docs/bom.md.

Keycaps

Temporal uses Kailh Choc v1 low-profile switches. For keycaps, you can use:

• KLP Lame Keycaps - 3D printable keycap files designed for Choc switches

Influences

Temporal is inspired by and takes influence from:

• TEMPEST by thrly
• TOTEM and KLOR by GEIST
• Hillside by mmccoyd