History

umi 808aab8496 add japanese translation (feature part 01) (#8196 ) * add feature part 01 * update sentences * update sentences * update sentences * update file based on comment * leave ctrl, shift, alt key name as alphabet * update file based on comment * update file based on comment * update file based on comment * update file based on comment * remove unnecessary space on define line * update sentence based on pull request's comment * translate 'breathing' in document * change expression in table * update file based on comment * change the word 'brightness', and update based on comment * update based on comment * update based on comment * add language directory name to each internal link * update based on comment * update based on comment		2020-04-02 12:56:59 +09:00
..
ChangeLog	…
de	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
es	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
fr-fr	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
gitbook/images	…
he-il	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
ja	add japanese translation (feature part 01) (#8196 )	2020-04-02 12:56:59 +09:00
pt-br	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
ru-ru	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
zh-cn	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
.nojekyll	…
CNAME	…
README.md	make sure all our redirects are in order	2020-03-05 16:00:10 -08:00
_langs.md	…
_summary.md	Add Word Per Minute calculation feature (#8054 )	2020-03-23 00:06:16 +11:00
adc_driver.md	ARM - ADC cleanup (#8385 )	2020-03-17 00:29:52 +00:00
api_development_environment.md	…
api_development_overview.md	…
api_docs.md	…
api_overview.md	…
arm_debugging.md	…
breaking_changes.md	…
breaking_changes_instructions.md	…
cli.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
cli_commands.md	Document 'make all:<name>' (#8439 )	2020-03-16 14:27:19 +00:00
cli_configuration.md	Fix some broken links in the docs (#8394 )	2020-03-15 07:48:44 -07:00
cli_development.md	…
coding_conventions_c.md	…
coding_conventions_python.md	…
compatible_microcontrollers.md	…
config_options.md	Feature: RGBLight layers (#7768 )	2020-03-10 12:50:01 -07:00
configurator_step_by_step.md	…
configurator_troubleshooting.md	…
contributing.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
custom_matrix.md	…
custom_quantum_functions.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
documentation_best_practices.md	…
documentation_templates.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
driver_installation_zadig.md	…
eeprom_driver.md	Add support for STM32L0/L1 onboard EEPROM. (#8002 )	2020-03-12 12:59:55 +11:00
faq_build.md	…
faq_debug.md	…
faq_general.md	…
faq_keymap.md	…
feature_advanced_keycodes.md	[Docs] Update layer documentation (#8371 )	2020-03-21 10:17:02 -07:00
feature_audio.md	…
feature_auto_shift.md	…
feature_backlight.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
feature_bluetooth.md	…
feature_bootmagic.md	Add support for Bootmagic lite when using SPLIT_HAND_PIN (#8347 )	2020-03-21 23:10:39 +00:00
feature_combo.md	…
feature_command.md	…
feature_debounce_type.md	…
feature_dip_switch.md	…
feature_dynamic_macros.md	…
feature_encoders.md	…
feature_grave_esc.md	…
feature_haptic_feedback.md	…
feature_hd44780.md	…
feature_key_lock.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
feature_layers.md	[Docs] Update layer documentation (#8371 )	2020-03-21 10:17:02 -07:00
feature_layouts.md	…
feature_leader_key.md	[Docs] Update layer documentation (#8371 )	2020-03-21 10:17:02 -07:00
feature_led_matrix.md	…
feature_macros.md	Add Post Processing to process_record (#4892 )	2020-03-23 00:29:05 +11:00
feature_mouse_keys.md	Decouple mouse cursor and mouse wheel in accelerated mode (#6685 )	2020-03-13 12:49:44 -04:00
feature_oled_driver.md	Adding OLED scroll setup functions (#8386 )	2020-03-14 21:04:34 +00:00
feature_pointing_device.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
feature_ps2_mouse.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
feature_rgb_matrix.md	[Docs] Update RGB Matrix docs with function refs (#8367 )	2020-03-24 18:54:38 -07:00
feature_rgblight.md	[Docs] Fixes for feature_rgblight.md (#8514 )	2020-03-21 20:11:06 +00:00
feature_space_cadet.md	…
feature_split_keyboard.md	…
feature_stenography.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
feature_swap_hands.md	…
feature_tap_dance.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
feature_terminal.md	…
feature_thermal_printer.md	…
feature_unicode.md	Rename UC_OSX (and related constants) to UC_MAC (#8589 )	2020-03-31 18:28:43 +02:00
feature_userspace.md	Document 'make all:<name>' (#8439 )	2020-03-16 14:27:19 +00:00
feature_velocikey.md	…
feature_wpm.md	Add Word Per Minute calculation feature (#8054 )	2020-03-23 00:06:16 +11:00
flashing.md	…
flashing_bootloadhid.md	…
fuse.txt	…
getting_started_github.md	Restore getting_started_github.md doc	2020-03-12 17:24:07 -07:00
getting_started_introduction.md	…
getting_started_make_guide.md	…
getting_started_vagrant.md	…
hand_wire.md	make sure all our redirects are in order	2020-03-05 16:00:10 -08:00
hardware_avr.md	…
hardware_drivers.md	…
hardware_keyboard_guidelines.md	[Docs] added the description of the reading order of the rules.mk files. (#8566 )	2020-03-29 13:00:47 -07:00
how_a_matrix_works.md	refactor How a Matrix Works doc	2020-03-05 16:00:10 -08:00
how_keyboards_work.md	…
i2c_driver.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
index.html	Fix some broken links in the docs (#8394 )	2020-03-15 07:48:44 -07:00
internals_defines.md	…
internals_gpio_control.md	[Docs] Random Fixes (#8340 )	2020-03-15 20:29:11 -07:00
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	…
keycodes.md	Rename UC_OSX (and related constants) to UC_MAC (#8589 )	2020-03-31 18:28:43 +02:00
keycodes_basic.md	…
keycodes_us_ansi_shifted.md	…
keymap.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
mod_tap.md	…
newbs.md	…
newbs_building_firmware.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
newbs_building_firmware_configurator.md	…
newbs_flashing.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
newbs_getting_started.md	Update newbs_getting_started.md	2020-03-31 14:26:19 -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	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
newbs_learn_more_resources.md	…
newbs_testing_debugging.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
one_shot_keys.md	…
other_eclipse.md	fix two links on docs/other_eclipse.md (#8417 )	2020-03-14 13:25:21 +00:00
other_vscode.md	…
power.txt	…
proton_c_conversion.md	…
qmk.css	…
qmk_custom_dark.css	Fix darkmode (#8393 )	2020-03-12 18:17:47 +11:00
qmk_custom_light.css	Fix darkmode (#8393 )	2020-03-12 18:17:47 +11:00
quantum_keycodes.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
redirects.json	…
ref_functions.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
reference_configurator_support.md	…
reference_glossary.md	…
reference_info_json.md	…
support.md	make sure all our redirects are in order	2020-03-05 16:00:10 -08:00
sw.js	…
tap_hold.md	Correct typo in tap_hold.md (#8326 )	2020-03-07 05:42:08 +11:00
translating.md	…
understanding_qmk.md	Add Post Processing to process_record (#4892 )	2020-03-23 00:29:05 +11:00
unit_testing.md	Add explicit id tags to externally linked headers	2020-03-05 16:00:10 -08:00
usb_nkro.txt	…
ws2812_driver.md	…

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

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

Basic: QMK Configurator
- Just select your keyboard from the dropdown and program your keyboard.
- We have an introductory video you can watch.
- There is also an overview document you can read.
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