Basic Keycodes

The basic set of keycodes are based on the HID Keyboard/Keypad Usage Page (0x07) with the exception of KC_NO, KC_TRNS and keycodes in the 0xA5-DF range. See below for more details.

Letters and Numbers

Key	Description
`KC_A`	`a` and `A`
`KC_B`	`b` and `B`
`KC_C`	`c` and `C`
`KC_D`	`d` and `D`
`KC_E`	`e` and `E`
`KC_F`	`f` and `F`
`KC_G`	`g` and `G`
`KC_H`	`h` and `H`
`KC_I`	`i` and `I`
`KC_J`	`j` and `J`
`KC_K`	`k` and `K`
`KC_L`	`l` and `L`
`KC_M`	`m` and `M`
`KC_N`	`n` and `N`
`KC_O`	`o` and `O`
`KC_P`	`p` and `P`
`KC_Q`	`q` and `Q`
`KC_R`	`r` and `R`
`KC_S`	`s` and `S`
`KC_T`	`t` and `T`
`KC_U`	`u` and `U`
`KC_V`	`v` and `V`
`KC_W`	`w` and `W`
`KC_X`	`x` and `X`
`KC_Y`	`y` and `Y`
`KC_Z`	`z` and `Z`
`KC_1`	`1` and `!`
`KC_2`	`2` and `@`
`KC_3`	`3` and `#`
`KC_4`	`4` and `$`
`KC_5`	`5` and `%`
`KC_6`	`6` and `^`
`KC_7`	`7` and `&`
`KC_8`	`8` and `*`
`KC_9`	`9` and `(`
`KC_0`	`0` and `)`

F Keys

Key	Description
`KC_F1`	F1
`KC_F2`	F2
`KC_F3`	F3
`KC_F4`	F4
`KC_F5`	F5
`KC_F6`	F6
`KC_F7`	F7
`KC_F8`	F8
`KC_F9`	F9
`KC_F10`	F10
`KC_F11`	F11
`KC_F12`	F12
`KC_F13`	F13
`KC_F14`	F14
`KC_F15`	F15
`KC_F16`	F16
`KC_F17`	F17
`KC_F18`	F18
`KC_F19`	F19
`KC_F20`	F20
`KC_F21`	F21
`KC_F22`	F22
`KC_F23`	F23
`KC_F24`	F24

Punctuation

Key	Aliases	Description
`KC_ENTER`	`KC_ENT`	Return (Enter)
`KC_ESCAPE`	`KC_ESC`	Escape
`KC_BACKSPACE`	`KC_BSPC`	Delete (Backspace)
`KC_TAB`		Tab
`KC_SPACE`	`KC_SPC`	Spacebar
`KC_MINUS`	`KC_MINS`	`-` and `_`
`KC_EQUAL`	`KC_EQL`	`=` and `+`
`KC_LEFT_BRACKET`	`KC_LBRC`	`[` and `{`
`KC_RIGHT_BRACKET`	`KC_RBRC`	`]` and `}`
`KC_BACKSLASH`	`KC_BSLS`	`\` and `\\|`
`KC_NONUS_HASH`	`KC_NUHS`	Non-US `#` and `~`
`KC_SEMICOLON`	`KC_SCLN`	`;` and `:`
`KC_QUOTE`	`KC_QUOT`	`'` and `"`
`KC_GRAVE`	`KC_GRV`	` and `~`
`KC_COMMA`	`KC_COMM`	`,` and `<`
`KC_DOT`		`.` and `>`
`KC_SLASH`	`KC_SLSH`	`/` and `?`
`KC_NONUS_BACKSLASH`	`KC_NUBS`	Non-US `\` and `\\|`

Lock Keys

Key	Aliases	Description
`KC_CAPS_LOCK`	`KC_CAPS`	Caps Lock
`KC_SCROLL_LOCK`	`KC_SCRL`, `KC_BRMD`	Scroll Lock, Brightness Down (macOS)
`KC_NUM_LOCK`	`KC_NUM`	Keypad Num Lock and Clear
`KC_LOCKING_CAPS_LOCK`	`KC_LCAP`	Locking Caps Lock
`KC_LOCKING_NUM_LOCK`	`KC_LNUM`	Locking Num Lock
`KC_LOCKING_SCROLL_LOCK`	`KC_LSCR`	Locking Scroll Lock

Modifiers

Key	Aliases	Description
`KC_LEFT_CTRL`	`KC_LCTL`	Left Control
`KC_LEFT_SHIFT`	`KC_LSFT`	Left Shift
`KC_LEFT_ALT`	`KC_LALT`, `KC_LOPT`	Left Alt (Option)
`KC_LEFT_GUI`	`KC_LGUI`, `KC_LCMD`, `KC_LWIN`	Left GUI (Windows/Command/Meta key)
`KC_RIGHT_CTRL`	`KC_RCTL`	Right Control
`KC_RIGHT_SHIFT`	`KC_RSFT`	Right Shift
`KC_RIGHT_ALT`	`KC_RALT`, `KC_ROPT`, `KC_ALGR`	Right Alt (Option/AltGr)
`KC_RIGHT_GUI`	`KC_RGUI`, `KC_RCMD`, `KC_RWIN`	Right GUI (Windows/Command/Meta key)

International

Key	Aliases	Description
`KC_INTERNATIONAL_1`	`KC_INT1`	JIS `\` and `_`
`KC_INTERNATIONAL_2`	`KC_INT2`	JIS Katakana/Hiragana
`KC_INTERNATIONAL_3`	`KC_INT3`	JIS `¥` and `\\|`
`KC_INTERNATIONAL_4`	`KC_INT4`	JIS Henkan
`KC_INTERNATIONAL_5`	`KC_INT5`	JIS Muhenkan
`KC_INTERNATIONAL_6`	`KC_INT6`	JIS Numpad `,`
`KC_INTERNATIONAL_7`	`KC_INT7`	International 7
`KC_INTERNATIONAL_8`	`KC_INT8`	International 8
`KC_INTERNATIONAL_9`	`KC_INT9`	International 9
`KC_LANGUAGE_1`	`KC_LNG1`	Hangul/English
`KC_LANGUAGE_2`	`KC_LNG2`	Hanja
`KC_LANGUAGE_3`	`KC_LNG3`	JIS Katakana
`KC_LANGUAGE_4`	`KC_LNG4`	JIS Hiragana
`KC_LANGUAGE_5`	`KC_LNG5`	JIS Zenkaku/Hankaku
`KC_LANGUAGE_6`	`KC_LNG6`	Language 6
`KC_LANGUAGE_7`	`KC_LNG7`	Language 7
`KC_LANGUAGE_8`	`KC_LNG8`	Language 8
`KC_LANGUAGE_9`	`KC_LNG9`	Language 9

Commands

Key	Aliases	Description
`KC_PRINT_SCREEN`	`KC_PSCR`	Print Screen
`KC_PAUSE`	`KC_PAUS`, `KC_BRK`, `KC_BRMU`	Pause, Brightness Up (macOS)
`KC_INSERT`	`KC_INS`	Insert
`KC_HOME`		Home
`KC_PAGE_UP`	`KC_PGUP`	Page Up
`KC_DELETE`	`KC_DEL`	Forward Delete
`KC_END`		End
`KC_PAGE_DOWN`	`KC_PGDN`	Page Down
`KC_RIGHT`	`KC_RGHT`	Right Arrow
`KC_LEFT`		Left Arrow
`KC_DOWN`		Down Arrow
`KC_UP`		Up Arrow
`KC_APPLICATION`	`KC_APP`	Application (Windows Context Menu Key)
`KC_KB_POWER`		System Power
`KC_EXECUTE`	`KC_EXEC`	Execute
`KC_HELP`		Help
`KC_MENU`		Menu
`KC_SELECT`	`KC_SLCT`	Select
`KC_STOP`		Stop
`KC_AGAIN`	`KC_AGIN`	Again
`KC_UNDO`		Undo
`KC_CUT`		Cut
`KC_COPY`		Copy
`KC_PASTE`	`KC_PSTE`	Paste
`KC_FIND`		Find
`KC_KB_MUTE`		Mute
`KC_KB_VOLUME_UP`		Volume Up
`KC_KB_VOLUME_DOWN`		Volume Down
`KC_ALTERNATE_ERASE`	`KC_ERAS`	Alternate Erase
`KC_SYSTEM_REQUEST`	`KC_SYRQ`	SysReq/Attention
`KC_CANCEL`	`KC_CNCL`	Cancel
`KC_CLEAR`	`KC_CLR`	Clear
`KC_PRIOR`	`KC_PRIR`	Prior
`KC_RETURN`	`KC_RETN`	Return
`KC_SEPARATOR`	`KC_SEPR`	Separator
`KC_OUT`		Out
`KC_OPER`		Oper
`KC_CLEAR_AGAIN`	`KC_CLAG`	Clear/Again
`KC_CRSEL`	`KC_CRSL`	CrSel/Props
`KC_EXSEL`	`KC_EXSL`	ExSel

Media Keys

These keycodes are not part of the Keyboard/Keypad usage page. The SYSTEM_ keycodes are found in the Generic Desktop page, and the rest are located in the Consumer page.

tip

Some of these keycodes may behave differently depending on the OS. For example, on macOS, the keycodes KC_MEDIA_FAST_FORWARD, KC_MEDIA_REWIND, KC_MEDIA_NEXT_TRACK and KC_MEDIA_PREV_TRACK skip within the current track when held, but skip the entire track when tapped.

Key	Aliases	Description
`KC_SYSTEM_POWER`	`KC_PWR`	System Power Down
`KC_SYSTEM_SLEEP`	`KC_SLEP`	System Sleep
`KC_SYSTEM_WAKE`	`KC_WAKE`	System Wake
`KC_AUDIO_MUTE`	`KC_MUTE`	Mute
`KC_AUDIO_VOL_UP`	`KC_VOLU`	Volume Up
`KC_AUDIO_VOL_DOWN`	`KC_VOLD`	Volume Down
`KC_MEDIA_NEXT_TRACK`	`KC_MNXT`	Next Track
`KC_MEDIA_PREV_TRACK`	`KC_MPRV`	Previous Track
`KC_MEDIA_STOP`	`KC_MSTP`	Stop Track
`KC_MEDIA_PLAY_PAUSE`	`KC_MPLY`	Play/Pause Track
`KC_MEDIA_SELECT`	`KC_MSEL`	Launch Media Player
`KC_MEDIA_EJECT`	`KC_EJCT`	Eject
`KC_MAIL`		Launch Mail
`KC_CALCULATOR`	`KC_CALC`	Launch Calculator
`KC_MY_COMPUTER`	`KC_MYCM`	Launch My Computer
`KC_WWW_SEARCH`	`KC_WSCH`	Browser Search
`KC_WWW_HOME`	`KC_WHOM`	Browser Home
`KC_WWW_BACK`	`KC_WBAK`	Browser Back
`KC_WWW_FORWARD`	`KC_WFWD`	Browser Forward
`KC_WWW_STOP`	`KC_WSTP`	Browser Stop
`KC_WWW_REFRESH`	`KC_WREF`	Browser Refresh
`KC_WWW_FAVORITES`	`KC_WFAV`	Browser Favorites
`KC_MEDIA_FAST_FORWARD`	`KC_MFFD`	Next Track
`KC_MEDIA_REWIND`	`KC_MRWD`	Previous Track
`KC_BRIGHTNESS_UP`	`KC_BRIU`	Brightness Up
`KC_BRIGHTNESS_DOWN`	`KC_BRID`	Brightness Down
`KC_CONTROL_PANEL`	`KC_CPNL`	Open Control Panel
`KC_ASSISTANT`	`KC_ASST`	Launch Assistant
`KC_MISSION_CONTROL`	`KC_MCTL`	Open Mission Control
`KC_LAUNCHPAD`	`KC_LPAD`	Open Launchpad

Number Pad

Key	Aliases	Description
`KC_KP_SLASH`	`KC_PSLS`	Keypad `/`
`KC_KP_ASTERISK`	`KC_PAST`	Keypad `*`
`KC_KP_MINUS`	`KC_PMNS`	Keypad `-`
`KC_KP_PLUS`	`KC_PPLS`	Keypad `+`
`KC_KP_ENTER`	`KC_PENT`	Keypad Enter
`KC_KP_1`	`KC_P1`	Keypad `1` and End
`KC_KP_2`	`KC_P2`	Keypad `2` and Down Arrow
`KC_KP_3`	`KC_P3`	Keypad `3` and Page Down
`KC_KP_4`	`KC_P4`	Keypad `4` and Left Arrow
`KC_KP_5`	`KC_P5`	Keypad `5`
`KC_KP_6`	`KC_P6`	Keypad `6` and Right Arrow
`KC_KP_7`	`KC_P7`	Keypad `7` and Home
`KC_KP_8`	`KC_P8`	Keypad `8` and Up Arrow
`KC_KP_9`	`KC_P9`	Keypad `9` and Page Up
`KC_KP_0`	`KC_P0`	Keypad `0` and Insert
`KC_KP_DOT`	`KC_PDOT`	Keypad `.` and Delete
`KC_KP_EQUAL`	`KC_PEQL`	Keypad `=`
`KC_KP_COMMA`	`KC_PCMM`	Keypad `,`
`KC_KP_EQUAL_AS400`		Keypad `=` on AS/400 keyboards

Special Keys

In addition to these, keycodes in the range of 0xA5-DF are reserved for internal use.

Key	Aliases	Description
`KC_NO`	`XXXXXXX`	Ignore this key (NOOP)
`KC_TRANSPARENT`	`KC_TRNS`, `_______`	Use the next lowest non-transparent key

Basic Keycodes

Letters and Numbers​

F Keys​

Punctuation​

Lock Keys​

Modifiers​

International​

Commands​

Media Keys​

Number Pad​

Special Keys​