History

QMK Bot 0e5f7ac3ba Merge remote-tracking branch 'origin/master' into develop		2023-10-09 22:17:19 +00:00
..
ChangeLog	Breaking changes changelog, 2023q3 version (#21848 )	2023-08-29 21:15:21 +10:00
gitbook/images	…
internals	…
ja	Move velocikey to within rgblight (#22123 )	2023-09-25 17:48:10 +01:00
zh-cn	Move velocikey to within rgblight (#22123 )	2023-09-25 17:48:10 +01:00
.nojekyll	…
CNAME	…
README.md	…
_langs.md	…
_summary.md	Move velocikey to within rgblight (#22123 )	2023-09-25 17:48:10 +01:00
adc_driver.md	…
apa102_driver.md	Update WS2812 docs and add APA102 docs (#22106 )	2023-09-25 14:18:40 +10:00
api_development_environment.md	…
api_development_overview.md	…
api_docs.md	…
api_overview.md	…
arm_debugging.md	…
audio_driver.md	…
breaking_changes.md	Breaking changes changelog, 2023q3 version (#21848 )	2023-08-29 21:15:21 +10:00
breaking_changes_history.md	Breaking changes changelog, 2023q3 version (#21848 )	2023-08-29 21:15:21 +10:00
breaking_changes_instructions.md	`develop` 2023q2 changelog (#21049 )	2023-05-29 06:02:11 +10:00
chibios_upgrade_instructions.md	…
cli.md	Fix minimum python version references (#22191 )	2023-10-04 01:19:04 +01:00
cli_commands.md	`qmk find`: usability improvements (#20440 )	2023-05-20 22:14:43 +10:00
cli_configuration.md	…
cli_development.md	Fix minimum python version references (#22191 )	2023-10-04 01:19:04 +01:00
cli_tab_complete.md	…
coding_conventions_c.md	[Docs] Code markdown amendment (#21323 )	2023-06-20 20:58:13 -06:00
coding_conventions_python.md	Fix minimum python version references (#22191 )	2023-10-04 01:19:04 +01:00
compatible_microcontrollers.md	STM32H723 support (#21352 )	2023-06-28 13:07:14 +10:00
config_options.md	Bluetooth: driver naming cleanups (#21624 )	2023-07-29 15:16:14 +10:00
configurator_architecture.md	…
configurator_default_keymaps.md	…
configurator_diagram.drawio	…
configurator_diagram.svg	…
configurator_step_by_step.md	…
configurator_troubleshooting.md	…
contributing.md	Breaking changes changelog, 2023q3 version (#21848 )	2023-08-29 21:15:21 +10:00
custom_matrix.md	…
custom_quantum_functions.md	…
data_driven_config.md	Consolidate `KEYBOARD_OUTPUT`+`KEYMAP_OUTPUT`=>`INTERMEDIATE_OUTPUT` (#21272 )	2023-06-21 08:41:49 +10:00
documentation_best_practices.md	…
documentation_templates.md	…
driver_installation_zadig.md	…
easy_maker.md	…
eeprom_driver.md	Default wear leveling logical size to half backing (#22006 )	2023-09-14 07:13:21 +10:00
faq_build.md	…
faq_debug.md	…
faq_general.md	…
faq_keymap.md	…
faq_misc.md	…
feature_advanced_keycodes.md	Update code example to match description (#20528 )	2023-04-23 12:56:45 -06:00
feature_audio.md	…
feature_auto_shift.md	Improve test invocation, fix Retro Shift bugs, and add Auto+Retro Shift test cases (#15889 )	2023-09-25 12:45:49 +10:00
feature_autocorrect.md	[Enhancement] More info on `apply_autocorrect` (#21056 )	2023-07-08 00:13:15 +10:00
feature_backlight.md	Add _DEFAULT_ON lighting configuration options (#21865 )	2023-09-29 18:31:21 +01:00
feature_bluetooth.md	Bluetooth: driver naming cleanups (#21624 )	2023-07-29 15:16:14 +10:00
feature_bootmagic.md	…
feature_caps_word.md	[Core] Caps Word "Invert on shift" option: pressing Shift inverts the shift state. (#20092 )	2023-04-04 09:11:26 +10:00
feature_combo.md	Keymap introspection for combos. (#19670 )	2023-05-15 22:27:37 +10:00
feature_command.md	…
feature_converters.md	Merge remote-tracking branch 'origin/master' into develop	2023-04-07 22:12:38 +00:00
feature_debounce_type.md	Add debounce time description (#20333 )	2023-04-04 12:15:00 +10:00
feature_digitizer.md	…
feature_dip_switch.md	…
feature_dynamic_macros.md	…
feature_eeprom.md	…
feature_encoders.md	Encodermap direction define. (#20454 )	2023-04-15 16:18:44 +01:00
feature_grave_esc.md	…
feature_haptic_feedback.md	haptic: further naming cleanups (#21682 )	2023-08-04 01:16:16 +01:00
feature_hd44780.md	Fix anchor IDs for some API references (#21345 )	2023-06-24 17:44:50 +10:00
feature_joystick.md	…
feature_key_lock.md	…
feature_key_overrides.md	[Feature] Send a dummy keycode to neutralize flashing modifiers in retro tap and key overrides (#20992 )	2023-07-08 00:18:02 +10:00
feature_layers.md	Changed interverts to inverts (#21270 )	2023-07-03 17:01:10 +01:00
feature_layouts.md	…
feature_leader_key.md	…
feature_led_indicators.md	…
feature_led_matrix.md	Update ISSI LED types (#22099 )	2023-10-04 20:12:50 +11:00
feature_macros.md	Corrected duration example, should be number not string (#21839 )	2023-08-26 19:43:40 +01:00
feature_midi.md	…
feature_mouse_keys.md	Add MOUSEKEY_WHEEL_DELTA documentation (#21493 )	2023-07-10 10:57:08 -07:00
feature_oled_driver.md	Merge remote-tracking branch 'origin/master' into develop	2023-09-25 19:41:01 +00:00
feature_os_detection.md	…
feature_pointing_device.md	Make Pointing Device Auto Layer more configurable (#20061 )	2023-05-06 06:38:45 -07:00
feature_programmable_button.md	Fix doc for programmable buttons. (#22136 )	2023-09-25 23:17:20 -07:00
feature_ps2_mouse.md	Document the RP2040-specific PS/2 implementation (#22079 )	2023-09-25 13:00:13 +10:00
feature_rawhid.md	Raw HID: documentation improvements (#21596 )	2023-07-25 09:20:41 +10:00
feature_repeat_key.md	[Core] Add Repeat Key ("repeat last key") as a core feature. (#19700 )	2023-05-20 22:35:06 +10:00
feature_rgb_matrix.md	Update ISSI LED types (#22099 )	2023-10-04 20:12:50 +11:00
feature_rgblight.md	Add `RGBLIGHT_DEFAULT_ON` macro configuration option (#20857 )	2023-09-29 14:53:12 +01:00
feature_secure.md	…
feature_send_string.md	Fix anchor IDs for some API references (#21345 )	2023-06-24 17:44:50 +10:00
feature_sequencer.md	…
feature_space_cadet.md	Use wayback machine for unreachable site (#20987 )	2023-05-21 17:44:06 +01:00
feature_split_keyboard.md	Add full solenoid support on split keyboards (#21583 )	2023-09-25 12:23:31 +10:00
feature_st7565.md	…
feature_stenography.md	…
feature_swap_hands.md	Add swap hands toggle functions (#20381 )	2023-04-09 09:37:31 -07:00
feature_tap_dance.md	On-each-release tap dance function (#20255 )	2023-07-26 21:04:35 -07:00
feature_tri_layer.md	Fix typo in `docs/feature_tri_layer.md` (#22232 )	2023-10-09 09:37:21 +01:00
feature_unicode.md	Fix old usage of UNICODE_MODE_MAC (#22238 )	2023-10-09 23:16:54 +01:00
feature_userspace.md	…
feature_wpm.md	Fix typo in `feature_wpm.md` title (#20464 )	2023-04-16 15:14:08 +01:00
flash_driver.md	…
flashing.md	feat, docs: WB32 flashing (#21217 )	2023-07-08 00:48:45 +10:00
flashing_bootloadhid.md	…
fuse.txt	…
getting_started_docker.md	…
getting_started_github.md	…
getting_started_introduction.md	…
getting_started_make_guide.md	Unicodemap keycodes rename (#21092 )	2023-06-01 17:25:08 +01:00
gpio_control.md	…
hand_wire.md	…
hardware_drivers.md	…
hardware_keyboard_guidelines.md	…
how_a_matrix_works.md	…
how_keyboards_work.md	…
i2c_driver.md	Fix anchor IDs for some API references (#21345 )	2023-06-24 17:44:50 +10:00
index.html	…
isp_flashing_guide.md	Adds Docs option for ArduinoIDE's example `ArduinoISP` (#20486 )	2023-04-19 19:23:50 +01:00
keycodes.md	Unicodemap keycodes rename (#21092 )	2023-06-01 17:25:08 +01:00
keycodes_basic.md	…
keycodes_magic.md	…
keycodes_us_ansi_shifted.md	…
keymap.md	…
mod_tap.md	…
newbs.md	…
newbs_building_firmware.md	…
newbs_building_firmware_configurator.md	Update newbs docs with some rp2040 stuff (#21186 )	2023-06-10 15:56:43 +01:00
newbs_building_firmware_workflow.md	[Docs] Highlight keymap name entry (#21138 )	2023-06-05 23:17:39 -06:00
newbs_flashing.md	Update newbs docs with some rp2040 stuff (#21186 )	2023-06-10 15:56:43 +01:00
newbs_getting_started.md	Remove rosetta instructions for Apple Silicon (#22174 )	2023-09-30 22:33:57 -07:00
newbs_git_best_practices.md	…
newbs_git_resolving_merge_conflicts.md	…
newbs_git_resynchronize_a_branch.md	…
newbs_git_using_your_master_branch.md	…
newbs_learn_more_resources.md	…
newbs_testing_debugging.md	…
one_shot_keys.md	…
other_eclipse.md	…
other_vscode.md	Fix VS code live share extension link (#21585 )	2023-07-23 09:07:17 +01:00
platformdev_blackpill_f4x1.md	…
platformdev_chibios_earlyinit.md	…
platformdev_proton_c.md	…
platformdev_rp2040.md	…
platformdev_selecting_arm_mcu.md	…
porting_your_keyboard_to_qmk.md	…
power.txt	…
pr_checklist.md	Add reminder about format-json to PR Checklist (#22055 )	2023-09-23 01:18:11 -07:00
qmk.css	…
qmk_custom_dark.css	[Docs] Improve contrast for warnings in dark mode (#21928 )	2023-09-05 19:00:14 -07:00
qmk_custom_light.css	…
quantum_keycodes.md	[Docs] Add note about `ENABLE_COMPILE_KEYCODE` to docs (#21290 )	2023-06-19 19:55:27 -06:00
quantum_painter.md	[Enhancement] QP Getters (#21171 )	2023-09-25 12:31:46 +10:00
quantum_painter_lvgl.md	Lvgl rate control (#22049 )	2023-09-17 14:25:14 +10:00
quantum_painter_qff.md	…
quantum_painter_qgf.md	…
quantum_painter_rle.md	…
redirects.json	…
ref_functions.md	…
reference_configurator_support.md	…
reference_glossary.md	Breaking changes changelog, 2023q3 version (#21848 )	2023-08-29 21:15:21 +10:00
reference_info_json.md	Rename CKLED2001 driver to SNLED27351 (#22071 )	2023-10-04 20:10:05 +11:00
reference_keymap_extras.md	…
serial_driver.md	…
spi_driver.md	Chibios SPI driver: allow some SPI pins to be left unassigned (#20315 )	2023-09-25 12:54:22 +10:00
squeezing_avr.md	Added flower blooming on RGB Matrix effect (#21948 )	2023-09-25 12:58:45 +10:00
support.md	…
support_deprecation_policy.md	…
sw.js	…
syllabus.md	…
tap_hold.md	[Feature] Send a dummy keycode to neutralize flashing modifiers in retro tap and key overrides (#20992 )	2023-07-08 00:18:02 +10:00
translating.md	…
uart_driver.md	Fix anchor IDs for some API references (#21345 )	2023-06-24 17:44:50 +10:00
understanding_qmk.md	Move `pre_process_record_kb()` before `process_combo()` (#20969 )	2023-05-20 22:15:55 +10:00
unit_testing.md	Improve test invocation, fix Retro Shift bugs, and add Auto+Retro Shift test cases (#15889 )	2023-09-25 12:45:49 +10:00
usb_nkro.txt	…
ws2812_driver.md	Update WS2812 docs and add APA102 docs (#22106 )	2023-09-25 14:18:40 +10:00

README.md

Quantum Mechanical Keyboard Firmware

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

?> Basic QMK Configurator
User friendly graphical interfaces, no programming knowledge required.

?> Advanced Use The Source
More powerful, but harder to use.

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.

Help people out on our forums and chat rooms:
- /r/olkb
- Discord Server
Contribute to our documentation by clicking "Edit This Page" at the bottom
Translate our documentation into your language
Report a bug
Open a Pull Request