https://github.com/kmkfw/kmk_firmware
Clackety Keyboards Powered by Python
https://github.com/kmkfw/kmk_firmware
arm-microcontrollers atmel circuitpython firmware hacktoberfest keyboard keyboard-firmware keyboards mechanical-keyboards micropython nrf52840 python rp2040 samd51 stm32
Last synced: 30 days ago
JSON representation
Clackety Keyboards Powered by Python
- Host: GitHub
- URL: https://github.com/kmkfw/kmk_firmware
- Owner: KMKfw
- License: other
- Created: 2018-08-30T09:37:54.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2026-04-09T12:08:07.000Z (7 months ago)
- Last Synced: 2026-10-14T22:32:48.763Z (about 1 month ago)
- Topics: arm-microcontrollers, atmel, circuitpython, firmware, hacktoberfest, keyboard, keyboard-firmware, keyboards, mechanical-keyboards, micropython, nrf52840, python, rp2040, samd51, stm32
- Language: Python
- Homepage: https://kmkfw.zulipchat.com
- Size: 3.35 MB
- Stars: 1,759
- Watchers: 20
- Forks: 514
- Open Issues: 61
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# KMK: Clackety Keyboards Powered by Python





KMK is a feature-rich and beginner-friendly firmware for computer keyboards
written and configured in
[CircuitPython](https://github.com/adafruit/circuitpython).
## Status
KMK is no longer actively maintained and on limited life support.
Issues and pull requests will not be addressed for the time being.
Volunteers for taking on the project can voice their interest in the
[Zulip Chat](https://kmkfw.zulipchat.com).
## Support
For asynchronous support and chatter about KMK, [join our Zulip
community](https://kmkfw.zulipchat.com)!
If you ask for help in chat or open a bug report, if possible
make sure your copy of KMK is up-to-date.
In particular, swing by the Zulip chat *before* opening a GitHub Issue about
configuration, documentation, etc. concerns.
> The former Matrix and Discord rooms once linked to in this README are no
> longer officially supported, please do not use them!
## Features
- Fully configured through a single, easy to understand Python file that lives
on a "flash-drive"-esque space on your microcontroller - edit on the go
without DFU or other dev tooling available!
- Single-piece or [two-piece split
keyboards](/docs/en/split_keyboards.md)
are supported
- [Chainable
keys](/docs/en/keys.md) such as
`KC.LWIN(KC.L)` to lock the screen on a Windows PC
- [Built-in Unicode macros, including
emojis](/docs/en/macros.md)
- [RGB underglow](/docs/en/rgb.md)
and [LED
backlights](/docs/en/led.md)
- One key can turn into many more based on [how many times you tap
it](/docs/en/tapdance.md)
- Bluetooth HID and split keyboards. No more wires.
## Getting Started
KMK requires [CircuitPython](https://circuitpython.org/) version 8.0 or higher.
Our getting started guide can be found
[here](/docs/en/Getting_Started.md).
## Contributing
Please have a look at the [contributing document](/docs/en/contributing.md),
where you can find details about the workflow and code style. If you have
specific questions feel free to ask in the [KMK development stream](https://kmkfw.zulipchat.com/#narrow/stream/384078-KMK-development)
on Zulip.
## License, Copyright, and Legal
All software in this repository is licensed under the [GNU Public License,
version 3](https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)).
All documentation and hardware designs are licensed under the [Creative Commons
Attribution-ShareAlike 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
license.
**Due to ethical and legal concerns, any works derived from GitHub Copilot or
similar artificial intelligence tooling are unacceptable for inclusion in any
first-party KMK repository or other code collection. We further recommend not
using GitHub Copilot while developing anything KMK-related, regardless of
intent to submit upstream.**