You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qmk-fw/docs
Joel Challis 76378d74f5 ARM split - detect USB to select master/slave (#6424)
* Initial split refactor to allow usb master detection

* Add split USB detect docs

* Add SPLIT_USB_DETECT demo mode limitation

* fix rebase issues

* clang-format
6 years ago
..
ChangeLog consistency 6 years ago
fr-FR [Docs] French translation - Breaking Changes section (#6966) 6 years ago
gitbook/images
zh-cn Expose zh-cn docs, delete bad zh docs, add docs for adding translations (#6855) 6 years ago
.nojekyll
CNAME
README.md
_langs.md [Docs] French translation of Complete Newbs Guide (#6901) 6 years ago
_summary.md Expose zh-cn docs, delete bad zh docs, add docs for adding translations (#6855) 6 years ago
arm_debugging.md Fixed typos in documentation (#6871) 6 years ago
becoming_a_qmk_collaborator.md
breaking_changes.md Update the breaking changes process so we always have a future branch (#6785) 6 years ago
cli.md [Docs] CLI command to serve docs locally (#6956) 6 years ago
cli_configuration.md Configuration system for CLI (#6708) 6 years ago
cli_development.md Configuration system for CLI (#6708) 6 years ago
coding_conventions_c.md QMK CLI and JSON keymap support (#6176) 6 years ago
coding_conventions_python.md QMK CLI and JSON keymap support (#6176) 6 years ago
compatible_microcontrollers.md
config_options.md ARM split - detect USB to select master/slave (#6424) 6 years ago
contributing.md [Docs] Add an important note about modifying user code (#6959) 6 years ago
custom_quantum_functions.md Additional changes for Layer State typedef compatibility (#5906) 6 years ago
documentation_best_practices.md
documentation_templates.md
driver_installation_zadig.md [Keyboard] Add Discipad, Update Zadig doc for USBaspLoader (#6771) 6 years ago
faq.md
faq_build.md Add Zadig 101 to docs (#6585) 6 years ago
faq_debug.md Remove superfluous JTAG disable code (#6445) 6 years ago
faq_general.md Remove unanswered/unnecessary FAQ item 6 years ago
faq_keymap.md
feature_advanced_keycodes.md fix typo 6 years ago
feature_audio.md Added keycodes for swapping and unswapping the Control and OS keys (#6110) 6 years ago
feature_auto_shift.md
feature_backlight.md ARM - Initial backlight support (#6487) 6 years ago
feature_bluetooth.md
feature_bootmagic.md ARM split - Add bootmagic/magic keycodes for setting handedness (#6545) 6 years ago
feature_combo.md Change "yu" to "you" in combo docs (#6510) 6 years ago
feature_command.md Update IS_COMMAND definitions to use MOD_MASK_SHIFT (#6348) 6 years ago
feature_debounce_type.md Eager Per Row Debouncing added (added to Ergodox) (#5498) 6 years ago
feature_dip_switch.md Add Dip Switch as a core feature (#6140) 6 years ago
feature_dynamic_macros.md
feature_encoders.md Add support for different encoder pinout for right half of split keyboard (#6521) 6 years ago
feature_grave_esc.md Document an annoyance with Grave Escape and macOS Terminal (#5483) 6 years ago
feature_haptic_feedback.md DRV2605L Continuous Haptic Feedback Support (#6461) 6 years ago
feature_hd44780.md [Docs] Typo fix for feature_hd44780.md (#6917) 6 years ago
feature_key_lock.md
feature_layouts.md
feature_leader_key.md
feature_led_matrix.md
feature_macros.md [Docs] Update Super ALT↯TAB to remove use of unregister_code16 (#5766) 6 years ago
feature_mouse_keys.md Update mouse keys docs (#5653) 6 years ago
feature_oled_driver.md Added OLED Display autoscroll during periods of OLED data inactivity (#6546) 6 years ago
feature_pointing_device.md
feature_ps2_mouse.md [Docs] Removed dead link (#6922) 6 years ago
feature_rgb_matrix.md [Docs] Add RGB Matrix default mode define info (#6564) 6 years ago
feature_rgblight.md Add effect range to rgblight.c (#5856) 6 years ago
feature_space_cadet.md Added mod carry over from press to release. (#5866) 6 years ago
feature_split_keyboard.md ARM split - detect USB to select master/slave (#6424) 6 years ago
feature_stenography.md
feature_swap_hands.md
feature_tap_dance.md [Docs] removed unneeded line of code in Tap Dance documentation (#6981) 6 years ago
feature_terminal.md
feature_thermal_printer.md
feature_unicode.md [Docs] Clarify the rules.mk setup for Unicode (#6286) 6 years ago
feature_userspace.md Additional changes for Layer State typedef compatibility (#5906) 6 years ago
feature_velocikey.md
features.md Add Dip Switch as a core feature (#6140) 6 years ago
flashing.md ARM split - Add support for dfu-util EE_HANDS flashing (#6543) 6 years ago
flashing_bootloadhid.md Add 'bootloadHID' flash target (#5587) 6 years ago
fuse.txt
getting_started_build_tools.md Change from avr-gcc@7 to @8 for Mac 6 years ago
getting_started_getting_help.md
getting_started_github.md
getting_started_introduction.md [Docs] Update getting_started_introduction.md (#6037) 6 years ago
getting_started_make_guide.md Add 'bootloadHID' flash target (#5587) 6 years ago
getting_started_vagrant.md Configure Vagrant to use qmk_base_container (#6194) 6 years ago
hand_wire.md A better new_project.sh (#5191) 6 years ago
hardware.md
hardware_avr.md Reword a note about the MANUFACTURER and PRODUCT defines in hardware_avr.md (#6558) 6 years ago
hardware_drivers.md OLED Driver Feature 6 years ago
hardware_keyboard_guidelines.md Fixed typos in documentation (#6871) 6 years ago
how_keyboards_work.md [Docs] Update how_keyboards_work.md (#6528) 6 years ago
i2c_driver.md [Docs] Update i2c_driver.md (#6665) 6 years ago
index.html Expose zh-cn docs, delete bad zh docs, add docs for adding translations (#6855) 6 years ago
internals_defines.md
internals_gpio_control.md [Docs] Add AVR and ARM examples to GPIO Commands (#6942) 6 years ago
internals_input_callback_reg.md
internals_midi_device.md
internals_midi_device_setup_process.md
internals_midi_util.md
internals_send_functions.md
internals_sysex_tools.md
isp_flashing_guide.md ISP Flashing Guide - atmega32a info (#4993) 6 years ago
keycodes.md ARM split - Add bootmagic/magic keycodes for setting handedness (#6545) 6 years ago
keycodes_basic.md
keycodes_us_ansi_shifted.md
keymap.md [Docs] Smallish overhaul of the docs (#5281) 6 years ago
newbs.md
newbs_best_practices.md
newbs_building_firmware.md [Docs] Clean up docs/newbs_building_firmware.md (#6930) 6 years ago
newbs_building_firmware_configurator.md Update YouTube URL 6 years ago
newbs_flashing.md [Docs] Clean up docs/newbs_flashing.md (#6973) 6 years ago
newbs_getting_started.md [Docs] Recursively clone qmk_firmware repo (#5378) 6 years ago
newbs_learn_more_resources.md
newbs_testing_debugging.md [Docs] Add examples to debugging docs (#5555) 6 years ago
other_eclipse.md [Docs] Add VSCode guide to docs (#5124) 6 years ago
other_vscode.md [Docs] Add VSCode guide to docs (#5124) 6 years ago
porting_your_keyboard_to_qmk_(arm_and_other_chibios_cpus).md Improve backlight PWM pin support (#6202) 6 years ago
power.txt
proton_c_conversion.md
qmk.css
quantum_keycodes.md Added check for event pressed to clear space cadet (#5839) 6 years ago
redirects.json Configuration system for CLI (#6708) 6 years ago
ref_functions.md Additional changes for Layer State typedef compatibility (#5906) 6 years ago
reference_configurator_support.md Update reference_configurator_support.md 6 years ago
reference_glossary.md
reference_info_json.md
sidebar.css
support.md
sw.js
translating.md Expose zh-cn docs, delete bad zh docs, add docs for adding translations (#6855) 6 years ago
understanding_qmk.md [Docs] Smallish overhaul of the docs (#5281) 6 years ago
unit_testing.md
usb_nkro.txt

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 that maintains QMK Firmware, QMK Toolbox, qmk.fm, and these docs. QMK Firmware is a keyboard firmware based on the tmk_keyboard with some useful features for Atmel AVR controllers, and more specifically, the OLKB product line, the ErgoDox EZ keyboard, and the Clueboard product line. It has also been ported to ARM chips using ChibiOS. You can use it to power your own hand-wired or custom keyboard PCB.

How to Get It

If you plan on contributing a keymap, keyboard, or features to QMK, the easiest thing to do is fork the repo through Github, and clone your repo locally to make your changes, push them, then open a Pull Request from your fork.

Otherwise, you can either download it directly (zip, tar), or clone it via git (git@github.com:qmk/qmk_firmware.git), or https (https://github.com/qmk/qmk_firmware.git).

How to Compile

Before you are able to compile, you'll need to install an environment for AVR or/and ARM development. Once that is complete, you'll use the make command to build a keyboard and keymap with the following notation:

make planck/rev4:default

This would build the rev4 revision of the planck with the default keymap. Not all keyboards have revisions (also called subprojects or folders), in which case, it can be omitted:

make preonic:default

How to Customize

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.