zmkfirmware/zmk

ZMK Firmware Repository

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 53 seconds ago
Type:FrameworkCategory(s):Embedded & IoTSystems, Hardware & HPC
Added to GitGenius on September 16th, 2026
Created on June 8th, 2020
Open Issues & Pull Requests: 430 (+0)
GitHub issues: Enabled
Number of forks: 4,152
Total Stargazers: 4,271 (+1)
Total Subscribers: 44 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 9.0 hours
Mean response time: 120.7 days
90th percentile: 335.2 days
Tracked items: 462

Most active contributors

Sign in to see contributor activity.

How this project is maintained

About 11% of issues opened in the past year have never received a reply. 93% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "core" is answered fastest, typically in about 9 hours, while "keymaps" waits about 3 weeks. 72% of tracked open issues have had no activity in three months, so the open count overstates what is actively being worked. Only 50% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 321
New in 7 days: 1
Closed in 7 days: 1
Avg open age: 1,067 days
Stale 30+ days: 294
Stale 90+ days: 265

Recent activity

Opened in 7 days: 1
Closed in 7 days: 1
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • enhancement (59)
  • core (33)
  • documentation (29)
  • behaviors (21)
  • bug (21)
  • help wanted (17)
  • good first issue (13)
  • board (11)

Most active issues this week

Detailed Description

ZMK Firmware is a keyboard firmware project built on the Zephyr RTOS that enables wireless mechanical keyboards through Bluetooth connectivity.

ZMK addresses the challenge of creating reliable, feature-rich firmware for custom mechanical keyboards with a focus on wireless operation. The project leverages the Zephyr real-time operating system as its foundation, which provides hardware abstraction and cross-platform support across different microcontroller architectures. This approach allows keyboard designers to define their hardware layout and keymap configuration separately from the core firmware, enabling customization without modifying low-level code.

Developers building custom mechanical keyboards should consider ZMK if they need Bluetooth wireless capability and want to avoid the complexity of managing hardware drivers directly. The project suits hobbyists and professionals designing split keyboards, ergonomic layouts, and other custom form factors. ZMK's reliance on Zephyr means it supports a broader range of microcontrollers than some alternatives, though this also means the learning curve involves understanding both ZMK-specific configuration and Zephyr fundamentals. The project provides documentation and configuration examples to help users define their keyboard hardware and keymaps.

The project shows consistent activity with regular commits addressing bug fixes, feature additions, and documentation improvements. Development includes active engagement with user-reported issues and pull requests that expand hardware support and add new functionality. The codebase demonstrates ongoing refinement of the core firmware architecture alongside expansion of compatible microcontroller boards. Contributors regularly update documentation to reflect new capabilities and provide clearer guidance for users setting up their keyboards. The project maintains a structured approach to managing feature requests and hardware compatibility, with deliberate decisions about which additions integrate into the main codebase.