Skip to content

Magic Keycodes

Magic Keycodes are prefixed with MAGIC_, and allow you to access the functionality of the deprecated Bootmagic feature after your keyboard has initialized. To use the keycodes, assign them to your keymap as you would any other keycode.

KeyAliasesDescription
QK_MAGIC_SWAP_CONTROL_CAPS_LOCKCL_SWAPSwap Caps Lock and Left Control
QK_MAGIC_UNSWAP_CONTROL_CAPS_LOCKCL_NORMUnswap Caps Lock and Left Control
QK_MAGIC_TOGGLE_CONTROL_CAPS_LOCKCL_TOGGToggle Caps Lock and Left Control swap
QK_MAGIC_CAPS_LOCK_AS_CONTROL_ONCL_CTRLTreat Caps Lock as Control
QK_MAGIC_CAPS_LOCK_AS_CONTROL_OFFCL_CAPSStop treating Caps Lock as Control
QK_MAGIC_SWAP_ESCAPE_CAPS_LOCKEC_SWAPSwap Caps Lock and Escape
QK_MAGIC_UNSWAP_ESCAPE_CAPS_LOCKEC_NORMUnswap Caps Lock and Escape
QK_MAGIC_TOGGLE_ESCAPE_CAPS_LOCKEC_TOGGToggle Caps Lock and Escape swap
QK_MAGIC_SWAP_LCTL_LGUICG_LSWPSwap Left Control and GUI
QK_MAGIC_UNSWAP_LCTL_LGUICG_LNRMUnswap Left Control and GUI
QK_MAGIC_SWAP_RCTL_RGUICG_RSWPSwap Right Control and GUI
QK_MAGIC_UNSWAP_RCTL_RGUICG_RNRMUnswap Right Control and GUI
QK_MAGIC_SWAP_CTL_GUICG_SWAPSwap Control and GUI on both sides
QK_MAGIC_UNSWAP_CTL_GUICG_NORMUnswap Control and GUI on both sides
QK_MAGIC_TOGGLE_CTL_GUICG_TOGGToggle Control and GUI swap on both sides
QK_MAGIC_SWAP_LALT_LGUIAG_LSWPSwap Left Alt and GUI
QK_MAGIC_UNSWAP_LALT_LGUIAG_LNRMUnswap Left Alt and GUI
QK_MAGIC_SWAP_RALT_RGUIAG_RSWPSwap Right Alt and GUI
QK_MAGIC_UNSWAP_RALT_RGUIAG_RNRMUnswap Right Alt and GUI
QK_MAGIC_SWAP_ALT_GUIAG_SWAPSwap Alt and GUI on both sides
QK_MAGIC_UNSWAP_ALT_GUIAG_NORMUnswap Alt and GUI on both sides
QK_MAGIC_TOGGLE_ALT_GUIAG_TOGGToggle Alt and GUI swap on both sides
QK_MAGIC_GUI_OFFGU_OFFDisable the GUI keys
QK_MAGIC_GUI_ONGU_ONEnable the GUI keys
QK_MAGIC_TOGGLE_GUIGU_TOGGToggles the status of the GUI keys
QK_MAGIC_SWAP_GRAVE_ESCGE_SWAPSwap ` and Escape
QK_MAGIC_UNSWAP_GRAVE_ESCGE_NORMUnswap ` and Escape
QK_MAGIC_SWAP_BACKSLASH_BACKSPACEBS_SWAPSwap \ and Backspace
QK_MAGIC_UNSWAP_BACKSLASH_BACKSPACEBS_NORMUnswap \ and Backspace
QK_MAGIC_TOGGLE_BACKSLASH_BACKSPACEBS_TOGGToggle \ and Backspace swap state
QK_MAGIC_NKRO_ONNK_ONEnable N-key rollover
QK_MAGIC_NKRO_OFFNK_OFFDisable N-key rollover
QK_MAGIC_TOGGLE_NKRONK_TOGGToggle N-key rollover
QK_MAGIC_EE_HANDS_LEFTEH_LEFTSet the master half of a split keyboard as the left hand (for EE_HANDS)
QK_MAGIC_EE_HANDS_RIGHTEH_RGHTSet the master half of a split keyboard as the right hand (for EE_HANDS)