Keychron-Keyboards-Hardware-Design README

The project's README from github.com/Keychron/Keychron-Keyboards-Hardware-Design. As one markdown file: README.md.

Keychron Hardware Design

Models Uploaded Repo Docs Star this repo

Production-grade hardware design files for Keychron keyboards and mice.

Study real CAD. Remix plates and cases. Design compatible accessories. Learn from how real products are built.

This project is source-available. Personal and educational use is allowed. Original compatible accessories and add-ons are not subject to the commercial-use restriction in this license, but you may not copy and sell Keychron keyboards or mice, and you may not use Keychron trademarks as your own branding.

Keychron hardware design hero

Latest Updates

Start Here

If you're new, begin with one of these paths:

What You Can Do With This Repository

What's Inside

Series Type Models Components
B Pro Series Keyboard B1 Pro, B2 Pro, B6 Pro Case, PCB, Full Model
C Series Keyboard C1 Plate, PCB, Top Case, Bottom Case, Full Model
C Pro 8K Series Keyboard C1 Pro 8K, C2 Pro 8K, C3 Pro 8K Case, Plate, Full Model, Stabilizer
J Series Keyboard J2, J5, J7 Plate, PCB, Bottom Case, Full Model
Q Series Keyboard Q0 Plus, Q1–Q12, Q60, Q65 Case, Plate, Encoder, Full Model, Stabilizer, OSA Keycap
Q Pro Series Keyboard Q1 Pro–Q14 Pro (10 models) Case, Plate, Encoder, Full Model, Stabilizer, KSA Keycap
Q HE Series Hall Effect Q0 HE, Q1 HE, Q2 HE, Q3 HE, Q4 HE, Q5 HE, Q6 HE, Q12 HE Published files for selected models; newer Q HE folders also include README/model pages for future CAD uploads
Q HE 8K Series Hall Effect Q1 HE 8K, Q2 HE 8K, Q3 HE 8K, Q5 HE 8K, Q6 HE 8K, Q16 HE 8K Published files for Q1 HE 8K; README/model pages prepared for the remaining Q HE 8K models
Q Max Series Keyboard Q0 Max, Q1 Max, Q2 Max, Q3 Max, Q5 Max, Q6 Max, Q8 Max, Q10 Max, Q12 Max, Q13 Max, Q14 Max, Q15 Max Published CAD files for Q6 Max; README/model pages prepared for the others
Q Ultra 8K Series Keyboard Q1 Ultra 8K, Q3 Ultra 8K, Q5 Ultra 8K, Q6 Ultra 8K, Q11 Ultra 8K, Q13 Ultra 8K Published files for Q3, Q6, and Q11 Ultra 8K; README/model pages prepared for the others
K Pro Series Keyboard K1 Pro–K17 Pro (16 models) Case, Plate, Full Model, Stabilizer
K Max Series Keyboard K0 Max, K1 Max, K2 Max, K3 Max, K4 Max, K5 Max, K7 Max, K8 Max, K9 Max, K10 Max, K11 Max, K13 Max, K15 Max, K17 Max Case, Plate, Full Model, Stabilizer, Keycap on selected models; README/model pages prepared for K4 Max and K9 Max
K Ultra 8K Series Keyboard K2 Ultra 8K, K3 Ultra 8K Plate, PCB, Bottom Case, Full Model, Metal Strip
K HE Series Hall Effect K2 HE, K4 HE, K6 HE, K8 HE, K10 HE Published models include case, plate, full model, stabilizer, and selected keycap files; K6 HE is currently folder-only
K QMK Series Keyboard K1 QMK, K2 QMK, K3 QMK, K4 QMK, K5 QMK, K8 QMK, K10 QMK Published CAD files for K2 QMK; README/model pages prepared for the others
L Series Keyboard L1, L3 Case, Plate, Knob, Full Model, Stabilizer
V 8K Series Keyboard V1 8K, V3 8K, V5 8K, V6 8K README/model pages prepared for future CAD uploads
V Ultra 8K Series Keyboard V0 Ultra 8K, V1 Ultra 8K, V3 Ultra 8K, V5 Ultra 8K, V6 Ultra 8K, V10 Ultra 8K README/model pages prepared for future CAD uploads
V Max Series Keyboard V1 Max–V10 Max Case, Plate, Encoder, Full Model, Stabilizer, OSA Keycap
P HE Series Hall Effect P1 HE, P2 HE, P3 HE Published files for P1 HE; README/model pages prepared for P2 HE and P3 HE
Mouse Series Mouse M1–M7, M2 Mini, M3 Mini, G1, G2, G3, G4, G5, G6 HE, BM22, BM24, BM25, BM27, Nape Pro (20 models) Shell, Full Model, PTFE Files, Receiver Parts

163 device models. 768+ design files. Source-available. Accessory-friendly. Keychron keyboards structure design

Directory Structure

B-Pro-Series/
  B1 Pro/               — Ultra-slim 75% wireless keyboard files with UK case, PCB, full model, and product page reference
  B2 Pro/               — Ultra-slim 96% wireless keyboard files with US case, PCB, full model, and product page reference
  B6 Pro/               — Ultra-slim full-size wireless keyboard files with case, full model, and product page reference
C-Series/
  C1/                   — Wired TKL keyboard files with plate, PCB, top case, bottom case, full model, and product page reference
C-Pro-8K-Series/
  C3 Pro 8K/            — Wired C Pro 8K hardware files, with C1 Pro 8K and C2 Pro 8K also present
J-Series/
  J5/                   — Full-size QMK wireless keyboard files with plate, PCB, bottom case, full model, and product page reference
Q-Series/
  Q0 Plus/              — Numpad files alongside Q1–Q12, Q60, and Q65
Q-HE-Series/
  Q0 HE/                — Hall Effect numpad files alongside Q1, Q2, Q3, Q4, Q5, Q6, and Q12 HE models
Q-HE-8K-Series/
  Q1 HE 8K/             — 75% wired Hall Effect 8K files with plate, PCB, top case, bottom case, full model, and product page reference
Q-Pro-Series/
  Q1 Pro/               — Wireless Q-series hardware files across 10 models
Q-Max-Series/
  Q0 Max/               — README and product page reference, with Q1, Q2, Q3, Q5, Q6, Q8, Q10, Q12, Q13, Q14, and Q15 Max model folders also present
Q-Ultra-8K-Series/
  Q3 Ultra 8K/          — Full-metal TKL wireless keyboard files with case, plate, PCB, full model, and product page reference
K-Pro-Series/
  K1 Pro/               — Low-profile and standard K Pro models through K17 Pro
  K8 Pro/               — Example model folder with `K8-Pro-Keycap.stp`
K-Max-Series/
  K0 Max/               — Numpad files alongside K1, K2, K3, K4, K5, K7, K8, K9, K10, K11, K13, K15, and K17 Max keyboard model folders
K-Ultra-8K-Series/
  K2 Ultra 8K/          — 75% wireless keyboard files with plate, PCB, bottom case, full model, metal strip, and product page reference
  K3 Ultra 8K/          — Ultra-slim 75% wireless keyboard files with plate, PCB, bottom case, full model, and product page reference
K-HE-Series/
  K2 HE/                — Example model folder with Cherry and OSA keycap STEP files
K-QMK-Series/
  K1 QMK/               — README and product page reference, with K2, K3, K4, K5, K8, and K10 QMK model folders also present
V-Max-Series/
  V1 Max/               — Tri-mode keyboard hardware files across V1–V10 Max
V-Ultra-8K-Series/
  V0 Ultra 8K/          — README and product page reference, ready for future CAD uploads alongside V1, V3, V5, V6, and V10 Ultra 8K
V-8K-Series/
  V1 8K/                — README and product page reference, ready for future CAD uploads alongside V3, V5, and V6 8K
P-HE-Series/
  P1 HE/                — Lemokey Hall Effect keyboard files, with P2 HE and P3 HE model pages also present
L-Series/
  L1/                   — Aluminum keyboard files with plate, case, knob, and stabilizers
Mice/
  BM22/                 — Lightweight wireless mouse files with product page reference
  G3/                   — Ultra-light wireless gaming mouse files with product page reference
  G5/                   — Ultra-light wireless gaming mouse files with product page reference
  BM27/                 — Vertical ergonomic wireless mouse files with product page reference
  M1/                   — Shell and full model
Keycap Profiles/
  Cherry Profile/       — Reference profile docs alongside KSA, LSA, MDA, OEM, and OSA
docs/
  file-format-guide.md  — How to open and edit these files
  getting-started.md    — First-stop guide for browsing and remixing
  3d-printing-guide.md  — Practical printing guidance for compatible parts
  CONTRIBUTING.md       — Contribution workflow and file standards
  CODE_OF_CONDUCT.md    — Community participation guidelines
  scripts/
    repo_inventory.py   — Regenerates the repository inventory from the live tree

Why This Matters

Making production hardware files available is a meaningful contribution to the broader hardware and keyboard community.

The license is designed to support the ecosystem around Keychron products while still protecting Keychron's core hardware business. In practice, original compatible accessories and add-ons are not subject to the commercial-use restriction in this license, but copying and selling Keychron keyboards or mice, or trading on Keychron trademarks, is not allowed.

Contributing

Ways to contribute:

Note: This project is source-available. Original compatible accessories and add-ons are not subject to the commercial-use restriction in this license. By contributing, you agree your work falls under the same license.

License

This project is source-available. The files may be used for personal and educational work. Original compatible accessories and add-ons are not subject to the commercial-use restriction in this license.

You may not use these files to copy, manufacture, sell, or distribute Keychron keyboards or mice, or substantially similar products, and you may not use Keychron trademarks as your own branding.

See the LICENSE file for full terms.

Built by Keychron — source-available hardware design files for the community.

Keychron-Keyboards-Hardware-Design (Keychron/Keychron-Keyboards-Hardware-Design)

Searching Database…

3.8K ·GitHub
Keychron-Keyboards-Hardware-Design
这是什么？这是一个收录 Keychron 机械键盘和鼠标量产级工业设计文件的仓库，涵盖 163 个设备型号和 768+ 个 STEP、DXF、DWG、PDF 格式的 CAD 文件。
这是软件，还是只是设计文件？它完全不是代码；这是一棵按产品系列组织的 CAD 设计文件目录树（外壳、定位板、PCB 轮廓、键帽、卫星轴），需要在 CAD 软件中打开，而不是构建或运行。
怎么找到我实际需要的文件？浏览到你关心的系列/型号文件夹（例如 Q Pro、K Max 或鼠标系列），下载该型号 README 的 Downloads 部分列出的 STEP、DXF、DWG 或 PDF 文件。
打开这些文件需要什么软件？任何能读取 STEP、DWG、DXF 或 PDF 的 CAD 程序都可以打开它们；仓库链接了一份文件格式指南，列出每种格式的兼容性说明。
我可以用这些文件制作并出售自己的 Keychron 键盘吗？不可以。这种源码可见许可证允许你构建原创兼容配件，不受商用限制约束；但你不能复制、制造或销售 Keychron 键盘或鼠标，也不能把 Keychron 的商标用作自己的品牌。
这个仓库面向什么人？面向想要研究真实量产 CAD、改编定位板和外壳，或为 Keychron 硬件设计兼容配件的爱好者、学生和工程师。
源码可见许可证具体允许什么？允许个人和教育用途，原创兼容配件/扩展件不受商用限制约束，但复制或销售 Keychron 键盘/鼠标，或把 Keychron 商标用作自己的品牌是被禁止的。
列出的 163 个型号是不是都已经发布了 CAD 文件？还没有，许多较新的系列（如 Q Max、K QMK 以及 V 8K/Ultra 8K 系列）目前只准备了 README/型号页面，实际的 CAD 文件会随后按日期记录在「Latest Updates」日志中上传。
Keychron 为什么公开这样的内部设计文件？为了降低爱好者和工程师研究真实工业设计的门槛，支持社区改编外壳/定位板和制作兼容配件，并展示对其硬件的透明度与信任。
与这些硬件文件配套的固件去哪里找？README 链接了 Keychron 单独的固件仓库，涵盖 QMK、蓝牙主板、2.4GHz 无线主板、霍尔效应主板和 ZMK，因为本仓库只涉及物理硬件设计。
这个项目有社区吗？有，Keychron 运营着一个 Discord 服务器，人们在那里分享作品、提问，并基于这些设计文件讨论改装。
What are similar projects?microduck-replica, qmk_firmware, MANPADS-System-Launcher-and-Rocket, QymCAD, mozc-devices, layerling, smartknob, tiny-engineer
Which topics is it in?mouse, 3d-modeling, 3d-printing, cad, engineering, keyboard, firmware, hardware, gaming, design, reference, customization
Creator
Keychron
Size
7.1 MB
Stars
3.8K
Updated
CommitOct 15
Age
6mo
Commits · 90 Days