Skip to the content
2 layers334.6 × 100.2 mmLira, the printed circuit board in 3D

57-key 40% + numpad keyboard: Bluetooth/USB-C, hot-swap MX, RMK/Vial, and a built-in USB sound card (3.5 mm headset jack). Generated from source with KiCad.

Size
334.6 × 100.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
233
Nets
146
Pads
918
Tracks, vias
1,588, 346
Pours
651
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
16 Oct 2026
Updated
18 Oct 2026

Overview

Lira is an open-source printed circuit board by AndreaGiulianini, from the AndreaGiulianini/lira repository on GitHub, published under the MIT licence. It is a 2-layer board of 334.6 × 100.2 mm with 233 parts on 146 nets, routed with 1,588 tracks and 346 vias.

It is built around the E73-2G4M08S1C, CM108B and TPS7A0233DBV, with the CH334P, MCP73831 and 1N4148W among its other parts. Its parts include 64 diodes, 41 switches, 37 capacitors, 25 resistors and 6 ICs. It belongs with the audio and music and keyboards and input boards and the nRF52 and nRF5x boards of this library.

Main components

11

README

README.md

Lira

[!WARNING] This keyboard has never been built. It is a design only: no prototype of either version (wireless on branch main, wired on branch rp2040) has ever been ordered, assembled or powered on, and nothing here has been tested on real hardware. The circuit, PCB, case and firmware are generated and checked automatically and reviewed on paper, but passing those checks does not make a working board: there may be mistakes that only a real prototype would reveal. Do not put it into production, sell it or order it in quantity. If you build one anyway, treat it as an untested design: order the minimum quantity and expect to debug it yourself.

A 40% keyboard in the KBDfans Agar Mini layout, with a numpad on the left and a split 3u + 3u spacebar. Bluetooth + USB-C, hot-swap MX switches, RMK firmware with Vial, and a built-in USB sound card (3.5 mm headset jack at the back: headphones and microphone, with a headphone amplifier; on only in USB mode). It also works without a battery, from the cable alone. 3D-printed case inspired by the Apple M0110 (1984), top mount: the plate is screwed to the top frame and the PCB hangs from the switches, so no printed part has to hold the PCB flat.

Two versions of the same keyboard, one per git branch, with the same layout, plate and sound card, and the same case and keymap apart from the battery pocket and the Bluetooth keys:

BranchVersionMicrocontrollerPower
main (this one)wireless: Bluetooth + USB-CEbyte E73 module (nRF52840)LiPo battery, or the cable alone
rp2040wired: USB-C onlyRaspberry Pi RP2040 + 16 MB QSPI flashthe cable, no battery

The sound card only works over the cable (there is no audio over Bluetooth), so if the headset jack is what you want, the wired version is simpler and cheaper to build: no battery, no SWD probe, Economic assembly at JLCPCB.

keyboard

Inspiration and credits

None of the ideas here are mine: this board is a combination of things other people made, plus the one thing I always wanted and could not buy — a headset jack on a keyboard.

  • Layout — the 40% block with the split 3u + 3u spacebar is KBDfans' Agar Mini. The numpad on the left is my addition, and what makes it 57 keys.
  • Board — the "40% + numpad in one flat rectangular case" idea and the overall proportions are inspired by the Lyra, designed by alexbarb (case) with the PCB by KGOH and ILWrites. Lira is not a copy: it uses the Agar Mini body, a top-mount case and a completely different PCB.
  • The 3.5 mm headset jack — laptop headphones + microphone built into the keyboard itself. The sound card follows C-Media's own CM108B reference design behind a CH334P USB hub (see production/5-schematic-and-checks/differences-from-bluemicro840.txt).
  • Power, USB and programming — the BlueMicro840 (jpconstantineau/NRF52-Board), a board built with the same Ebyte E73 module; the differences are listed in the same file.
  • Case — the shape and colour follow the Apple M0110 (1984).

Thanks to all of them.

Where to find things

FolderWhat it contains
production/Everything to build the 57-key keyboard: files for JLCPCB, plate, case to print, firmware, pictures
guide/Complete guide: ordering from JLCPCB, what to buy, first programming, printing and assembly
source/The code that generates everything: edit only here, then regenerate

production/ is self-contained: it holds everything needed to build the keyboard (the bootloader too; the KiCad files use the footprint libraries in source/lib/) and has its own README listing the files and what to do with them:

text
production/
├── README.md                what's inside and what to do with it
├── 1-pcb-jlcpcb/            gerber-pcb.zip, bom.csv, cpl.csv
├── 2-plate/                 the plate: JLCPCB (FR4 gerbers), laser cut (DXF) or 3D printed (2 STL)
├── 3-case-3d-print/         the 4 STL pieces (+ step/)
├── 4-firmware/              .uf2 firmware, .hex bootloader, vial.json
├── 5-schematic-and-checks/  schematic (PDF) and the results of the automatic checks
├── kicad/                   PCB, plate and schematic to open in KiCad
└── images/                  layout, Blender renders: on a desk, every side, exploded, PCB

production/ is rewritten on every regeneration: do not edit it by hand.

How reliable it is

Everything below is checked on paper and in software, not a tested board (see the warning at the top).

The circuit, PCB, case and firmware are generated and checked automatically on every build:

  • the power / USB / programming circuit follows the BlueMicro840 and the sound card follows C-Media's CM108B/CM119B demo board; the differences from both are listed in production/5-schematic-and-checks/differences-from-bluemicro840.txt;
  • KiCad's ERC, a pin-by-pin check between circuit, PCB and schematic, and datasheet tests written independently of the design (erc-kicad.txt, consistency-check.txt, datasheet-checks.txt);
  • a mechanical fit check of the case against the finished PCB (fit-check.txt).

These checks reduce the risk; they do not replace a prototype. The guide, §8, lists what to verify on the first board.

Small hardware

ItemQuantity
M2 heat-set inserts (for a 3.2 mm hole, length 3 mm)6 (top frame: the plate's ears)
M2 × 5 mm socket-head screws (DIN 912)6 (plate to top frame)
Short M3 heat-set inserts (Ø ~4.5 mm, length 3 mm, for a 4.0 mm hole)11 (top frame)
M3 × 12 mm socket-head screws (DIN 912)8 (front and sides)
M3 × 20 mm socket-head screws (DIN 912)3 (back: through the PCB's holes and the plate's tabs)
Ø 3 × 14 mm alignment pins (steel rod or 3 mm filament)4
Ø 12 mm rubber feet4
1 mm double-sided foam tape (holds the battery)one 55 × 37 mm piece
Long 2.5 mm hex key (some M3 screw holes are 21 mm deep) and a 1.5 mm hex key (M2)1 + 1

Printing the case

  • No supports. Top frames: lying on their flat underside (the side the plate screws to), deck up: the STL files are exported tilted, as assembled, so use the slicer's “lay on face” on that flat underside. Bottom halves: placed the way they sit on the desk.
  • PLA or PETG, 3 perimeters, 5 solid top layers and 4 bottom layers. Infill: top frames gyroid 15 %, bottom halves gyroid 8 % or lightning. The strength comes from the walls and the solid layers, not from the inside.
  • Material (estimate, PLA): about 300–320 g this way, versus about 370 g with 15 % everywhere. The bottom halves are already 85 % empty inside: designing cavities into them would cost more (tried it: 290 g instead of 273 g), because every cavity adds walls, a ceiling and ribs that print solid.
  • For the fine texture of the M0110: light "fuzzy skin" (0.1 mm) on the outer surfaces, or textured spray paint.
  • Reference colour: warm beige between #C8C2A0 and #D5D0B4 (Pantone 453 was the original).
  • The case is split to fit a 256 mm bed: with a bigger printer, change BED in source/case/gen_case.py and regenerate.

Editing and regenerating

Edit only source/ (for example layout.py for the keys, case/gen_case.py for the case), then:

sh
cd source
make all            # regenerates everything (about 25 minutes on an M4, most of it the Blender renders)
make pcb            # or a single step: see source/README.md

Technical details in source/README.md.

License

MIT — that covers everything in this repository that I made.

The firmware is built on RMK and the embassy crates (MIT / Apache-2.0) and is configured with Vial (GPL-2.0, used, not bundled).

Bundled third-party parts keep their own terms and are not relicensed by the above: source/tools/KeyV2 (GPL-3.0, a git submodule), the bootloader (Adafruit, MIT, containing Nordic's S140 SoftDevice under Nordic's licence), Nordic's MPSL / SoftDevice Controller libraries linked into the firmware (Nordic 5-clause licence), the kiswitch footprints and 3D models under source/lib/ (CC BY-SA 4.0), and the vendor symbols/models (KiCad, LCSC). The Lyra and the KBDfans Agar Mini are cited as inspiration only — no files from either are included here.

Parts

233
QtyValueFootprintReferences
571N4148WD_SOD-123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +41
101uFC_0603_1608MetricC102, C108, C110, C118, C123, C126, C129, C130, C135, C136
8M2MountingHole_2.2mm_M2H1, H2, H3, H4, H5, H6, H7, H8
7100nFC_0603_1608MetricC109, C112, C114, C115, C117, C119, C137
610kR_0603_1608MetricR103, R104, R120, R121, R122, R123
610uFC_0603_1608MetricC101, C111, C113, C120, C121, C122
4100kR_0603_1608MetricR101, R112, R117, R125
41kR_0603_1608MetricR102, R107, R116, R118
44.7uFC_0603_1608MetricC103, C107, C116, C127
4600R@100MHzL_0603_1608MetricL101, L102, L103, L104
3100pFC_0603_1608MetricC124, C125, C128
310nFC_0603_1608MetricC104, C138, C139
3PESD5V0D_SOD-323D105, D106, D107
3case boltMountingHole_3.2mm_M3HB1, HB2, HB3
2.SW_Hotswap_Kailh_MX_1.00uSW47, SW51
210MR_0603_1608MetricR105, R106
218pFC_0603_1608MetricC105, C106
22.2uFC_0603_1608MetricC133, C134
222R_0603_1608MetricR110, R111
25.1kR_0603_1608MetricR108, R109
2B5819WD_SOD-123D101, D104
2SI2301CDSSOT-23Q1, Q2
2TPS7A0233SOT-23-5U3, U9
2optionSW_Hotswap_Kailh_MX_1.00uSW52, SW57
2spaceSW_Hotswap_Kailh_MX_3.00uSW54, SW55
2stab 2uStabilizer_Cherry_MX_2.00uST37, ST50
2stab 3uStabilizer_Cherry_MX_3.00uST54, ST55
2⌘SW_Hotswap_Kailh_MX_1.25uSW53, SW56
1+SW_Hotswap_Kailh_MX_1.00uSW21
1,SW_Hotswap_Kailh_MX_1.00uSW46
1-6 dBSolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mmJP3
10SW_Hotswap_Kailh_MX_2.00uSW50
11SW_Hotswap_Kailh_MX_1.00uSW34
11R_0603_1608MetricR126
11.2kR_0603_1608MetricR114
112MHzCrystal_SMD_3225-4Pin_3.2x2.5mmY2
11MR_0603_1608MetricR113
12SW_Hotswap_Kailh_MX_1.00uSW35
12.2kR_0603_1608MetricR115
12N7002SOT-23Q3
13SW_Hotswap_Kailh_MX_1.00uSW36
132.768kHzCrystal_SMD_3215-2Pin_3.2x1.5mmY1
133kR_0603_1608MetricR124
13V3TestPoint_Pad_D1.0mmTP3
14SW_Hotswap_Kailh_MX_1.00uSW18
15SW_Hotswap_Kailh_MX_1.00uSW19
16SW_Hotswap_Kailh_MX_1.00uSW20
17SW_Hotswap_Kailh_MX_1.00uSW1
18SW_Hotswap_Kailh_MX_1.00uSW2
19SW_Hotswap_Kailh_MX_1.00uSW3
1;SW_Hotswap_Kailh_MX_1.00uSW32
1ASW_Hotswap_Kailh_MX_1.00uSW23
1BSW_Hotswap_Kailh_MX_1.00uSW43
1CSW_Hotswap_Kailh_MX_1.00uSW41
1CH334PWCH_QFN-16-1EP_3x3mm_P0.5mm_EP1.8x1.8mmU5
1CM108BLQFP-48_7x7mm_P0.5mmU6
1DSW_Hotswap_Kailh_MX_1.00uSW25
1ESW_Hotswap_Kailh_MX_1.00uSW8
1E73-2G4M08S1CWIRELM-SMD_E73-2G4M08S1CU1
1FSW_Hotswap_Kailh_MX_1.00uSW26
1GSW_Hotswap_Kailh_MX_1.00uSW27
1GNDTestPoint_Pad_D1.0mmTP4
1HSW_Hotswap_Kailh_MX_1.00uSW28
1ISW_Hotswap_Kailh_MX_1.00uSW13
1JSW_Hotswap_Kailh_MX_1.00uSW29
1JS102011SAQNSW_SPDT_CK_JS102011SAQNSW101
1KSW_Hotswap_Kailh_MX_1.00uSW30
1LSW_Hotswap_Kailh_MX_1.00uSW31
1LED redLED_0603_1608MetricD103
1LED whiteLED_0603_1608MetricD102
1MSW_Hotswap_Kailh_MX_1.00uSW45
1MCP73831SOT-23-5U2
1NSW_Hotswap_Kailh_MX_1.00uSW44
1OSW_Hotswap_Kailh_MX_1.00uSW14
1PSW_Hotswap_Kailh_MX_1.00uSW15
1PJ-320D-4AJack_3.5mm_KoreanHropartsElec_PJ-320D-4A_HorizontalJ3
1QSW_Hotswap_Kailh_MX_1.00uSW6
1RSW_Hotswap_Kailh_MX_1.00uSW9
1RESETTestPoint_Pad_D1.0mmTP5
1SSW_Hotswap_Kailh_MX_1.00uSW24

The 202 most common of 233 parts.

Similar boards

  • 2 layers40 × 22.8 mmDigiport general, the printed circuit board in 3D

    Digiport general

    BD5HLI/DigiPort

    集成USB口和声卡的业余电台数据模式接口盒子

    36 parts15GPL-3.0
  • 8 layersRound pendant, the printed circuit board in 3D

    Round pendant

    sequoia-hope/ultraroute

    PCB autorouting experiments around copperroute: route jobs, leaderboards, board morphing

    342 parts1MIT
  • 4 layers86 × 34 mmBsl drv v1, the printed circuit board in 3D

    Bsl drv v1

    jackw01/scanlight

    A better light source for scanning color negative film

    157 parts397CERN-OHL-W-2.0
  • 2 layers144.9 × 59.8 mmMonkeys, the printed circuit board in 3D

    Monkeys

    PacketChat/MonkeyBadge

    This repository contains the hardware design files, badge code, and backend infrastructure code for the HushCon Winter 2023 badge.

    153 parts21
  • 2 layers58 × 79 mmMp3, the printed circuit board in 3D

    Mp3

    RafaeloxMC/mp3

    Oooh, an MP3 player! I wanted to build this myself to be able to distance from my phone and still listen to music (if you want to read my full thoughts, see the section below)!

    51 parts1
  • 4 layers83.4 × 42.1 mmH C3-ulp29, the printed circuit board in 3D

    H C3-ulp29

    martinberlin/H-C3-029-eink

    This is a joint project between Larry Bank and Fasani Corp with the purpouse to make an easy and unexpensive nRF52 BLE badge with a SPI 2.9", a QWIIC connector, and on board RTC

    54 parts5MIT
  • 2 layers44.5 × 35.7 mmPaddle bridge, the printed circuit board in 3D

    Paddle bridge

    mlsorensen/Apollo2

    Second generation Micra remote and brew by weight

    23 parts13MIT
  • 2 layers76.2 × 38.1 mmWgcMax17Uart0805, the printed circuit board in 3D

    WgcMax17Uart0805

    RetiredBill/Max17841UartPCB

    Small printed circuit board based on Maxim MAX17841B chip for talking to MAX17843 chip based designs

    128 partsCC-BY-SA-4.0

Questions

How big is the Lira PCB?

It measures 334.6 × 100.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Lira use?

233 parts, built around the E73-2G4M08S1C, CM108B, TPS7A0233DBV and CH334P. 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 Lira KiCad files?

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

Can I use the Lira design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).