compareeHub

KEYCHRON JUST PUBLISHED THE 3D FILES FOR ITS KEYBOARDS AND MICE — FOR FREE

Keychron published free 3D CAD files for more than 100 of its keyboards and mice — study them, print parts for yourself, or design accessories that fit.

by Keychron

FULL CAD BOM FIRMWARE DOCS

Open-hardwareWorkshop

Built with3D printing

difficulty
●●○○○
time
an evening per part
license
Keychron Source-Available License (personal and educational use; commercial use only for original compatible accessories)
repo
repo ACTIVE3,784 stars

WHAT YOU’LL NEED

1
Jump to section

COMPAREE VERDICT

Keychron did something rare for a hardware company: it put production CAD files for its keyboards and mice on GitHub, free to download. The repository has CAD files for more than 100 keyboard and mouse models, mostly as STEP 3D models with DWG, DXF and PDF drawings on many of them, so you can study how a production keyboard is built, design a custom case or plate for your own board, or make accessories that fit. This is not a kit or a step-by-step build guide; it is a library of geometry with short guides on file formats, getting started and 3D printing. The licence is source-available, not open source: personal and educational use is fine, and you may sell original compatible accessories, but you may not sell copies of Keychron keyboards, mice or their cases, or use Keychron branding as your own. What will trip people up: coverage varies by model, and some newer series only have a model page so far. If you already own a Keychron and know your way around CAD and a 3D printer, this is exactly the reference that was missing.

GOOD TO KNOW

  • —Files are on GitHub in the Keychron-Keyboards-Hardware-Design repository; many large downloads are linked from each model's README to Keychron's server
  • —Mostly STEP 3D models, plus DWG, DXF and PDF drawings on many models
  • —Covers 171 listed device models, including 21 mice and keycap profiles; some newer folders have no CAD files yet
  • —Keychron Source-Available License: personal and educational use allowed, original compatible accessories may be sold, copies of Keychron products may not
  • —Includes guides for file formats, getting started, 3D printing and the licence; there is no parts list or assembly guide
  • —Keyboard firmware is published separately in Keychron's QMK and ZMK repositories, not in this design repository

Parts to buy

2 items

From our check of the build. Exact quantities and part numbers are in the creator’s BOM.

  • Keychron keyboard or mouse if you want the internalsFind
  • Filament for the parts you printFind

Can I build this?

PrintCustom cases, plates, feet or accessories based on the STEP models for your Keychron model
Buya Keychron keyboard or mouse if you want the internals, filament for the parts you print
Tools3D printer, CAD software that reads STEP files (FreeCAD, Onshape, Fusion 360), slicing software
SkillsBasic 3D printing and CAD literacy — importing STEP files, modifying geometry and slicing for your printer
Timean evening per part — printing a case will take longer than printing a replacement foot
Cost$ — filament only, unless you are buying a Keychron to mod (then $$)
SafetyNone beyond ordinary 3D printing care — heated nozzles and beds, ventilation if printing ABS or similar.

Build at your own risk. Projects involve tools, electronics and sometimes mains voltage — follow the creator’s safety notes.

More builds like this

All projects
You can build the printer that melts PEEK for 2,665 dollarsWorkshopYou can 3D print a machine that winds carbon fiber tubesWorkshopOpenCAL: an open-source volumetric 3D printer that cures a whole object at once, no layersWorkshop

Gallery

notebookcheck.net
github.com

Start here

Navigation into the creator’s own docs — we don’t rewrite the guide, we route you to the source.

  1. 1.Find your model in the Keychron Hardware Design repository (Open the folder for the model you own and check its README; the Downloads section links to the STEP and drawing files)
  2. 2.Open the STEP file in CAD software (FreeCAD is free and reads STEP natively; Onshape, Fusion 360, SolidWorks and Rhino work too)
  3. 3.Read the licence FAQ before you remix or share anything (Personal remixes are fine; selling is only allowed for original compatible accessories)
  4. 4.Export to STL, slice and print (Export only the part you need, print a small fit-check first, then the full part)

Resources

Documentation, files and community threads for this build — we link straight to the original sources and never rehost the creator’s files.

KNOWN ISSUES

  • The licence is source-available, not open source — personal remixes are fine, but you cannot sell copies of Keychron cases, keyboards or mice, and you cannot redistribute modified files without Keychron's permission.
  • This is not a project to build a keyboard from scratch — a printed case still needs the matching Keychron PCB, plate, switches and other internals.
  • Coverage varies by model: some folders have full models, plates and PCBs, others only a single STEP file, and some newer series only have a model page so far.
  • Many large files are not stored in the Git tree itself; the model README links to downloads on Keychron's own server, so check the Downloads section of each model folder.
  • STEP exports are not automatically print-ready — check wall thickness, screw bosses, switch cutouts and tolerances, and print a small fit-check part first, as the repository's 3D printing guide recommends.
  • Use Keychron's name only in plain compatibility wording such as "compatible with Keychron Q1", never as your own branding.

Can I sell the parts I print?

Only if they are original accessories or add-ons that work with a Keychron product, such as stands, holders or covers. You may not sell copies of Keychron cases, keyboards, mice or substantially similar products, and you may not use Keychron branding beyond plain compatibility wording like "compatible with Keychron Q1". Personal remixes of Keychron's own parts are for your own non-commercial use.

Do I need to own a Keychron to use these files?

No, anyone can download and study them. They are most useful if you own the matching model, because the files describe Keychron's own cases, plates and internals — a printed case still needs the original PCB, plate and switches.

Are the mice included?

Yes. The Mice folder covers 21 models, including the M series, the G1 to G6 HE and G9 HE gaming mice, the BM series and Nape Pro. Coverage varies by model: for example, G3, G4 and G5 each have a complete STEP model, while some other folders hold shell files or receiver parts.

What file formats are there, and what software do I need?

Mostly STEP 3D models, plus DWG and DXF drawings and PDFs on many models. Any CAD tool that reads STEP works — FreeCAD is free, Onshape runs in the browser, and Fusion 360, SolidWorks and Rhino work too.

Is every Keychron model available?

Not yet. The repository lists 171 device models, but some newer series folders only contain a model page so far, with CAD files to follow. Check the model folder before planning a project.

Community builds

No community builds yet — be the first, we feature the best ones.

Discussion1

FROM THE COMPAREE TEAM

Keychron put production CAD files for more than 100 of its keyboards and mice on GitHub. Would you design a custom case, an accessory, or use them for repairs?

CompareeTEAM1d ago

Practical notes from our verification: the files live on GitHub in Keychron's Keyboards Hardware Design repository, and each model's README links to the downloads, many of them hosted on Keychron's own server. Mice are included — the G3, G4 and G5 each have a complete STEP model. The licence is Keychron's own source-available licence, not an open-source one: personal remixes are fine and original compatible accessories can be sold, but copies of Keychron products cannot. The single biggest win is not printing a whole case — it is designing a part or accessory that fits your board exactly, using the real geometry.

Keychron

Keychron is a mechanical keyboard and mouse manufacturer known for Mac-friendly layouts, wireless boards and QMK/VIA support. In 2026 it began publishing production CAD files for its keyboards and mice on GitHub under a source-available licence, to support modding, repair, learning and compatible accessories — a rare move for a commercial hardware company.

GitHub Web

Star the project on GitHub

DISCLAIMER

  • Comparee is not the author of the projects featured here. All rights to each project belong to its creator — every page links to the original source, and we never host creators’ files.
  • Information is provided without warranty and may become outdated as projects evolve. Prices are indicative bands only — always check the creator’s parts list for current costs.
  • Building and operating any project is at your own responsibility. Protective equipment, safe workshop practice and compliance with local regulations are the builder’s responsibility.
GitHub repo