umi d0c3a4c8d5 [Docs] Japanese translation of docs/feature_encoders.md (#8843) %!s(int64=6) %!d(string=hai) anos
..
ChangeLog 26eef35f07 2020 February 29 Breaking Changes Update (#8064) %!s(int64=6) %!d(string=hai) anos
de 400ca2d035 spi_master for AVR (#8299) %!s(int64=6) %!d(string=hai) anos
es 400ca2d035 spi_master for AVR (#8299) %!s(int64=6) %!d(string=hai) anos
fr-fr bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
gitbook 4580d3a730 RGB improvements (#1684) %!s(int64=9) %!d(string=hai) anos
he-il 400ca2d035 spi_master for AVR (#8299) %!s(int64=6) %!d(string=hai) anos
ja d0c3a4c8d5 [Docs] Japanese translation of docs/feature_encoders.md (#8843) %!s(int64=6) %!d(string=hai) anos
pt-br 400ca2d035 spi_master for AVR (#8299) %!s(int64=6) %!d(string=hai) anos
ru-ru 400ca2d035 spi_master for AVR (#8299) %!s(int64=6) %!d(string=hai) anos
zh-cn bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
.nojekyll 9e5676650e Use docsfy to replace gitbook %!s(int64=8) %!d(string=hai) anos
CNAME 4d26137e2a Create CNAME %!s(int64=8) %!d(string=hai) anos
README.md 961477c791 make sure all our redirects are in order %!s(int64=6) %!d(string=hai) anos
_langs.md 10e8ed7430 [Docs] add README translation in portuguese (#7016) %!s(int64=6) %!d(string=hai) anos
_summary.md 8c97b4a3a4 Add a syllabus to guide people who are learning QMK (#8816) %!s(int64=6) %!d(string=hai) anos
adc_driver.md 567bfc97ac ARM - ADC cleanup (#8385) %!s(int64=6) %!d(string=hai) anos
api_development_environment.md 99850aabca Add API documentation %!s(int64=6) %!d(string=hai) anos
api_development_overview.md 99850aabca Add API documentation %!s(int64=6) %!d(string=hai) anos
api_docs.md 99850aabca Add API documentation %!s(int64=6) %!d(string=hai) anos
api_overview.md 99850aabca Add API documentation %!s(int64=6) %!d(string=hai) anos
arm_debugging.md 52c18ef026 [Docs] fix docs (#7642) %!s(int64=6) %!d(string=hai) anos
breaking_changes.md f513a9193c Fix the Breaking Changes doc again %!s(int64=6) %!d(string=hai) anos
breaking_changes_instructions.md 72d7661b30 suggestions by skullydazed %!s(int64=6) %!d(string=hai) anos
cli.md 66d94dc22a Move everything to Python 3.6 (#8835) %!s(int64=6) %!d(string=hai) anos
cli_commands.md 21799be1ca Make dedicated sections for user/dev commands in docs %!s(int64=6) %!d(string=hai) anos
cli_configuration.md dc68418660 Fix some broken links in the docs (#8394) %!s(int64=6) %!d(string=hai) anos
cli_development.md 66d94dc22a Move everything to Python 3.6 (#8835) %!s(int64=6) %!d(string=hai) anos
coding_conventions_c.md f4b67cde8a Update C coding conventions to match .clang-format config for i… (#8717) %!s(int64=6) %!d(string=hai) anos
coding_conventions_python.md 66d94dc22a Move everything to Python 3.6 (#8835) %!s(int64=6) %!d(string=hai) anos
compatible_microcontrollers.md 5414ff709f [Doc] Tidy up compatible MCUs docs (#7295) %!s(int64=6) %!d(string=hai) anos
config_options.md be2f5816b6 Fix compile issues related to NO_ACTION_MACRO/FUNCTION and LTO_ENABLE (#8663) %!s(int64=6) %!d(string=hai) anos
configurator_step_by_step.md d5f34c4810 Polish Configurator section %!s(int64=6) %!d(string=hai) anos
configurator_troubleshooting.md d5f34c4810 Polish Configurator section %!s(int64=6) %!d(string=hai) anos
contributing.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
custom_matrix.md 6e710426a4 Add docs for 'CUSTOM_MATRIX = lite' (#7906) %!s(int64=6) %!d(string=hai) anos
custom_quantum_functions.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
documentation_best_practices.md 303f425c6b Fix up info boxes. %!s(int64=8) %!d(string=hai) anos
documentation_templates.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
driver_installation_zadig.md 80ded60cad Add a short explanation to Zadig the troubleshooting section (#7110) %!s(int64=7) %!d(string=hai) anos
eeprom_driver.md f2f2afe13b Add support for STM32L0/L1 onboard EEPROM. (#8002) %!s(int64=6) %!d(string=hai) anos
faq_build.md a52e55ec09 [Docs] Update macOS related issues in docs (#7744) %!s(int64=6) %!d(string=hai) anos
faq_debug.md bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
faq_general.md a701c15d87 Rework the newbs guide around the qmk cli %!s(int64=6) %!d(string=hai) anos
faq_keymap.md 12e43230c6 make custom_keycode_names.md a faq entry instead %!s(int64=6) %!d(string=hai) anos
feature_advanced_keycodes.md 370577e4ed Add *OPT aliases for *ALT keycodes and macros (#8714) %!s(int64=6) %!d(string=hai) anos
feature_audio.md d534c72a54 Added keycodes for swapping and unswapping the Control and OS keys (#6110) %!s(int64=7) %!d(string=hai) anos
feature_auto_shift.md e9c44e396d Smallish overhaul of Auto-Shift feature (#6067) %!s(int64=6) %!d(string=hai) anos
feature_backlight.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
feature_bluetooth.md 908aede957 Update feature_bluetooth.md (#7193) %!s(int64=6) %!d(string=hai) anos
feature_bootmagic.md 789e199450 Add support for Bootmagic lite when using SPLIT_HAND_PIN (#8347) %!s(int64=6) %!d(string=hai) anos
feature_combo.md 57540af102 Change "yu" to "you" in combo docs (#6510) %!s(int64=7) %!d(string=hai) anos
feature_command.md a2e91ebec9 Update IS_COMMAND definitions to use MOD_MASK_SHIFT (#6348) %!s(int64=7) %!d(string=hai) anos
feature_debounce_type.md b8c3f4c60b quantum/debounce: Added sym_pk debounce algorithm (#8587) %!s(int64=6) %!d(string=hai) anos
feature_dip_switch.md dab4967f1b Add Dip Switch as a core feature (#6140) %!s(int64=7) %!d(string=hai) anos
feature_dynamic_macros.md 542cb0a8ce [Core] Convert Dynamic Macro to a Core Feature (#5948) %!s(int64=6) %!d(string=hai) anos
feature_encoders.md 26eef35f07 2020 February 29 Breaking Changes Update (#8064) %!s(int64=6) %!d(string=hai) anos
feature_grave_esc.md 3510d8dc8d Document an annoyance with Grave Escape and macOS Terminal (#5483) %!s(int64=7) %!d(string=hai) anos
feature_haptic_feedback.md f275ffbdfc Minor grammar and filename fixes in docs (#7559) %!s(int64=6) %!d(string=hai) anos
feature_hd44780.md b23f6011c3 Remove build option firmware size impacts (#6947) %!s(int64=7) %!d(string=hai) anos
feature_key_lock.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
feature_layers.md 5df2424651 [Docs] Update layer documentation (#8371) %!s(int64=6) %!d(string=hai) anos
feature_layouts.md 40e67a3074 Add a mechanism for force building a particular community layout (#5027) %!s(int64=7) %!d(string=hai) anos
feature_leader_key.md 5df2424651 [Docs] Update layer documentation (#8371) %!s(int64=6) %!d(string=hai) anos
feature_led_matrix.md 24df54b807 Add documentation for led matrix %!s(int64=7) %!d(string=hai) anos
feature_macros.md 370577e4ed Add *OPT aliases for *ALT keycodes and macros (#8714) %!s(int64=6) %!d(string=hai) anos
feature_mouse_keys.md 3cd2a27ac0 Decouple mouse cursor and mouse wheel in accelerated mode (#6685) %!s(int64=6) %!d(string=hai) anos
feature_oled_driver.md b5be96f8bb Adding OLED scroll setup functions (#8386) %!s(int64=6) %!d(string=hai) anos
feature_pointing_device.md b272c035ba [Docs] Random Fixes (#8340) %!s(int64=6) %!d(string=hai) anos
feature_ps2_mouse.md 07c75feba3 Add PS2_MOUSE_ROTATE to compensate for device orientation (#8650) %!s(int64=6) %!d(string=hai) anos
feature_rgb_matrix.md 5075a1d9e4 [Docs] Update RGB Matrix docs with function refs (#8367) %!s(int64=6) %!d(string=hai) anos
feature_rgblight.md a521fc2b6c [Docs] Fixes for feature_rgblight.md (#8514) %!s(int64=6) %!d(string=hai) anos
feature_space_cadet.md d16db69367 Added mod carry over from press to release. (#5866) %!s(int64=7) %!d(string=hai) anos
feature_split_keyboard.md 307be48de9 Reduce SPLIT_USB_TIMEOUT by 500ms (#7637) %!s(int64=6) %!d(string=hai) anos
feature_stenography.md b272c035ba [Docs] Random Fixes (#8340) %!s(int64=6) %!d(string=hai) anos
feature_swap_hands.md fd085837e1 fix swap_hands keycodes in documentation (#3588) %!s(int64=8) %!d(string=hai) anos
feature_tap_dance.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
feature_terminal.md b23f6011c3 Remove build option firmware size impacts (#6947) %!s(int64=7) %!d(string=hai) anos
feature_thermal_printer.md 4c675a83ba Format keycode tables %!s(int64=8) %!d(string=hai) anos
feature_unicode.md bdfdc506da Rename UC_OSX (and related constants) to UC_MAC (#8589) %!s(int64=6) %!d(string=hai) anos
feature_userspace.md 19dbcf3814 Document 'make all:<name>' (#8439) %!s(int64=6) %!d(string=hai) anos
feature_velocikey.md c1c5922aae Velocikey: Match RGB animation speed to typing speed (#3754) %!s(int64=7) %!d(string=hai) anos
feature_wpm.md bfb2f8e0a8 Add Word Per Minute calculation feature (#8054) %!s(int64=6) %!d(string=hai) anos
flashing.md bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
flashing_bootloadhid.md 235da6973d Install bootloadHid as part of qmk_install (#7463) %!s(int64=6) %!d(string=hai) anos
fuse.txt ca01d94005 convert docs to lowercase and underscores %!s(int64=9) %!d(string=hai) anos
getting_started_github.md 9046107183 Restore getting_started_github.md doc %!s(int64=6) %!d(string=hai) anos
getting_started_introduction.md 09c7304bd9 [Docs] update git command and directory name of documents (#7619) %!s(int64=6) %!d(string=hai) anos
getting_started_make_guide.md 6e710426a4 Add docs for 'CUSTOM_MATRIX = lite' (#7906) %!s(int64=6) %!d(string=hai) anos
getting_started_vagrant.md bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
hand_wire.md 961477c791 make sure all our redirects are in order %!s(int64=6) %!d(string=hai) anos
hardware_avr.md f87908228a Remove apostrophe from various abbreviations' plural forms (#7050) %!s(int64=7) %!d(string=hai) anos
hardware_drivers.md d13ada1162 Add customisable EEPROM driver selection (#7274) %!s(int64=6) %!d(string=hai) anos
hardware_keyboard_guidelines.md dc98d44582 [Docs] added the description of the reading order of the rules.mk files. (#8566) %!s(int64=6) %!d(string=hai) anos
how_a_matrix_works.md a95a314f78 refactor How a Matrix Works doc %!s(int64=6) %!d(string=hai) anos
how_keyboards_work.md d5316e9714 Update URL for `60-keyboard.hwdb` (#7185) %!s(int64=6) %!d(string=hai) anos
i2c_driver.md b272c035ba [Docs] Random Fixes (#8340) %!s(int64=6) %!d(string=hai) anos
index.html dc68418660 Fix some broken links in the docs (#8394) %!s(int64=6) %!d(string=hai) anos
internals_defines.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_gpio_control.md b272c035ba [Docs] Random Fixes (#8340) %!s(int64=6) %!d(string=hai) anos
internals_input_callback_reg.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_midi_device.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_midi_device_setup_process.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_midi_util.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_send_functions.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
internals_sysex_tools.md ae7284edb8 rename api docs to internals %!s(int64=8) %!d(string=hai) anos
isp_flashing_guide.md abd36de5ad [Docs] Update ISP Flashing guide (#8149) %!s(int64=6) %!d(string=hai) anos
keycodes.md 370577e4ed Add *OPT aliases for *ALT keycodes and macros (#8714) %!s(int64=6) %!d(string=hai) anos
keycodes_basic.md 370577e4ed Add *OPT aliases for *ALT keycodes and macros (#8714) %!s(int64=6) %!d(string=hai) anos
keycodes_us_ansi_shifted.md 40de65eac4 Backslash-escape pipe character in keycode lists (#7157) %!s(int64=6) %!d(string=hai) anos
keymap.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
mod_tap.md 370577e4ed Add *OPT aliases for *ALT keycodes and macros (#8714) %!s(int64=6) %!d(string=hai) anos
newbs.md 45e218ceec overhaul the newbs guide %!s(int64=6) %!d(string=hai) anos
newbs_building_firmware.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
newbs_building_firmware_configurator.md d5f34c4810 Polish Configurator section %!s(int64=6) %!d(string=hai) anos
newbs_flashing.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
newbs_getting_started.md 3cea9fedff Add missing repository name to qmk setup w/ github (#8792) %!s(int64=6) %!d(string=hai) anos
newbs_git_best_practices.md 3152bf572b [Docs] Restructure of Git Best Practices doc (#7231) %!s(int64=6) %!d(string=hai) anos
newbs_git_resolving_merge_conflicts.md 3152bf572b [Docs] Restructure of Git Best Practices doc (#7231) %!s(int64=6) %!d(string=hai) anos
newbs_git_resynchronize_a_branch.md 26a823082b [Docs] Fix minor differences in docs/newbs_git_resynchronize_a_branch.md (#7728) %!s(int64=6) %!d(string=hai) anos
newbs_git_using_your_master_branch.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
newbs_learn_more_resources.md 45e218ceec overhaul the newbs guide %!s(int64=6) %!d(string=hai) anos
newbs_testing_debugging.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
one_shot_keys.md 9035c3497e break feature_advanced_keycodes.md up into multiple files %!s(int64=6) %!d(string=hai) anos
other_eclipse.md cde5237a88 fix two links on docs/other_eclipse.md (#8417) %!s(int64=6) %!d(string=hai) anos
other_vscode.md e9ace14878 [Docs] Add VSCode guide to docs (#5124) %!s(int64=7) %!d(string=hai) anos
platformdev_chibios_earlyinit.md 05e9ff6554 Add support for hardware and board initialisation overrides. (#8330) %!s(int64=6) %!d(string=hai) anos
power.txt bb53635f33 Trim trailing whitespace %!s(int64=8) %!d(string=hai) anos
proton_c_conversion.md 7918f7d61d Document the Proton C pins for manual Pro Micro conversion (#7043) %!s(int64=6) %!d(string=hai) anos
qmk.css ccc87421e7 Some more tweaks to make everything look nice %!s(int64=8) %!d(string=hai) anos
qmk_custom_dark.css 1b267d4840 Fix darkmode (#8393) %!s(int64=6) %!d(string=hai) anos
qmk_custom_light.css 1b267d4840 Fix darkmode (#8393) %!s(int64=6) %!d(string=hai) anos
quantum_keycodes.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
redirects.json d569f08771 Configuration system for CLI (#6708) %!s(int64=7) %!d(string=hai) anos
ref_functions.md 750179e111 Fix a couple of typos that were causing confusion (#8767) %!s(int64=6) %!d(string=hai) anos
reference_configurator_support.md d5f34c4810 Polish Configurator section %!s(int64=6) %!d(string=hai) anos
reference_glossary.md bc13dcd349 Remove Atmel FLIP from install scripts and documentation (#8822) %!s(int64=6) %!d(string=hai) anos
reference_info_json.md bcb1815420 Add label to the info.json reference %!s(int64=7) %!d(string=hai) anos
spi_driver.md 46e4493761 Fix AVR SPI parameter configuration, remove timeouts due to sync protocol. (#8775) %!s(int64=6) %!d(string=hai) anos
support.md 961477c791 make sure all our redirects are in order %!s(int64=6) %!d(string=hai) anos
sw.js 303f425c6b Fix up info boxes. %!s(int64=8) %!d(string=hai) anos
syllabus.md 9b70e53508 [Docs] Fixed minor typos (#8860) %!s(int64=6) %!d(string=hai) anos
tap_hold.md 9b70e53508 [Docs] Fixed minor typos (#8860) %!s(int64=6) %!d(string=hai) anos
translating.md 7164e8eeb5 Add yet another dictionary for the QMK Firmware docs sidebar heading (#7504) %!s(int64=6) %!d(string=hai) anos
understanding_qmk.md 5117dff6a2 Add Post Processing to process_record (#4892) %!s(int64=6) %!d(string=hai) anos
unit_testing.md 54c58ea6de Add explicit id tags to externally linked headers %!s(int64=6) %!d(string=hai) anos
usb_nkro.txt 995c3141a6 convert docs to lowercase and underscores %!s(int64=9) %!d(string=hai) anos
ws2812_driver.md f74c769a19 PWM DMA based RGB Underglow for STM32 (#7928) %!s(int64=6) %!d(string=hai) anos

README.md

Quantum Mechanical Keyboard Firmware

Current Version Build Status Discord Docs Status GitHub contributors GitHub forks

What is QMK Firmware?

QMK (Quantum Mechanical Keyboard) is an open source community centered around developing computer input devices. The community encompasses all sorts of input devices, such as keyboards, mice, and MIDI devices. A core group of collaborators maintains QMK Firmware, QMK Configurator, QMK Toolbox, qmk.fm, and this documentation with the help of community members like you.

Get Started

Totally new to QMK? There are two ways to get started:

Make It Yours

QMK has lots of features to explore, and a good deal of reference documentation to dig through. Most features are taken advantage of by modifying your keymap, and changing the keycodes.

Need help?

Check out the support page to see how you can get help using QMK.

Give Back

There are a lot of ways you can contribute to the QMK Community. The easiest way to get started is to use it and spread the word to your friends.