rekahsoft
/
qmk-firmware
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
4,168 Commits 1 Branch 0 Tags 162 MiB
C 85.2%
Objective-C 5.2%
C++ 4.4%
Makefile 4.1%
Python 0.5%
Other 0.6%
Go to file
Erez Zukerman 45e5b32781 Merge pull request #1049 from SjB/tap_dance_save_oneshot_mods 
race condition between oneshot_mods and tap_dance
 		2017-02-01 20:12:44 -05:00
doc replace jackhumbert with qmk 2017-01-26 01:52:43 -05:00
keyboards Merge remote-tracking branch 'upstream/master' 2017-02-01 08:56:35 +01:00
lib Add Google Test submodule 2016-08-27 21:57:49 +03:00
quantum race condition between oneshot_mods and tap_dance 2017-01-29 13:26:31 -05:00
tmk_core Merge pull request #1014 from SjB/lcd_mods_status 2017-01-24 00:34:55 -05:00
util Merge pull request #761 from runcom/fix-yum-installs 2016-09-19 01:22:38 -04:00
.gitattributes Set eep files to binary mode 2016-08-27 18:37:28 +03:00
.gitignore added dvorak programmer layout 2016-10-22 22:22:34 +08:00
.gitmodules Add Google Test submodule 2016-08-27 21:57:49 +03:00
.travis.yml Upgrade AVR 8-bit Toolchain to 3.5.4 on Travis 2017-01-22 12:38:42 -05:00
Dockerfile converted to 8bit messages 2016-11-23 00:30:06 -05:00
Makefile Merge pull request #869 from dylanjgscott/master 2017-01-27 11:23:02 -05:00
Vagrantfile Update some obsolete references 2016-07-30 08:37:30 +02:00
build_keyboard.mk Got ps2avrGB to work with the V-USB protocol 2017-01-21 12:55:19 -05:00
build_test.mk Disable map file creation when building tests 2016-08-27 21:57:49 +03:00
common.mk separated into api files/folder 2016-11-26 15:38:44 -05:00
message.mk Detect failures when running multiple tests 2016-08-27 21:57:49 +03:00
readme.md Add gitter image, start update to qmk org 2017-01-26 01:26:17 -05:00
testlist.mk Basic framework for parsing test targets 2016-08-27 21:57:49 +03:00

readme.md

Quantum Mechanical Keyboard Firmware

Build Status Gitter

This is a keyboard firmware based on the tmk_keyboard firmware with some useful features for Atmel AVR controllers, and more specifically, the OLKB product line, the ErgoDox EZ keyboard, and the Clueboard product line.

Official website (currently under construction with the move to the wiki)

For an easy-to-read version of this document and the repository, check out http://qmk.fm. Nicely formatted keyboard and keymap listings are also available there, along with the ability to download .hex files instead of having to setup a build environment and compile them.

Included Keyboards

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. This repo used to be a fork of TMK, and we are incredibly grateful for his founding contributions to the firmware. We've had to break the fork due to purely technical reasons - it simply became too different over time, and we've had to start refactoring some of the basic bits and pieces. We are huge fans of TMK and Hasu :)

This documentation is edited and maintained by Erez Zukerman of ErgoDox EZ. If you spot any typos or inaccuracies, please open an issue.

The OLKB product firmwares are maintained by Jack Humbert, the Ergodox EZ by Erez Zukerman, and the Clueboard by Zach White.

Documentation roadmap

This is not a tiny project. While this is the main readme, there are many other files you might want to consult. Here are some points of interest:

  • The Wiki - the entirety of the readme has been moved here
  • The readme for your own keyboard: This is found under keyboards/<your keyboards's name>/. So for the ErgoDox EZ, it's here; for the Planck, it's here and so on.
  • The list of possible keycodes you can use in your keymap is actually spread out in a few different places:
    • doc/keycode.txt - an explanation of those same keycodes.
    • quantum/keymap.h - this is where the QMK-specific aliases are all set up. Things like the Hyper and Meh key, the Leader key, and all of the other QMK innovations. These are also explained and documented below, but keymap.h is where they're actually defined.
  • The TMK documentation. QMK is based on TMK, and this explains how it works internally.