mirror of
https://github.com/qmk/qmk_firmware
synced 2024-11-09 13:29:26 +00:00
43 lines
2.8 KiB
Markdown
43 lines
2.8 KiB
Markdown
# Quantum Mechanical Keyboard Firmware
|
|
|
|
[](https://github.com/qmk/qmk_firmware/tags)
|
|
[](https://travis-ci.org/qmk/qmk_firmware)
|
|
[](https://discord.gg/Uq7gcHh)
|
|
[](https://docs.qmk.fm)
|
|
[](https://github.com/qmk/qmk_firmware/pulse/monthly)
|
|
[](https://github.com/qmk/qmk_firmware/)
|
|
|
|
# NOTICE: THIS IS A TESTING BRANCH
|
|
|
|
This is the `breaking_changes` branch for Aug 2019. You can [read more in the tracking issue](https://github.com/qmk/qmk_firmware/issues/6146).
|
|
|
|
We encourage you to try this branch out and see if there are any bugs. Our goal is to merge this branch to `master` on Aug 30. Please [report any bugs](https://github.com/qmk/qmk_firmware/issues/new?template=bug_report.md) you find.
|
|
|
|
Original readme.md continues:
|
|
|
|
This is a keyboard firmware based on the [tmk\_keyboard firmware](https://github.com/tmk/tmk_keyboard) with some useful features for Atmel AVR and ARM controllers, and more specifically, the [OLKB product line](https://olkb.com), the [ErgoDox EZ](https://ergodox-ez.com) keyboard, and the [Clueboard product line](https://clueboard.co).
|
|
|
|
## Documentation
|
|
|
|
* [See the official documentation on docs.qmk.fm](https://docs.qmk.fm)
|
|
|
|
The docs are hosted on [Gitbook](https://www.gitbook.com/book/qmk/firmware/details) and [GitHub](/docs/) (they are synced). You can request changes by making a fork and [pull request](https://github.com/qmk/qmk_firmware/pulls), or by clicking the "suggest an edit" link on any page of the docs.
|
|
|
|
## Supported Keyboards
|
|
|
|
* [Planck](/keyboards/planck/)
|
|
* [Preonic](/keyboards/preonic/)
|
|
* [ErgoDox EZ](/keyboards/ergodox_ez/)
|
|
* [Clueboard](/keyboards/clueboard/)
|
|
* [Cluepad](/keyboards/clueboard/17/)
|
|
* [Atreus](/keyboards/atreus/)
|
|
|
|
The project also includes community support for [lots of other keyboards](/keyboards/).
|
|
|
|
## Maintainers
|
|
|
|
QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, [Hasu](https://github.com/tmk). The OLKB product firmwares are maintained by [Jack Humbert](https://github.com/jackhumbert), the Ergodox EZ by [ZSA Technology Labs](https://github.com/zsa), the Clueboard by [Zach White](https://github.com/skullydazed), and the Atreus by [Phil Hagelberg](https://github.com/technomancy).
|
|
|
|
## Official Website
|
|
|
|
[qmk.fm](https://qmk.fm) is the official website of QMK, where you can find links to this page, the documentation, and the keyboards supported by QMK.
|