qmk_firmware/docs/feature_grave_esc.md

1.0 KiB

Grave Escape

Grave Escape is a feature that allows you to share the grave key (` and ~) on the same key as Escape. When KC_GESC is used it will act as KC_ESC, unless Shift or GUI is pressed, in which case it will act as KC_GRAVE.

Key Aliases Description
KC_GESC GRAVE_ESC Escape when pressed, ` when Shift or GUI are held

There are several possible key combinations this will break, among them Ctrl+Shift+Esc on Windows and Cmd+Opt+Esc on macOS. You can use these options in your config.h to work around this:

Option Description
GRAVE_ESC_ALT_OVERRIDE Always send Escape if Alt is pressed.
GRAVE_ESC_CTRL_OVERRIDE Always send Escape if Ctrl is pressed.
GRAVE_ESC_GUI_OVERRIDE Always send Escape if GUI is pressed.
GRAVE_ESC_SHIFT_OVERRIDE Always send Escape if SHIFT is pressed.