Relocate grave keycode processing (#8082)
[jackhill/qmk/firmware.git] / quantum / quantum_keycodes.h
CommitLineData
23839b8c 1/* Copyright 2016-2017 Jack Humbert
2 *
3 * This program is free software: you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation, either version 2 of the License, or
6 * (at your option) any later version.
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License
14 * along with this program. If not, see <http://www.gnu.org/licenses/>.
15 */
d8a608f3
W
16#ifndef QUANTUM_KEYCODES_H
17#define QUANTUM_KEYCODES_H
18
a64ae106 19#ifndef MIDI_ENABLE_STRICT
b624f32f 20# define MIDI_ENABLE_STRICT 0
a64ae106
GY
21#endif
22
23#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_ADVANCED))
b624f32f 24# ifndef MIDI_TONE_KEYCODE_OCTAVES
25# define MIDI_TONE_KEYCODE_OCTAVES 3
26# endif
d1fe24ad
GY
27#endif
28
6a3c6677
JH
29// Fillers to make layering more clear
30#define _______ KC_TRNS
31#define XXXXXXX KC_NO
32
d8a608f3 33enum quantum_keycodes {
2a534e87 34 // Ranges used in shortcuts - not to be used directly
b624f32f 35 QK_BASIC = 0x0000,
36 QK_BASIC_MAX = 0x00FF,
37 QK_MODS = 0x0100,
38 QK_LCTL = 0x0100,
39 QK_LSFT = 0x0200,
40 QK_LALT = 0x0400,
41 QK_LGUI = 0x0800,
42 QK_RMODS_MIN = 0x1000,
43 QK_RCTL = 0x1100,
44 QK_RSFT = 0x1200,
45 QK_RALT = 0x1400,
46 QK_RGUI = 0x1800,
47 QK_MODS_MAX = 0x1FFF,
48 QK_FUNCTION = 0x2000,
49 QK_FUNCTION_MAX = 0x2FFF,
50 QK_MACRO = 0x3000,
51 QK_MACRO_MAX = 0x3FFF,
52 QK_LAYER_TAP = 0x4000,
53 QK_LAYER_TAP_MAX = 0x4FFF,
54 QK_TO = 0x5000,
55 QK_TO_MAX = 0x50FF,
56 QK_MOMENTARY = 0x5100,
57 QK_MOMENTARY_MAX = 0x51FF,
58 QK_DEF_LAYER = 0x5200,
59 QK_DEF_LAYER_MAX = 0x52FF,
60 QK_TOGGLE_LAYER = 0x5300,
61 QK_TOGGLE_LAYER_MAX = 0x53FF,
62 QK_ONE_SHOT_LAYER = 0x5400,
63 QK_ONE_SHOT_LAYER_MAX = 0x54FF,
64 QK_ONE_SHOT_MOD = 0x5500,
65 QK_ONE_SHOT_MOD_MAX = 0x55FF,
66 QK_TAP_DANCE = 0x5700,
67 QK_TAP_DANCE_MAX = 0x57FF,
68 QK_LAYER_TAP_TOGGLE = 0x5800,
69ea10f9 69 QK_LAYER_TAP_TOGGLE_MAX = 0x58FF,
b624f32f 70 QK_LAYER_MOD = 0x5900,
71 QK_LAYER_MOD_MAX = 0x59FF,
5987f679 72#ifdef STENO_ENABLE
b624f32f 73 QK_STENO = 0x5A00,
74 QK_STENO_BOLT = 0x5A30,
75 QK_STENO_GEMINI = 0x5A31,
76 QK_STENO_MAX = 0x5A3F,
23ac2a02
JW
77#endif
78#ifdef SWAP_HANDS_ENABLE
b624f32f 79 QK_SWAP_HANDS = 0x5B00,
80 QK_SWAP_HANDS_MAX = 0x5BFF,
5987f679 81#endif
b624f32f 82 QK_MOD_TAP = 0x6000,
83 QK_MOD_TAP_MAX = 0x7FFF,
d8a608f3 84#ifdef UNICODE_ENABLE
b624f32f 85 QK_UNICODE = 0x8000,
86 QK_UNICODE_MAX = 0xFFFF,
d8a608f3 87#endif
69ea10f9 88#ifdef UNICODEMAP_ENABLE
b624f32f 89 QK_UNICODEMAP = 0x8000,
90 QK_UNICODEMAP_MAX = 0xBFFF,
91 QK_UNICODEMAP_PAIR = 0xC000,
bdc8d89e 92 QK_UNICODEMAP_PAIR_MAX = 0xFFFF,
69ea10f9 93#endif
d8a608f3
W
94
95 // Loose keycodes - to be used directly
96
b92515f1 97 RESET = 0x5C00,
d8a608f3
W
98 DEBUG,
99 MAGIC_SWAP_CONTROL_CAPSLOCK,
100 MAGIC_CAPSLOCK_TO_CONTROL,
101 MAGIC_SWAP_LALT_LGUI,
102 MAGIC_SWAP_RALT_RGUI,
103 MAGIC_NO_GUI,
104 MAGIC_SWAP_GRAVE_ESC,
105 MAGIC_SWAP_BACKSLASH_BACKSPACE,
106 MAGIC_HOST_NKRO,
107 MAGIC_SWAP_ALT_GUI,
108 MAGIC_UNSWAP_CONTROL_CAPSLOCK,
109 MAGIC_UNCAPSLOCK_TO_CONTROL,
110 MAGIC_UNSWAP_LALT_LGUI,
111 MAGIC_UNSWAP_RALT_RGUI,
112 MAGIC_UNNO_GUI,
113 MAGIC_UNSWAP_GRAVE_ESC,
114 MAGIC_UNSWAP_BACKSLASH_BACKSPACE,
115 MAGIC_UNHOST_NKRO,
116 MAGIC_UNSWAP_ALT_GUI,
117 MAGIC_TOGGLE_NKRO,
a6d1db2c 118 MAGIC_TOGGLE_ALT_GUI,
98316ef0 119 GRAVE_ESC,
d8a608f3 120
b624f32f 121// Leader key
74344947 122#ifdef LEADER_ENABLE
d8a608f3
W
123 KC_LEAD,
124#endif
125
abba393f
JC
126 // Auto Shift setup
127 KC_ASUP,
128 KC_ASDN,
129 KC_ASRP,
a1fa70f9 130 KC_ASTG,
4f484bc1
DJ
131 KC_ASON,
132 KC_ASOFF,
abba393f 133
d8a608f3
W
134 // Audio on/off/toggle
135 AU_ON,
136 AU_OFF,
137 AU_TOG,
138
8b0b17a3
DJ
139 // Faux clicky as part of main audio feature
140 CLICKY_TOGGLE,
a0309db9
DJ
141 CLICKY_ENABLE,
142 CLICKY_DISABLE,
8b0b17a3
DJ
143 CLICKY_UP,
144 CLICKY_DOWN,
145 CLICKY_RESET,
146
8c93c5d9
PIN
147#ifdef FAUXCLICKY_ENABLE
148 // Faux clicky
149 FC_ON,
150 FC_OFF,
151 FC_TOG,
152#endif
153
d8a608f3
W
154 // Music mode on/off/toggle
155 MU_ON,
156 MU_OFF,
157 MU_TOG,
158
415d38ba
JH
159 // Music mode cycle
160 MU_MOD,
161
d8a608f3
W
162 // Music voice iterate
163 MUV_IN,
164 MUV_DE,
165
b624f32f 166// Midi
a64ae106 167#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_BASIC))
a7c61f29
JH
168 MI_ON,
169 MI_OFF,
170 MI_TOG,
525be99e
GY
171#endif
172
a64ae106 173#if !MIDI_ENABLE_STRICT || (defined(MIDI_ENABLE) && defined(MIDI_ADVANCED))
5ae1411f
GY
174 MIDI_TONE_MIN,
175
b624f32f 176# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 0
5ae1411f
GY
177 MI_C = MIDI_TONE_MIN,
178 MI_Cs,
179 MI_Db = MI_Cs,
180 MI_D,
181 MI_Ds,
182 MI_Eb = MI_Ds,
183 MI_E,
184 MI_F,
185 MI_Fs,
186 MI_Gb = MI_Fs,
187 MI_G,
188 MI_Gs,
189 MI_Ab = MI_Gs,
190 MI_A,
191 MI_As,
192 MI_Bb = MI_As,
193 MI_B,
b624f32f 194# endif
5ae1411f 195
b624f32f 196# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 1
5ae1411f
GY
197 MI_C_1,
198 MI_Cs_1,
199 MI_Db_1 = MI_Cs_1,
200 MI_D_1,
201 MI_Ds_1,
202 MI_Eb_1 = MI_Ds_1,
203 MI_E_1,
204 MI_F_1,
205 MI_Fs_1,
206 MI_Gb_1 = MI_Fs_1,
207 MI_G_1,
208 MI_Gs_1,
209 MI_Ab_1 = MI_Gs_1,
210 MI_A_1,
211 MI_As_1,
212 MI_Bb_1 = MI_As_1,
213 MI_B_1,
b624f32f 214# endif
5ae1411f 215
b624f32f 216# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 2
5ae1411f
GY
217 MI_C_2,
218 MI_Cs_2,
219 MI_Db_2 = MI_Cs_2,
220 MI_D_2,
221 MI_Ds_2,
222 MI_Eb_2 = MI_Ds_2,
223 MI_E_2,
224 MI_F_2,
225 MI_Fs_2,
226 MI_Gb_2 = MI_Fs_2,
227 MI_G_2,
228 MI_Gs_2,
229 MI_Ab_2 = MI_Gs_2,
230 MI_A_2,
231 MI_As_2,
232 MI_Bb_2 = MI_As_2,
233 MI_B_2,
b624f32f 234# endif
5ae1411f 235
b624f32f 236# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 3
d1fe24ad
GY
237 MI_C_3,
238 MI_Cs_3,
239 MI_Db_3 = MI_Cs_3,
240 MI_D_3,
241 MI_Ds_3,
242 MI_Eb_3 = MI_Ds_3,
243 MI_E_3,
244 MI_F_3,
245 MI_Fs_3,
246 MI_Gb_3 = MI_Fs_3,
247 MI_G_3,
248 MI_Gs_3,
249 MI_Ab_3 = MI_Gs_3,
250 MI_A_3,
251 MI_As_3,
252 MI_Bb_3 = MI_As_3,
253 MI_B_3,
b624f32f 254# endif
d1fe24ad 255
b624f32f 256# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 4
d1fe24ad
GY
257 MI_C_4,
258 MI_Cs_4,
259 MI_Db_4 = MI_Cs_4,
260 MI_D_4,
261 MI_Ds_4,
262 MI_Eb_4 = MI_Ds_4,
263 MI_E_4,
264 MI_F_4,
265 MI_Fs_4,
266 MI_Gb_4 = MI_Fs_4,
267 MI_G_4,
268 MI_Gs_4,
269 MI_Ab_4 = MI_Gs_4,
270 MI_A_4,
271 MI_As_4,
272 MI_Bb_4 = MI_As_4,
273 MI_B_4,
b624f32f 274# endif
d1fe24ad 275
b624f32f 276# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 5
d1fe24ad
GY
277 MI_C_5,
278 MI_Cs_5,
279 MI_Db_5 = MI_Cs_5,
280 MI_D_5,
281 MI_Ds_5,
282 MI_Eb_5 = MI_Ds_5,
283 MI_E_5,
284 MI_F_5,
285 MI_Fs_5,
286 MI_Gb_5 = MI_Fs_5,
287 MI_G_5,
288 MI_Gs_5,
289 MI_Ab_5 = MI_Gs_5,
290 MI_A_5,
291 MI_As_5,
292 MI_Bb_5 = MI_As_5,
293 MI_B_5,
b624f32f 294# endif
d1fe24ad 295
b624f32f 296# if !MIDI_ENABLE_STRICT || MIDI_TONE_KEYCODE_OCTAVES > 5
d1fe24ad 297 MIDI_TONE_MAX = MI_B_5,
b624f32f 298# elif MIDI_TONE_KEYCODE_OCTAVES > 4
d1fe24ad 299 MIDI_TONE_MAX = MI_B_4,
b624f32f 300# elif MIDI_TONE_KEYCODE_OCTAVES > 3
d1fe24ad 301 MIDI_TONE_MAX = MI_B_3,
b624f32f 302# elif MIDI_TONE_KEYCODE_OCTAVES > 2
5ae1411f 303 MIDI_TONE_MAX = MI_B_2,
b624f32f 304# elif MIDI_TONE_KEYCODE_OCTAVES > 1
d1fe24ad 305 MIDI_TONE_MAX = MI_B_1,
b624f32f 306# elif MIDI_TONE_KEYCODE_OCTAVES > 0
d1fe24ad 307 MIDI_TONE_MAX = MI_B,
b624f32f 308# endif
5ae1411f
GY
309
310 MIDI_OCTAVE_MIN,
311 MI_OCT_N2 = MIDI_OCTAVE_MIN,
312 MI_OCT_N1,
313 MI_OCT_0,
314 MI_OCT_1,
315 MI_OCT_2,
316 MI_OCT_3,
317 MI_OCT_4,
318 MI_OCT_5,
319 MI_OCT_6,
320 MI_OCT_7,
321 MIDI_OCTAVE_MAX = MI_OCT_7,
b624f32f 322 MI_OCTD, // octave down
323 MI_OCTU, // octave up
5ae1411f 324
5e6097f0
GY
325 MIDI_TRANSPOSE_MIN,
326 MI_TRNS_N6 = MIDI_TRANSPOSE_MIN,
327 MI_TRNS_N5,
328 MI_TRNS_N4,
329 MI_TRNS_N3,
330 MI_TRNS_N2,
331 MI_TRNS_N1,
332 MI_TRNS_0,
333 MI_TRNS_1,
334 MI_TRNS_2,
335 MI_TRNS_3,
336 MI_TRNS_4,
337 MI_TRNS_5,
338 MI_TRNS_6,
339 MIDI_TRANSPOSE_MAX = MI_TRNS_6,
b624f32f 340 MI_TRNSD, // transpose down
341 MI_TRNSU, // transpose up
5e6097f0 342
5ae1411f
GY
343 MIDI_VELOCITY_MIN,
344 MI_VEL_1 = MIDI_VELOCITY_MIN,
345 MI_VEL_2,
346 MI_VEL_3,
e405ab4b 347 MI_VEL_4,
5ae1411f
GY
348 MI_VEL_5,
349 MI_VEL_6,
350 MI_VEL_7,
351 MI_VEL_8,
352 MI_VEL_9,
353 MI_VEL_10,
354 MIDI_VELOCITY_MAX = MI_VEL_10,
b624f32f 355 MI_VELD, // velocity down
356 MI_VELU, // velocity up
5ae1411f
GY
357
358 MIDI_CHANNEL_MIN,
359 MI_CH1 = MIDI_CHANNEL_MIN,
360 MI_CH2,
361 MI_CH3,
362 MI_CH4,
363 MI_CH5,
364 MI_CH6,
365 MI_CH7,
366 MI_CH8,
367 MI_CH9,
368 MI_CH10,
369 MI_CH11,
370 MI_CH12,
371 MI_CH13,
372 MI_CH14,
373 MI_CH15,
374 MI_CH16,
375 MIDI_CHANNEL_MAX = MI_CH16,
b624f32f 376 MI_CHD, // previous channel
377 MI_CHU, // next channel
5ae1411f 378
b624f32f 379 MI_ALLOFF, // all notes off
7c5e510f 380
b624f32f 381 MI_SUS, // sustain
382 MI_PORT, // portamento
383 MI_SOST, // sostenuto
384 MI_SOFT, // soft pedal
385 MI_LEG, // legato
dd8f8e6b 386
b624f32f 387 MI_MOD, // modulation
388 MI_MODSD, // decrease modulation speed
389 MI_MODSU, // increase modulation speed
3d3c0931 390
b624f32f 391 MI_BENDD, // Bend down
392 MI_BENDU, // Bend up
393#endif // MIDI_ADVANCED
d8a608f3
W
394
395 // Backlight functionality
4931510a
BG
396 BL_ON,
397 BL_OFF,
d8a608f3
W
398 BL_DEC,
399 BL_INC,
400 BL_TOGG,
401 BL_STEP,
4931510a 402 BL_BRTG,
d8a608f3
W
403
404 // RGB functionality
405 RGB_TOG,
53b043d4
CG
406 RGB_MODE_FORWARD,
407 RGB_MODE_REVERSE,
d8a608f3
W
408 RGB_HUI,
409 RGB_HUD,
410 RGB_SAI,
411 RGB_SAD,
412 RGB_VAI,
413 RGB_VAD,
afacd423 414 RGB_SPI,
415 RGB_SPD,
4580d3a7 416 RGB_MODE_PLAIN,
417 RGB_MODE_BREATHE,
418 RGB_MODE_RAINBOW,
419 RGB_MODE_SWIRL,
420 RGB_MODE_SNAKE,
421 RGB_MODE_KNIGHT,
422 RGB_MODE_XMAS,
423 RGB_MODE_GRADIENT,
52297346 424 RGB_MODE_RGBTEST,
d8a608f3 425
b624f32f 426 // Momentum matching toggle
c1c5922a
CL
427 VLK_TOG,
428
d8a608f3
W
429 // Left shift, open paren
430 KC_LSPO,
431
432 // Right shift, close paren
433 KC_RSPC,
434
8a1e6560
ZR
435 // Shift, Enter
436 KC_SFTENT,
437
d8a608f3
W
438 // Printing
439 PRINT_ON,
440 PRINT_OFF,
441
c17070ec
PIN
442 // output selection
443 OUT_AUTO,
444 OUT_USB,
445#ifdef BLUETOOTH_ENABLE
446 OUT_BT,
447#endif
c17070ec 448
8e1be7c7
FS
449#ifdef KEY_LOCK_ENABLE
450 KC_LOCK,
451#endif
452
d5dcf54e
453#ifdef TERMINAL_ENABLE
454 TERM_ON,
455 TERM_OFF,
456#endif
457
458 EEPROM_RESET,
459
460 UNICODE_MODE_FORWARD,
461 UNICODE_MODE_REVERSE,
462 UNICODE_MODE_OSX,
463 UNICODE_MODE_LNX,
464 UNICODE_MODE_WIN,
465 UNICODE_MODE_BSD,
466 UNICODE_MODE_WINC,
467
468 HPT_ON,
469 HPT_OFF,
470 HPT_TOG,
471 HPT_RST,
472 HPT_FBK,
473 HPT_BUZ,
474 HPT_MODI,
475 HPT_MODD,
911b8915
M
476 HPT_CONT,
477 HPT_CONI,
478 HPT_COND,
d5dcf54e
479 HPT_DWLI,
480 HPT_DWLD,
481
c745d9b8
X
482 // Left control, open paren
483 KC_LCPO,
484
485 // Right control, close paren
486 KC_RCPC,
487
488 // Left control, open paren
489 KC_LAPO,
490
491 // Right control, close paren
492 KC_RAPC,
493
c44fc682
DJ
494 CMB_ON,
495 CMB_OFF,
496 CMB_TOG,
b624f32f 497
d534c72a
SW
498 MAGIC_SWAP_LCTL_LGUI,
499 MAGIC_SWAP_RCTL_RGUI,
500 MAGIC_UNSWAP_LCTL_LGUI,
501 MAGIC_UNSWAP_RCTL_RGUI,
502 MAGIC_SWAP_CTL_GUI,
503 MAGIC_UNSWAP_CTL_GUI,
504 MAGIC_TOGGLE_CTL_GUI,
ad8dbd5c
JC
505 MAGIC_EE_HANDS_LEFT,
506 MAGIC_EE_HANDS_RIGHT,
d534c72a 507
542cb0a8
DJ
508 // Dynamic Macros
509 DYN_REC_START1,
510 DYN_REC_START2,
511 DYN_REC_STOP,
512 DYN_MACRO_PLAY1,
513 DYN_MACRO_PLAY2,
514
d5dcf54e
515 // always leave at the end
516 SAFE_RANGE
517};
d8a608f3
W
518
519// Ability to use mods in layouts
097f1a29 520#define LCTL(kc) (QK_LCTL | (kc))
521#define LSFT(kc) (QK_LSFT | (kc))
522#define LALT(kc) (QK_LALT | (kc))
523#define LGUI(kc) (QK_LGUI | (kc))
a2e12faa 524#define LCMD(kc) LGUI(kc)
525#define LWIN(kc) LGUI(kc)
097f1a29 526#define RCTL(kc) (QK_RCTL | (kc))
527#define RSFT(kc) (QK_RSFT | (kc))
528#define RALT(kc) (QK_RALT | (kc))
28fbf84c 529#define ALGR(kc) RALT(kc)
097f1a29 530#define RGUI(kc) (QK_RGUI | (kc))
a2e12faa 531#define RCMD(kc) RGUI(kc)
532#define RWIN(kc) RGUI(kc)
d8a608f3 533
097f1a29 534#define HYPR(kc) (QK_LCTL | QK_LSFT | QK_LALT | QK_LGUI | (kc))
b624f32f 535#define MEH(kc) (QK_LCTL | QK_LSFT | QK_LALT | (kc))
097f1a29 536#define LCAG(kc) (QK_LCTL | QK_LALT | QK_LGUI | (kc))
097f1a29 537#define SGUI(kc) (QK_LGUI | QK_LSFT | (kc))
e5c331e7 538#define SCMD(kc) SGUI(kc)
539#define SWIN(kc) SGUI(kc)
b624f32f 540#define LCA(kc) (QK_LCTL | QK_LALT | (kc))
d8a608f3 541
64c957d9 542#define MOD_HYPR 0xF
b624f32f 543#define MOD_MEH 0x7
d8a608f3
W
544
545// Aliases for shifted symbols
546// Each key has a 4-letter code, and some have longer aliases too.
547// While the long aliases are descriptive, the 4-letter codes
548// make for nicer grid layouts (everything lines up), and are
549// the preferred style for Quantum.
b624f32f 550#define KC_TILD LSFT(KC_GRV) // ~
551#define KC_TILDE KC_TILD
d8a608f3 552
b624f32f 553#define KC_EXLM LSFT(KC_1) // !
554#define KC_EXCLAIM KC_EXLM
d8a608f3 555
b624f32f 556#define KC_AT LSFT(KC_2) // @
d8a608f3 557
b624f32f 558#define KC_HASH LSFT(KC_3) // #
d8a608f3 559
b624f32f 560#define KC_DLR LSFT(KC_4) // $
561#define KC_DOLLAR KC_DLR
d8a608f3 562
b624f32f 563#define KC_PERC LSFT(KC_5) // %
564#define KC_PERCENT KC_PERC
d8a608f3 565
b624f32f 566#define KC_CIRC LSFT(KC_6) // ^
567#define KC_CIRCUMFLEX KC_CIRC
d8a608f3 568
b624f32f 569#define KC_AMPR LSFT(KC_7) // &
570#define KC_AMPERSAND KC_AMPR
d8a608f3 571
b624f32f 572#define KC_ASTR LSFT(KC_8) // *
d8a608f3
W
573#define KC_ASTERISK KC_ASTR
574
b624f32f 575#define KC_LPRN LSFT(KC_9) // (
576#define KC_LEFT_PAREN KC_LPRN
d8a608f3 577
b624f32f 578#define KC_RPRN LSFT(KC_0) // )
579#define KC_RIGHT_PAREN KC_RPRN
d8a608f3 580
b624f32f 581#define KC_UNDS LSFT(KC_MINS) // _
582#define KC_UNDERSCORE KC_UNDS
d8a608f3 583
b624f32f 584#define KC_PLUS LSFT(KC_EQL) // +
d8a608f3 585
b624f32f 586#define KC_LCBR LSFT(KC_LBRC) // {
d8a608f3
W
587#define KC_LEFT_CURLY_BRACE KC_LCBR
588
b624f32f 589#define KC_RCBR LSFT(KC_RBRC) // }
590#define KC_RIGHT_CURLY_BRACE KC_RCBR
d8a608f3 591
b624f32f 592#define KC_LABK LSFT(KC_COMM) // <
593#define KC_LEFT_ANGLE_BRACKET KC_LABK
d8a608f3 594
b624f32f 595#define KC_RABK LSFT(KC_DOT) // >
596#define KC_RIGHT_ANGLE_BRACKET KC_RABK
d8a608f3 597
b624f32f 598#define KC_COLN LSFT(KC_SCLN) // :
599#define KC_COLON KC_COLN
d8a608f3 600
b624f32f 601#define KC_PIPE LSFT(KC_BSLS) // |
d8a608f3 602
b624f32f 603#define KC_LT LSFT(KC_COMM) // <
d8a608f3 604
b624f32f 605#define KC_GT LSFT(KC_DOT) // >
d8a608f3 606
b624f32f 607#define KC_QUES LSFT(KC_SLSH) // ?
d8a608f3
W
608#define KC_QUESTION KC_QUES
609
b624f32f 610#define KC_DQT LSFT(KC_QUOT) // "
d8a608f3
W
611#define KC_DOUBLE_QUOTE KC_DQT
612#define KC_DQUO KC_DQT
613
b624f32f 614#define KC_DELT KC_DELETE // Del key (four letter code)
61af76a1 615
d8a608f3 616// Alias for function layers than expand past FN31
097f1a29 617#define FUNC(kc) (QK_FUNCTION | (kc))
d8a608f3
W
618
619// Aliases
79b58937 620#define C(kc) LCTL(kc)
d8a608f3 621#define S(kc) LSFT(kc)
79b58937 622#define A(kc) LALT(kc)
623#define G(kc) LGUI(kc)
d8a608f3 624
79b58937 625#define F(kc) FUNC(kc)
097f1a29 626#define M(kc) (QK_MACRO | (kc))
d8a608f3 627
097f1a29 628#define MACROTAP(kc) (QK_MACRO | (FUNC_TAP << 8) | (kc))
d8a608f3
W
629#define MACRODOWN(...) (record->event.pressed ? MACRO(__VA_ARGS__) : MACRO_NONE)
630
98316ef0 631#define KC_GESC GRAVE_ESC
632
6e44f94f
DJ
633#define EEP_RST EEPROM_RESET
634
8b0b17a3
DJ
635#define CK_TOGG CLICKY_TOGGLE
636#define CK_RST CLICKY_RESET
637#define CK_UP CLICKY_UP
638#define CK_DOWN CLICKY_DOWN
a0309db9
DJ
639#define CK_ON CLICKY_ENABLE
640#define CK_OFF CLICKY_DISABLE
8b0b17a3 641
53b043d4 642#define RGB_MOD RGB_MODE_FORWARD
53b043d4
CG
643#define RGB_RMOD RGB_MODE_REVERSE
644
4580d3a7 645#define RGB_M_P RGB_MODE_PLAIN
646#define RGB_M_B RGB_MODE_BREATHE
647#define RGB_M_R RGB_MODE_RAINBOW
648#define RGB_M_SW RGB_MODE_SWIRL
649#define RGB_M_SN RGB_MODE_SNAKE
650#define RGB_M_K RGB_MODE_KNIGHT
651#define RGB_M_X RGB_MODE_XMAS
652#define RGB_M_G RGB_MODE_GRADIENT
52297346 653#define RGB_M_T RGB_MODE_RGBTEST
a3357d07 654
d8a608f3 655// L-ayer, T-ap - 256 keycode max, 16 layer max
b624f32f 656#define LT(layer, kc) (QK_LAYER_TAP | (((layer)&0xF) << 8) | ((kc)&0xFF))
d8a608f3 657
3ad389de 658#define CL_SWAP MAGIC_SWAP_CONTROL_CAPSLOCK
659#define CL_NORM MAGIC_UNSWAP_CONTROL_CAPSLOCK
660#define CL_CTRL MAGIC_CAPSLOCK_TO_CONTROL
661#define CL_CAPS MAGIC_UNCAPSLOCK_TO_CONTROL
662
663#define LCG_SWP MAGIC_SWAP_LCTL_LGUI
664#define LCG_NRM MAGIC_UNSWAP_LCTL_LGUI
665#define RCG_SWP MAGIC_SWAP_RCTL_RGUI
666#define RCG_NRM MAGIC_UNSWAP_RCTL_RGUI
667#define CG_SWAP MAGIC_SWAP_CTL_GUI
668#define CG_NORM MAGIC_UNSWAP_CTL_GUI
669#define CG_TOGG MAGIC_TOGGLE_CTL_GUI
670
671#define LAG_SWP MAGIC_SWAP_LALT_LGUI
672#define LAG_NRM MAGIC_UNSWAP_LALT_LGUI
673#define RAG_SWP MAGIC_SWAP_RALT_RGUI
674#define RAG_NRM MAGIC_UNSWAP_RALT_RGUI
d8a608f3
W
675#define AG_SWAP MAGIC_SWAP_ALT_GUI
676#define AG_NORM MAGIC_UNSWAP_ALT_GUI
a6d1db2c 677#define AG_TOGG MAGIC_TOGGLE_ALT_GUI
d8a608f3 678
3ad389de 679#define GUI_OFF MAGIC_NO_GUI
667045b4 680#define GUI_ON MAGIC_UNNO_GUI
3ad389de 681
682#define GE_SWAP MAGIC_SWAP_GRAVE_ESC
683#define GE_NORM MAGIC_UNSWAP_GRAVE_ESC
684
685#define BS_SWAP MAGIC_SWAP_BACKSLASH_BACKSPACE
686#define BS_NORM MAGIC_UNSWAP_BACKSLASH_BACKSPACE
687
667045b4
JC
688#define NK_ON MAGIC_HOST_NKRO
689#define NK_OFF MAGIC_UNHOST_NKRO
3ad389de 690#define NK_TOGG MAGIC_TOGGLE_NKRO
691
692#define EH_LEFT MAGIC_EE_HANDS_LEFT
693#define EH_RGHT MAGIC_EE_HANDS_RIGHT
d534c72a 694
d8a608f3
W
695// GOTO layer - 16 layers max
696// when:
697// ON_PRESS = 1
698// ON_RELEASE = 2
699// Unless you have a good reason not to do so, prefer ON_PRESS (1) as your default.
700// In fact, we changed it to assume ON_PRESS for sanity/simplicity. If needed, you can add your own
701// keycode modeled after the old version, kept below for this.
097f1a29 702/* #define TO(layer, when) (QK_TO | (when << 0x4) | (layer & 0xFF)) */
b624f32f 703#define TO(layer) (QK_TO | (ON_PRESS << 0x4) | ((layer)&0xFF))
d8a608f3
W
704
705// Momentary switch layer - 256 layer max
b624f32f 706#define MO(layer) (QK_MOMENTARY | ((layer)&0xFF))
d8a608f3
W
707
708// Set default layer - 256 layer max
b624f32f 709#define DF(layer) (QK_DEF_LAYER | ((layer)&0xFF))
d8a608f3
W
710
711// Toggle to layer - 256 layer max
b624f32f 712#define TG(layer) (QK_TOGGLE_LAYER | ((layer)&0xFF))
d8a608f3
W
713
714// One-shot layer - 256 layer max
b624f32f 715#define OSL(layer) (QK_ONE_SHOT_LAYER | ((layer)&0xFF))
d8a608f3 716
7a5ce36f 717// L-ayer M-od: Momentary switch layer with modifiers active - 16 layer max, left mods only
b624f32f 718#define LM(layer, mod) (QK_LAYER_MOD | (((layer)&0xF) << 4) | ((mod)&0xF))
7a5ce36f 719
d8a608f3 720// One-shot mod
b624f32f 721#define OSM(mod) (QK_ONE_SHOT_MOD | ((mod)&0xFF))
d8a608f3 722
69ea10f9 723// Layer tap-toggle
b624f32f 724#define TT(layer) (QK_LAYER_TAP_TOGGLE | ((layer)&0xFF))
69ea10f9 725
d8a608f3 726// M-od, T-ap - 256 keycode max
b624f32f 727#define MT(mod, kc) (QK_MOD_TAP | (((mod)&0x1F) << 8) | ((kc)&0xFF))
97816df7 728
97816df7
PIN
729#define LCTL_T(kc) MT(MOD_LCTL, kc)
730#define RCTL_T(kc) MT(MOD_RCTL, kc)
b624f32f 731#define CTL_T(kc) LCTL_T(kc)
97816df7 732
97816df7
PIN
733#define LSFT_T(kc) MT(MOD_LSFT, kc)
734#define RSFT_T(kc) MT(MOD_RSFT, kc)
b624f32f 735#define SFT_T(kc) LSFT_T(kc)
97816df7 736
97816df7
PIN
737#define LALT_T(kc) MT(MOD_LALT, kc)
738#define RALT_T(kc) MT(MOD_RALT, kc)
b624f32f 739#define ALT_T(kc) LALT_T(kc)
28fbf84c 740#define ALGR_T(kc) RALT_T(kc)
97816df7 741
97816df7 742#define LGUI_T(kc) MT(MOD_LGUI, kc)
3bd30085 743#define RGUI_T(kc) MT(MOD_RGUI, kc)
a2e12faa 744#define LCMD_T(kc) LGUI_T(kc)
745#define LWIN_T(kc) LGUI_T(kc)
a2e12faa 746#define RCMD_T(kc) RGUI_T(kc)
747#define RWIN_T(kc) RGUI_T(kc)
b624f32f 748#define GUI_T(kc) LGUI_T(kc)
749#define CMD_T(kc) LCMD_T(kc)
750#define WIN_T(kc) LWIN_T(kc)
751
752#define C_S_T(kc) MT(MOD_LCTL | MOD_LSFT, kc) // Left Control + Shift e.g. for gnome-terminal
753#define MEH_T(kc) MT(MOD_LCTL | MOD_LSFT | MOD_LALT, kc) // Meh is a less hyper version of the Hyper key -- doesn't include GUI, so just Left Control + Shift + Alt
754#define LCAG_T(kc) MT(MOD_LCTL | MOD_LALT | MOD_LGUI, kc) // Left Control + Alt + GUI
755#define RCAG_T(kc) MT(MOD_RCTL | MOD_RALT | MOD_RGUI, kc) // Right Control + Alt + GUI
756#define HYPR_T(kc) MT(MOD_LCTL | MOD_LSFT | MOD_LALT | MOD_LGUI, kc) // see http://brettterpstra.com/2012/12/08/a-useful-caps-lock-key/
757#define SGUI_T(kc) MT(MOD_LGUI | MOD_LSFT, kc) // Left Shift + GUI
e5c331e7 758#define SCMD_T(kc) SGUI_T(kc)
759#define SWIN_T(kc) SGUI_T(kc)
b624f32f 760#define LCA_T(kc) MT(MOD_LCTL | MOD_LALT, kc) // Left Control + Alt
761#define ALL_T(kc) HYPR_T(kc)
d8a608f3
W
762
763// Dedicated keycode versions for Hyper and Meh, if you want to use them as standalone keys rather than mod-tap
764#define KC_HYPR HYPR(KC_NO)
b624f32f 765#define KC_MEH MEH(KC_NO)
d8a608f3
W
766
767#ifdef UNICODE_ENABLE
b624f32f 768// Allows Unicode input up to 0x7FFF
769# define UC(c) (QK_UNICODE | (c))
d8a608f3 770#endif
d8a608f3 771#ifdef UNICODEMAP_ENABLE
b624f32f 772// Allows Unicode input up to 0x10FFFF, requires unicode_map
773# define X(i) (QK_UNICODEMAP | (i))
774# define XP(i, j) (QK_UNICODEMAP_PAIR | ((i)&0x7F) | (((j)&0x7F) << 7)) // 127 max i and j
d8a608f3
W
775#endif
776
b624f32f 777#define UC_MOD UNICODE_MODE_FORWARD
fdeec296
DJ
778#define UC_RMOD UNICODE_MODE_REVERSE
779
780#define UC_M_OS UNICODE_MODE_OSX
781#define UC_M_LN UNICODE_MODE_LNX
782#define UC_M_WI UNICODE_MODE_WIN
783#define UC_M_BS UNICODE_MODE_BSD
784#define UC_M_WC UNICODE_MODE_WINC
785
23ac2a02 786#ifdef SWAP_HANDS_ENABLE
b624f32f 787# define SH_T(kc) (QK_SWAP_HANDS | (kc))
788# define SH_TG (QK_SWAP_HANDS | OP_SH_TOGGLE)
789# define SH_TT (QK_SWAP_HANDS | OP_SH_TAP_TOGGLE)
790# define SH_MON (QK_SWAP_HANDS | OP_SH_ON_OFF)
791# define SH_MOFF (QK_SWAP_HANDS | OP_SH_OFF_ON)
792# define SH_ON (QK_SWAP_HANDS | OP_SH_ON)
793# define SH_OFF (QK_SWAP_HANDS | OP_SH_OFF)
23ac2a02
JW
794#endif
795
542cb0a8
DJ
796// Dynamic Macros aliases
797#define DM_REC1 DYN_REC_START1
798#define DM_REC2 DYN_REC_START2
799#define DM_RSTP DYN_REC_STOP
800#define DM_PLY1 DYN_MACRO_PLAY1
801#define DM_PLY2 DYN_MACRO_PLAY2
802
a91c0c47 803#endif // QUANTUM_KEYCODES_H