Set up your build
Devices
The tower is the keyboard the computer sees; the cats talk to it.
Left cat
in review
qualified
in review
Right cat
in review
qualified
in review
Have you got everything?
Tick what you have; the ticks stay in this browser.
Start building →
Or one file:
What's in the package
One ZIP for offline use, made now from dev@e21e4f5.
START-HERE.mdWhat the package holds, the setup and what it lacksguide.htmlThe steps your build needs, with warnings, commands and checks; opens offlineparts.csvThe parts list, for a spreadsheetbuild-sheet.mdSetup, parts and steps in one Markdown filewiring.mdEvery wire to solder, hand by handprints/The STL of each printed part your build needs: 12 files, 5.4 MBmanifest.jsonThe setup, each area's revision, the gaps and every file's sha256
What the build information lacks is listed in it too: nothing missing is filled in. Each part of the project's export refreshes on its own, so the package names each revision.
| boards | dev@f162cad | 2026-10-17 |
|---|---|---|
| data | dev@e21e4f5 | 2026-11-01 |
| docs | dev@459346a | 2026-10-24 |
| firmware | dev@459346a | 2026-10-24 |
| prints | dev@d5cce55 | 2026-10-24 |
| scene | dev@17752b3 | 2026-10-24 |
| schematics | dev@df568b6 | 2026-10-16 |
| setup-page | dev@d5cce55 | 2026-10-24 |
Not recorded yet: 4 gaps
- Every step is a draft: the maintainer has not reviewed them yet.
- Order the module boards
- Solder the key switches and headers
- Hand-solder the scroll-wheel encoder
- Wire each module header to the cat main board
- Get LYNX onto your computer
- Open the setup page
- Choose your setup on the page
- Plug in each board
- Build, flash and pair
- Set up your keys in Vial
- Bench-test before closing anything
- Print the enclosure parts
- Fit the LED plugs
- Mount each module board on its cover
- Put the modules into the casing
- Route the cables and seat the main board
- Close the lid
- Put on the keycaps
- 2 parts lack a quantity or a detail.
- USB-C cable: data-capable; length
- M1.6 x 5 mm pan head screws, self-tapping for plastic: a supplier and link; test-print a cover's boss and a casing boss for the pilot's grip
- No firmware files: the guide gives the commands that build and flash it from lynx-v4.
- The wiring drawings and 3D views are on the website only; the package has each wire as a table.
| Have | Part | Qty | For | Settings | File |
|---|---|---|---|---|---|
| Left casing | 1 | left | unknown: material, orientation, supports; not a closed mesh yet (mechanical/docs/open-issues.md) | left-casing-body.stl 1.7 MB | |
| Right casing | 1 | right | unknown: as left-casing-body | right-casing-body.stl 1.7 MB | |
| Left lid, plain, without battery | 1 | left | 0.2 mm layers · as left-lid-plain-body | left-lid-plain-no-battery-body.stl 0.3 MB | |
| Right lid, plain, without battery | 1 | right | unknown: as left-lid-plain-body | right-lid-plain-no-battery-body.stl 0.3 MB | |
| Left finger module cover, 21 keys | 1 | left | standing on its tilt cut, as the STL lies | left-finger-module-21-keys-cover.stl 0.4 MB | |
| Right finger module cover, 20 keys + scroll wheel | 1 | right | unknown: as the left finger cover | right-finger-module-20-keys-scroll-wheel-cover.stl 0.4 MB | |
| Left thumb module cover, 11 keys | 1 | left | standing on its tilt cut, as the STL lies | left-thumb-module-11-keys-cover.stl 0.2 MB | |
| Right thumb module cover, 11 keys | 1 | right | unknown: as left-thumb-module-11-keys-cover | right-thumb-module-11-keys-cover.stl 0.2 MB | |
| LED plug | 4 | left, right | unknown: translucent material | Thumb-LED-Plug.stl 0.0 MB | |
| Keycap | 45 | left, right | unknown: material, orientation | Key-Cap.stl 0.0 MB | |
| Anchor keycap | 8 | left, right | unknown: material, orientation | Key-Cap-Anchor.stl 0.0 MB | |
| Hump keycap | 10 | left, right | unknown: material, orientation | Key-Cap-Hump.stl 0.0 MB |
Buy or source
The circuit boards are ordered from a board house, bare or assembled: Order your circuit boards.
| Have | Part | Category | Manufacturer | MPN | LCSC | Qty | For |
|---|---|---|---|---|---|---|---|
| Left finger module, 21 keys | PCB | — | — | — | 1 | left-F21 | |
| Left thumb module, 11 keys | PCB | — | — | — | 1 | left-T11 | |
| Right finger module, 20 keys + scroll wheel | PCB | — | — | — | 1 | right-F20W | |
| Right thumb module, 11 keys | PCB | — | — | — | 1 | right-T11 | |
| 1N4148WS T4 | Component | CJ(江苏长电/长晶) | 1N4148WS T4 | C2128 | 64 | left-F21, left-T11, right-F20W, right-T11 | |
| PH2.54-1X10P-H25 | Component | JXTCONN(聚兴泰) | PH2.54-1X10P-H25 | C42431810 | 2 | left-F21, left-T11 | |
| K9-1267T | Component | 韩国韩荣 | K9-1267T | C107266 | 63 | left-F21, left-T11, right-F20W, right-T11 | |
| SK6812mini-012 | Component | OPSCO(欧思科) | SK6812mini-012 | C2886570 | 4 | left-T11, right-T11 | |
| KH-2.54PH180-1X13P-L11.5 | Component | kinghelm(金航标) | KH-2.54PH180-1X13P-L11.5 | C2932703 | 1 | right-F20W | |
| Roll Encoder - EVQWGD001 | Component | Panasonic | EVQWGD001 | — | 1 | right-F20W | |
| A2541WV-10P | Component | CJT(长江连接器) | A2541WV-10P | C225485 | 1 | right-T11 | |
| BPI-Leaf-S3 (ESP32-S3) | Purchased | Banana Pi | — | — | 2 | left, right | |
| USB-C cable unknown: data-capable; length | Purchased | — | — | — | 2 | left, right | |
| M1.6 x 5 mm pan head screws, self-tapping for plastic unknown: a supplier and link; test-print a cover's boss and a casing boss for the pilot's grip | Purchased | — | — | — | 32 | left, right | |
| Self-adhesive rubber bumper pads, 8 x 3 mm | Purchased | — | — | — | 16 | left, right | |
| LILYGO T-Dongle-S3 | Purchased | LILYGO | — | — | 1 | tower |
Gather tools
- soldering iron
- multimeter
- Linux computer
- 3D printer
- screwdriver
Parts, prints and steps: © 2025-2026 lynx-v4 contributors · CERN-OHL-S-2.0 AND CC-BY-SA-4.0 AND GPL-3.0-or-later