HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
qmk
qmk_firmware
C2017–2026
qmk / qmk_firmware

qmk_firmware

Open-source keyboard firmware for Atmel AVR and Arm USB families

44Distinct people
56Mentions
3Explicit recommenders
20.8KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

Open-source keyboard firmware for Atmel AVR and Arm USB families

GitHub

Where it is used

The source check is incomplete. Verified examples will appear here.

What people are saying

That thing looks totally awesome! I especially like the steps taken to integrate mouse control into the design. A centered, integrated pointing device makes all computer…

1MachineElf used a recommendation phrase. 3 indexed comments match. This is a phrase match, not a verdict.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

No other repository is repeatedly linked in the same discussions.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 12:01:57 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year56 dated mentions

Observed mentions: 2017-05-03 08:19:26 UTC to 2026-08-22 21:27:55 UTC.

02468102017-01-01 00:00:00 UTC to 2018-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments20172018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 7 mentions; 0 submissions, 7 comments2019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 8 mentions; 0 submissions, 8 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 6 mentions; 0 submissions, 6 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 8 mentions; 0 submissions, 8 comments20212022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 4 mentions; 0 submissions, 4 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 8 mentions; 0 submissions, 8 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 10 mentions; 1 submissions, 9 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20172017-01-01 00:00:00 UTC2018-01-01 00:00:00 UTC202
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC707
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC808
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC606
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC808
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC404
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC808
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC1019
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC000
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC303

From the project README

An excerpt from the repository, fetched Nov 12, 2026.

Read the project’s introduction
Quantum Mechanical Keyboard Firmware This is a keyboard firmware based on the tmk_keyboard firmware with some useful features for Atmel AVR and ARM controllers, and more specifically, the OLKB product line, the ErgoDox EZ keyboard, and the Clueboard product line. Documentation See the official documentation on docs.qmk.fm The docs are powered by VitePress. They are also viewable offline; see Previewing the Documentation for more details. You can request changes by making a fork and opening a pull request. Supported Keyboards Planck Preonic ErgoDox EZ Clueboard Cluepad Atreus The project also includes community support for lots of other keyboards. Maintainers QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, Hasu. The OLKB product firmwares are maintained by Jack Humbert, the Ergodox EZ by ZSA Technology Labs, the Clueboard by Zach White, and the Atreus by Phil Hagelberg. Official Website qmk.fm is the official website of QMK, where you can find links to this page, the documentation, and the keyboards supported by QMK.
Read the full README on GitHub

What Hacker News says

8 sources
1MachineElf·Aug 31, 2021Recommendation phrase
That thing looks totally awesome! I especially like the steps taken to integrate mouse control into the design. A centered, integrated pointing device makes all computer interaction much easier. Without ranting too much, I have to say that for non-QWERTY layouts, this can be quite important. Suffice it to say, that's a wonderful feature of this Chordie design. If I were to make one of these, one addition I would add is a board with ~1.5mm deep pockets in the shape of each piece so that everything could be held in place while used on a lap, or even over the existing keyboard of a laptop. ASETNIOP[0] seems quite interesting, but I'm somewhat confused by how people are using it together with QMK[1]. I love that QMK is open source, but ASETNIOP doesn't appear to be. At least, there's not GitHub repo. On it's website, I only see apps for iOS a
Read the rest
nd Android listed. So, how are people using it on computers? Does the commercial nature of the project mean I won't be able to use this on niche flavors of Unix? I've been excited to try it out with a gHeavy board, but unfortunately, I've had a lot of bad luck with them. A $250 steel GergoPlex arrived bent and with a broken USB connector because the inadequate padded envelope it arrived in didn't protect it from some delivery person who dropped it. The Georgi I ordered just never arrived. Same story with the Ginny. No protection, no insurance, and no tracking. The gHeavy brand's innovation is much more thrilling than their logistics. [0] http://asetniop.com/ [1] https://github.com/qmk/qmk_firmware/tree/master/keyboards/gb...
In Kbjunky/Chordie: A chording keyboard you shouldn't be scared of
A handwired QMK keyboard would work fine: https://docs.qmk.fm/#/hand_wire If you have only one or two switches, you can use the DIRECT_PINS configuration to directly put one switch per input pin rather than the more conventional switch matrix approach. You can use the XD002 code as a starting point (https://github.com/qmk/qmk_firmware/tree/master/keyboards/xd..., https://github.com/qmk/qmk_firmware/blob/master/keyboards/xd...). It uses a DigiSpark rather than the more common Arduino Pro Micro. The DigiSpark is a bit fiddly and has very little program memory, but it is very cheap and simple.
In Vim Clutch – A hardware pedal for improved text editing (2012)
Made use of the second OLED on the Sofle Keyboard and ported the Bongo cat WMP animation from the Kyria keyboard. QMK firmware for this can be found on my github: https://github.com/foureight84/qmk_firmware/tree/sofle_foure... Also, if you want to integrate the Pimoroni Track ball to the Sofle Keyboard, I've written a guide: https://github.com/foureight84/sofle-keyboard-pimoroni The original code was done by j-inc: https://github.com/qmk/qmk_firmware/tree/master/keyboards/ky...
In Adapted Bongo cat animation to the Sofle Keyboard
You can have two keyboards. A first ergonomic split keyboard for the alpha keys. A second keyboard _only_ for function keys (placed between the split keyboard), an ortholinear planck keyboard with QMK firmware would be ideal. With QMK you can program a single key to send a complex combination like Alt+Shift+F10 (the Run... action in IntelliJ), you get the idea. Moreover you can make [1] the same key to do the same action in different OSes and programs. No need to remember different shortcuts how to switch tabs in a browser and in a text editor. [1] https://github.com/qmk/qmk_firmware/blob/master/users/miles2...
In System76 Launch Configurable Keyboard with Open Source Code
autocorr·Jan 27, 2021Recommendation phrase
The prices can be steep for pre-built split-keyboards, between $200-300 USD, but if anyone has access to a university laser cutter or makerspace they can actually quite cheap to build. I made an entirely custom, split hand-wired setup for about $150 (build[1], layout[2]). Most of the cost was ordering one-off laser-cut steel and acrylic plates off the web. If you don't mind waiting a month for parts from Aliexpress and have access to a laser cutter and a soldering iron, you could make a complete split, hand-wired keyboard for about $50. The most difficult thing for most folks is often building the QMK software[3,4] configured for their setup. But hacking a bit of C and flashing an Arduino is probably not that bad for most HN readers! It's awesome to have an entirely custom keyboard. The split design has been great for my posture and shoul
Read the rest
ders. But the real killer is the kind of customization you get from QMK. We customize everything else about our computers, why not our primary interface to it? I love having the navigation keys and numpad right underneath my fingers using layers, having the modifiers in sane locations, and thumb keys to make your thumbs first-class-typing-citizens (e.g., Space, Shift, Backspace, Enter all within easy reach!). [1] https://www.reddit.com/r/ErgoMechKeyboards/comments/j0hhah/o... [2] https://www.reddit.com/r/KeyboardLayouts/comments/j475mv/40_... [3] https://qmk.fm/ [4] https://github.com/qmk/qmk_firmware
In Split keyboards and how to build them
I just like being able to work in a Windows IDE and compile in a (99%) Linux environment without messing with a VM or mounting shares. Like QMK[1] -- develop in Visual Studio, compile in WSL, flash in QMK Toolbox (Windows). Or in some very specific corner cases, have a Linux-based workflow that suddenly calls into a Win32 utility. In some cases I need to test something that's Linux-only -- an idea or a GitHub project that just doesn't run on Windows -- and it's easier to jump into a WSL console than boot a VM. But on the other hand, I don't do that frequently enough to just keep a VM running all the time. (Plus there's VM idle RAM usage, and I can't use Hyper-V [which can reduce VM RAM] due to host performance concerns) [1] https://github.com/qmk/qmk_firmware
In WSL2 corrupting Git repositories and shell history

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.