qmk-firmware/docs/feature_command.md

5.0 KiB

Command (Formerly known as Magic)

Command is a way to change your keyboard's behavior without having to flash or unplug it to use Bootmagic. There is a lot of overlap between this functionality and the Bootmagic Keycodes. Whenever possible we encourage you to use that functionality instead of Command.

Enabling Command

By default Command is disabled. You can enable it in your rules.mk file:

COMMAND_ENABLE = yes

Usage

To use Command you hold down the key combination defined by IS_COMMAND. By default that combination is both shift keys. While holding the key combination press the key corresponding to the command you want.

For example, to write the current QMK version to the QMK Toolbox console, you can press Left Shift+Right Shift+V.

Configuration

The following values can be defined in config.h to control the behavior of Command.

Define Default Description
IS_COMMAND() `(keyboard_report->mods == (MOD_BIT(KC_LSHIFT) MOD_BIT(KC_RSHIFT)))`
MAGIC_KEY_SWITCH_LAYER_WITH_FKEYS true Do layer switching with Function row
MAGIC_KEY_SWITCH_LAYER_WITH_NKEYS true Do layer switching with number keys.
MAGIC_KEY_SWITCH_LAYER_WITH_CUSTOM false Do layer switching with custom keys (MAGIC_KEY_LAYER0..9 below.)
MAGIC_KEY_HELP1 H Show help.
MAGIC_KEY_HELP2 SLASH Show help.
MAGIC_KEY_DEBUG D Turn on debug mode.
MAGIC_KEY_DEBUG_MATRIX X Turn on matrix debugging.
MAGIC_KEY_DEBUG_KBD K Turn on keyboard debugging.
MAGIC_KEY_DEBUG_MOUSE M Turn on mouse debugging.
MAGIC_KEY_VERSION V Write the QMK version to the console
MAGIC_KEY_STATUS S Show the current keyboard status
MAGIC_KEY_CONSOLE C Enable the Command Console
MAGIC_KEY_LAYER0_ALT1 ESC Alternate access to layer 0
MAGIC_KEY_LAYER0_ALT2 GRAVE Alternate access to layer 0
MAGIC_KEY_LAYER0 0 Change default layer to 0
MAGIC_KEY_LAYER1 1 Change default layer to 1
MAGIC_KEY_LAYER2 2 Change default layer to 2
MAGIC_KEY_LAYER3 3 Change default layer to 3
MAGIC_KEY_LAYER4 4 Change default layer to 4
MAGIC_KEY_LAYER5 5 Change default layer to 5
MAGIC_KEY_LAYER6 6 Change default layer to 6
MAGIC_KEY_LAYER7 7 Change default layer to 7
MAGIC_KEY_LAYER8 8 Change default layer to 8
MAGIC_KEY_LAYER9 9 Change default layer to 9
MAGIC_KEY_BOOTLOADER PAUSE Exit keyboard and enter bootloader
MAGIC_KEY_LOCK CAPS Lock the keyboard so nothing can be typed
MAGIC_KEY_EEPROM E Erase EEPROM settings
MAGIC_KEY_NKRO N Toggle NKRO on/off
MAGIC_KEY_SLEEP_LED Z Toggle LED when computer is sleeping on/off