History

QMK Bot a76a6580f8 Merge remote-tracking branch 'origin/master' into develop		2024-05-19 04:44:03 +00:00
..
ChangeLog	MechKeys ACR60 Layout Updates (#23309 )	2024-04-29 20:04:04 -07:00
gitbook/images	…
internals	…
ja	…
zh-cn	Move velocikey to within rgblight (#22123 )	2023-09-25 17:48:10 +01:00
.nojekyll	…
CNAME	…
README.md	…
__capabilities.md	…
__capabilities_inc.md	…
_langs.md	…
_summary.md	…
adc_driver.md	…
apa102_driver.md	…
api_development_environment.md	…
api_development_overview.md	…
api_docs.md	…
api_overview.md	…
arm_debugging.md	…
audio_driver.md	[Audio] Enable Complementary output for PWM Hardware driver (#22726 )	2023-12-21 19:38:59 -08:00
breaking_changes.md	2024q1 `develop` changelog. (#23150 )	2024-02-28 21:39:19 +11:00
breaking_changes_history.md	…
breaking_changes_instructions.md	…
chibios_upgrade_instructions.md	…
cli.md	…
cli_commands.md	Merge remote-tracking branch 'origin/master' into develop	2024-05-07 11:52:16 +00:00
cli_configuration.md	…
cli_development.md	…
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	…
compatible_microcontrollers.md	STM32H723 support (#21352 )	2023-06-28 13:07:14 +10:00
config_options.md	…
configurator_architecture.md	…
configurator_default_keymaps.md	…
configurator_diagram.drawio	…
configurator_diagram.svg	…
configurator_step_by_step.md	…
configurator_troubleshooting.md	…
contributing.md	Documentation regarding user code removal/acceptance (#22507 )	2023-12-04 00:57:42 +00:00
custom_matrix.md	…
custom_quantum_functions.md	…
data_driven_config.md	…
documentation_best_practices.md	…
documentation_templates.md	…
driver_installation_zadig.md	Update Atmel DFU driver assignments for dfu-programmer 1.x (#23165 )	2024-02-28 21:03:43 +11:00
easy_maker.md	…
eeprom_driver.md	…
faq_build.md	…
faq_debug.md	…
faq_general.md	…
faq_keymap.md	…
faq_misc.md	…
feature_advanced_keycodes.md	…
feature_audio.md	…
feature_auto_shift.md	…
feature_autocorrect.md	…
feature_backlight.md	Move BACKLIGHT_PWM_PERIOD to correct docs section (#22480 )	2023-11-22 11:41:19 +11:00
feature_bluetooth.md	…
feature_bootmagic.md	Removal of bootmagic lite terminology (#22979 )	2024-02-17 12:27:34 +00:00
feature_caps_word.md	…
feature_combo.md	[Doc] Reference advance keycodes in combos (#23666 )	2024-05-18 21:41:03 -07:00
feature_command.md	…
feature_converters.md	Add Imera converter (#22419 )	2023-11-28 17:53:47 +11:00
feature_debounce_type.md	…
feature_digitizer.md	…
feature_dip_switch.md	…
feature_dynamic_macros.md	…
feature_eeprom.md	…
feature_encoders.md	…
feature_grave_esc.md	…
feature_haptic_feedback.md	haptic: further naming cleanups (#21682 )	2023-08-04 01:16:16 +01:00
feature_hd44780.md	…
feature_joystick.md	…
feature_key_lock.md	…
feature_key_overrides.md	…
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	Update naming convention for GPIO control macros (#23085 )	2024-02-17 00:18:26 +11:00
feature_led_matrix.md	Add new set of keycodes for LED Matrix (#23432 )	2024-04-11 14:14:02 +10:00
feature_macros.md	…
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	…
feature_os_detection.md	…
feature_pointing_device.md	…
feature_programmable_button.md	…
feature_ps2_mouse.md	Document the RP2040-specific PS/2 implementation (#22079 )	2023-09-25 13:00:13 +10:00
feature_rawhid.md	…
feature_repeat_key.md	…
feature_rgb_matrix.md	…
feature_rgblight.md	Rename `RGBW` define to `WS2812_RGBW` (#23585 )	2024-04-28 00:36:54 +10:00
feature_secure.md	…
feature_send_string.md	…
feature_sequencer.md	…
feature_space_cadet.md	…
feature_split_keyboard.md	Oneshot locked mods split transaction (#23434 )	2024-04-08 12:55:42 -06:00
feature_st7565.md	…
feature_stenography.md	…
feature_swap_hands.md	…
feature_tap_dance.md	…
feature_tri_layer.md	…
feature_unicode.md	Fix old usage of UNICODE_MODE_MAC (#22238 )	2023-10-09 23:16:54 +01:00
feature_userspace.md	Documentation regarding user code removal/acceptance (#22507 )	2023-12-04 00:57:42 +00:00
feature_wpm.md	…
flash_driver.md	…
flashing.md	Add page for capabilties used by docs site. (#23428 )	2024-05-05 11:38:31 +01:00
flashing_bootloadhid.md	…
fuse.txt	…
getting_started_docker.md	…
getting_started_github.md	…
getting_started_introduction.md	…
getting_started_make_guide.md	…
gpio_control.md	…
hand_wire.md	…
hardware_drivers.md	…
hardware_keyboard_guidelines.md	Rename `RGBLED_NUM` -> `RGBLIGHT_LED_COUNT` (#22570 )	2023-12-12 15:30:08 +11:00
how_a_matrix_works.md	…
how_keyboards_work.md	…
i2c_driver.md	…
index.html	…
isp_flashing_guide.md	…
keycodes.md	Add new set of keycodes for LED Matrix (#23432 )	2024-04-11 14:14:02 +10: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	…
newbs_building_firmware_workflow.md	[Doc]: Correct Markdown syntax errors. (#22511 )	2023-11-29 02:48:47 +00:00
newbs_external_userspace.md	…
newbs_flashing.md	Update newbs docs with some rp2040 stuff (#21186 )	2023-06-10 15:56:43 +01:00
newbs_getting_started.md	…
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	…
platformdev_blackpill_f4x1.md	…
platformdev_chibios_earlyinit.md	…
platformdev_proton_c.md	…
platformdev_rp2040.md	[Core] Allow ChibiOS `SIO` driver for `UART` driver (#22839 )	2024-02-20 11:34:24 +01:00
platformdev_selecting_arm_mcu.md	…
porting_your_keyboard_to_qmk.md	…
power.txt	…
pr_checklist.md	PR Checklist: explain wireless requirements. (#23584 )	2024-04-23 19:38:08 +10:00
qmk.css	…
qmk_custom_dark.css	…
qmk_custom_light.css	…
quantum_keycodes.md	…
quantum_painter.md	…
quantum_painter_lvgl.md	…
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	…
reference_keymap_extras.md	Add MacOS Czech ISO and ANSI keymaps #23346 (#23412 )	2024-04-30 23:53:30 -07:00
serial_driver.md	Update serial_driver.md (#23035 )	2024-03-29 19:04:23 -06:00
spi_driver.md	Dedupe I2C, SPI, UART driver inclusions (#22253 )	2023-10-13 17:25:32 +11:00
squeezing_avr.md	…
support.md	…
support_deprecation_policy.md	…
sw.js	…
syllabus.md	…
tap_hold.md	…
translating.md	…
uart_driver.md	[Core] Allow ChibiOS `SIO` driver for `UART` driver (#22839 )	2024-02-20 11:34:24 +01:00
understanding_qmk.md	…
unit_testing.md	…
usb_nkro.txt	…
ws2812_driver.md	Rename `RGBW` define to `WS2812_RGBW` (#23585 )	2024-04-28 00:36:54 +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