History

Takeshi ISHII f66680d233 Fixed the indentation of the sample code in feature_pointing_device docs (#9177 ) * Fixed the indentation of the sample code in docs/feature_pointing_device.md sample. * Update docs/feature_pointing_device.md Co-authored-by: Joel Challis <git@zvecr.com> Co-authored-by: Joel Challis <git@zvecr.com>		2020-05-23 23:57:59 +01:00
..
ChangeLog	…
de	spi_master for AVR (#8299 )	2020-04-08 11:04:31 +10:00
es	spi_master for AVR (#8299 )	2020-04-08 11:04:31 +10:00
fr-fr	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
gitbook/images	…
he-il	spi_master for AVR (#8299 )	2020-04-08 11:04:31 +10:00
ja	[Docs] Japanese translation of docs/feature_led_matrix.md (#8991 )	2020-05-18 20:37:25 -07:00
pt-br	spi_master for AVR (#8299 )	2020-04-08 11:04:31 +10:00
ru-ru	spi_master for AVR (#8299 )	2020-04-08 11:04:31 +10:00
zh-cn	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
.nojekyll	…
CNAME	…
README.md	…
_langs.md	…
_summary.md	ARM split - Add uart half duplex transport support (#7987 )	2020-05-21 18:00:21 +01:00
adc_driver.md	…
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	Streamline the macos install process	2020-05-18 22:46:33 -07:00
cli_commands.md	Make dedicated sections for user/dev commands in docs	2020-04-08 09:31:14 -07:00
cli_configuration.md	…
cli_development.md	Move everything to Python 3.6 (#8835 )	2020-04-18 22:00:56 +02:00
coding_conventions_c.md	Update C coding conventions to match .clang-format config for i… (#8717 )	2020-04-07 14:14:08 +10:00
coding_conventions_python.md	Move everything to Python 3.6 (#8835 )	2020-04-18 22:00:56 +02:00
compatible_microcontrollers.md	…
config_options.md	Allow expanding from 8 to 32 RGB Lighting Layers (#8941 )	2020-05-13 21:39:05 +01:00
configurator_step_by_step.md	…
configurator_troubleshooting.md	…
contributing.md	…
custom_matrix.md	…
custom_quantum_functions.md	…
documentation_best_practices.md	…
documentation_templates.md	…
driver_installation_zadig.md	…
eeprom_driver.md	Add SPI 25xx EEPROM support. (#8780 )	2020-05-19 10:34:00 +10:00
faq_build.md	Streamline the macos install process	2020-05-18 22:46:33 -07:00
faq_debug.md	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
faq_general.md	…
faq_keymap.md	…
feature_advanced_keycodes.md	Add OPT aliases for ALT keycodes and macros (#8714 )	2020-04-12 11:37:55 -07:00
feature_audio.md	…
feature_auto_shift.md	…
feature_backlight.md	…
feature_bluetooth.md	…
feature_bootmagic.md	…
feature_combo.md	…
feature_command.md	…
feature_debounce_type.md	quantum/debounce: Added sym_pk debounce algorithm (#8587 )	2020-04-11 21:29:48 +10:00
feature_dip_switch.md	…
feature_dynamic_macros.md	…
feature_encoders.md	fix sample code indent in feature_encoders.md (#8883 )	2020-04-23 08:56:22 +10:00
feature_grave_esc.md	…
feature_haptic_feedback.md	…
feature_hd44780.md	fixed typo for clear lcd screen function in hd44780 docs (#9086 )	2020-05-13 19:06:41 +01:00
feature_key_lock.md	…
feature_layers.md	…
feature_layouts.md	…
feature_leader_key.md	…
feature_led_matrix.md	…
feature_macros.md	Add OPT aliases for ALT keycodes and macros (#8714 )	2020-04-12 11:37:55 -07:00
feature_mouse_keys.md	…
feature_oled_driver.md	…
feature_pointing_device.md	Fixed the indentation of the sample code in feature_pointing_device docs (#9177 )	2020-05-23 23:57:59 +01:00
feature_ps2_mouse.md	Add PS2_MOUSE_ROTATE to compensate for device orientation (#8650 )	2020-04-09 01:29:27 -07:00
feature_rawhid.md	Allow for overriding RAW endpoint usage page and ID. (#8834 )	2020-05-21 20:31:42 +10:00
feature_rgb_matrix.md	Add query functions for RGB Light and RGB Matrix (#8960 )	2020-05-18 06:05:35 -07:00
feature_rgblight.md	Add query functions for RGB Light and RGB Matrix (#8960 )	2020-05-18 06:05:35 -07:00
feature_space_cadet.md	…
feature_split_keyboard.md	Update ARM split keyboard docs (#9160 )	2020-05-22 06:20:46 +10:00
feature_stenography.md	…
feature_swap_hands.md	One shot support for swap hands (#8590 )	2020-05-14 07:36:55 +10:00
feature_tap_dance.md	…
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	…
feature_velocikey.md	…
feature_wpm.md	…
flashing.md	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
flashing_bootloadhid.md	…
fuse.txt	…
getting_started_docker.md	Reintegrate previous docker docs (#9084 )	2020-05-19 21:54:55 -07:00
getting_started_github.md	…
getting_started_introduction.md	…
getting_started_make_guide.md	…
getting_started_vagrant.md	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
hand_wire.md	…
hardware_avr.md	…
hardware_drivers.md	…
hardware_keyboard_guidelines.md	…
how_a_matrix_works.md	…
how_keyboards_work.md	…
i2c_driver.md	…
index.html	Add redirect for old getting started links (#8987 )	2020-05-02 04:29:55 +01:00
internals_defines.md	…
internals_gpio_control.md	add 'togglePin' convenience function (#8734 )	2020-04-29 04:04:29 -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	Improve stock bootloader list (#9067 )	2020-05-13 19:32:43 -07:00
keycodes.md	One shot support for swap hands (#8590 )	2020-05-14 07:36:55 +10:00
keycodes_basic.md	Add OPT aliases for ALT keycodes and macros (#8714 )	2020-04-12 11:37:55 -07:00
keycodes_us_ansi_shifted.md	…
keymap.md	[Docs] Clarify layer transparency keymap.md (#9081 )	2020-05-16 00:35:19 -07:00
mod_tap.md	Add OPT aliases for ALT keycodes and macros (#8714 )	2020-04-12 11:37:55 -07:00
newbs.md	…
newbs_building_firmware.md	…
newbs_building_firmware_configurator.md	…
newbs_flashing.md	[Docs] newbs_flashing.md: place bootloader instructions before Toolbox intro (#9077 )	2020-05-21 09:24:39 -07:00
newbs_getting_started.md	CLI: Improve experience when running `qmk setup` on FreeBSD. (#8798 )	2020-05-20 08:09:13 -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	…
platformdev_chibios_earlyinit.md	Add support for hardware and board initialisation overrides. (#8330 )	2020-04-13 09:39:38 +10:00
power.txt	…
proton_c_conversion.md	Update ARM split keyboard docs (#9160 )	2020-05-22 06:20:46 +10:00
qmk.css	…
qmk_custom_dark.css	…
qmk_custom_light.css	…
quantum_keycodes.md	…
redirects.json	…
ref_functions.md	Fix a couple of typos that were causing confusion (#8767 )	2020-04-12 16:22:59 +10:00
reference_configurator_support.md	…
reference_glossary.md	Remove Atmel FLIP from install scripts and documentation (#8822 )	2020-04-17 09:50:58 +02:00
reference_info_json.md	…
serial_driver.md	Update ARM split keyboard docs (#9160 )	2020-05-22 06:20:46 +10:00
spi_driver.md	Add SPI master for ChibiOS/ARM. (#8779 )	2020-04-29 14:01:20 +10:00
support.md	…
sw.js	…
syllabus.md	[Docs] Fixed minor typos (#8860 )	2020-04-19 23:04:26 +01:00
tap_hold.md	[Docs] Fixed minor typos (#8860 )	2020-04-19 23:04:26 +01:00
translating.md	…
understanding_qmk.md	…
unit_testing.md	Edit Unit Testing Documentation (#8961 )	2020-04-29 07:39:08 +10: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