Skip to content

KMKfw/kmk_firmware

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

eaeddd3 · Jul 26, 2024
Oct 22, 2023
Jun 12, 2024
Jun 12, 2024
Jul 26, 2024
Apr 25, 2022
Jul 26, 2024
Jul 26, 2024
May 26, 2024
Jun 1, 2024
Oct 12, 2018
Sep 16, 2022
Jul 25, 2019
Jun 20, 2021
Dec 29, 2018
Jun 20, 2024
May 26, 2024
May 26, 2024
Oct 5, 2023
Feb 11, 2023
Jun 20, 2021
Jun 20, 2021
May 26, 2024
May 26, 2024

Repository files navigation

KMK: Clackety Keyboards Powered by Python

GitHub GitHub contributors Lines of code GitHub issues GitHub closed issues

KMK is a feature-rich and beginner-friendly firmware for computer keyboards written and configured in CircuitPython.

Support

For asynchronous support and chatter about KMK, join our Zulip community!

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

Getting Started

KMK requires CircuitPython version 7.0 or higher. Our getting started guide can be found here.

Contributing

Please have a look at the contributing document, 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 on Zulip.

License, Copyright, and Legal

All software in this repository is licensed under the GNU Public License, version 3. All documentation and hardware designs are licensed under the Creative Commons Attribution-ShareAlike 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.