qmk_firmware/users/kuchosauronad0
precondition 1899793f27
Make IGNORE_MOD_TAP_INTERRUPT the default behaviour for mod-taps (#20211)
2023-04-03 15:32:47 +10:00
..
.gitignore Userspace kuchosauronad0 (#6541) 2019-08-17 08:19:35 -07:00
combo.c Bigger combo index (#9318) 2020-08-29 14:30:02 -07:00
combo.h [Keymap] Update to userspace kuchosauroand0 (#6596) 2019-08-24 09:01:12 -07:00
config.h Make IGNORE_MOD_TAP_INTERRUPT the default behaviour for mod-taps (#20211) 2023-04-03 15:32:47 +10:00
encoder.c Remove useless line continuations (#19399) 2022-12-30 11:48:05 +11:00
encoder.h Convert Encoder callbacks to be boolean functions (#12805) 2021-05-21 23:17:32 -07:00
kuchosauronad0.c Normalise Unicode keycodes (#18898) 2022-10-31 21:15:12 +00:00
kuchosauronad0.h Make default layer size 16-bit (#15286) 2022-06-19 07:37:51 +10:00
leader_user.c Refactor Leader key feature (#19632) 2023-02-13 03:19:02 +11:00
leader_user.h Refactor Leader key feature (#19632) 2023-02-13 03:19:02 +11:00
process_records.c Deprecate `send_unicode_hex_string()` (#12602) 2021-05-14 03:25:40 +10:00
process_records.h Fix some old keycodes (#19086) 2022-11-15 16:52:01 +00:00
readme.md Refactor Leader key feature (#19632) 2023-02-13 03:19:02 +11:00
rgblight_user.c Refactor Leader key feature (#19632) 2023-02-13 03:19:02 +11:00
rgblight_user.h [Keymap] Update to Userspace kuchosauronad0 (#6899) 2019-10-29 22:52:24 -07:00
rules.mk Refactor Leader key feature (#19632) 2023-02-13 03:19:02 +11:00
tap_dances.c Tap Dance: remove `qk_` prefix (#19313) 2022-12-14 12:40:25 -08:00
tap_dances.h Tap Dance: remove `qk_` prefix (#19313) 2022-12-14 12:40:25 -08:00
template.c Make default layer size 16-bit (#15286) 2022-06-19 07:37:51 +10:00
template.h Userspace kuchosauronad0 (#6541) 2019-08-17 08:19:35 -07:00
unicode.c Align definition of unicode_map (#19452) 2023-01-01 11:54:12 +11:00
unicode.h Deprecate `send_unicode_hex_string()` (#12602) 2021-05-14 03:25:40 +10:00
wrappers.h Remove deprecated Quantum keycodes (#19712) 2023-01-29 16:44:16 +00:00

readme.md

Table of Contents

  1. Overview[documentation]
  2. Keyboard Layout Templates
  3. Custom Keycodes [documentation]
  4. Tap Dances [documentation]
  5. Encoders [documentation]
  6. Leader Key [documentation]
  7. Unicode [documentation]
  8. Combo Keys [documentation]
  9. Secret Macros [documentation]

Overview

Thanks to drashna and the people of the discord server and everyone else in the qmk_firmware/users/ directory :)

Keyboard Layout Templates

This borrows from jola5's "Not quite neo" code. The code of the userspace is shared between all keyboards, so that one can maintain functionality of all keyboards at once by modifying a few files in a central location.

This makes adding tap/hold mods, or other special keycodes or functions to all keyboards super easy, as it's done to all of them at once.

The caveat here is that the keymap needs a processor/wrapper, as it doesn't like the substitutions. However, this is as simple as just pushing it through a define. For instance:

#define LAYOUT_ergodox_wrapper(...) LAYOUT_ergodox(__VA_ARGS__)

Once that's been done and you've switched the keymaps to use the "wrapper", it will read the substitution blocks just fine.

Credit goes to jola5 for first implementing this awesome idea.

Custom Keycodes

Declared in process_records.h and template.h and defined in process_record_user in template.c

Tap Dances

To enable set TAP_DANCE_ENABLE = yes in rules.mk. See file tap_dances.{c,h}

TODO: Command-line movement stuff is a pain when typing normally

TODO: Make use of TD_SPC and TD_QT{1..3}

Leader Key

To enable set LEADER_ENABLE = yes in file rules.mk

Leader sequence program description
W vim/tmux save file, switch pane and repeat last command
T tmux send default prefix
A tmux switch pane
T + T tmux send default prefix to a nested session
T + R tmux switch pane and repeat last command
V + Z vim zoom current split
V + R vim search and replace
V + T vim move current split to its own tab
3x Backspace keyboard Reset Keyboard

Leader sequences are defined in leader_user.c

Combo Keys

To enable set COMBO_ENABLE = yes in file rules.mk. Number of combos and timeout are defined in config.h

Press key chord to use.

Combo description
CV Paste
XC Cut
ZV Copy
QP KC_SLEEP

Combos are defined in combo.h and combo.c

Unicode

To enable set UNICODE_ENABLE = yes or UNICODEMAP_ENABLE = yes in file rules.mk

Encoders

To enable set ENCODER_ENABLE = yes in rules.mk.

In the keyboard's config.h adjust according to your keyboard:

// Example ProMicro
#define ENCODERS_PAD_A { F4 } //PIN A3
#define ENCODERS_PAD_B { F5 } //PIN A2

Check the documentation for more information The first rotary encoder is configured such as:

Modifier description
None General navigation. Page up/down
SHIFT Fast navigation. Home/end
CTRL Vertical navigation. Up/down
CTRL+SHIFT Horizontal navigation. Left/right
ALT Audio volume control.
GUI Browser navigation(windows). Forward/backward
ALT+SHIFT Form navigation. Tab up/down
ALT+CTRL Media control. (Play
HYPER Media navigation. Next/prev track

Key codes are stored as uint16_t encoder_actions[2][9] in encoder.c

Diablo Layer

Currently not in use. Back to Top

Secret Macros

To enable set NO_SECRETS = yes in rules.mk.

With help from gitter and Colinta, this adds the ability to add hidden macros from other users.

First, I have several files that are hidden/excluded from Git/GitHub. These contain everything needed for the macros. To hide these files, open .git/info/exclude and add secrets.c and secrets.h to that file, below the comments.

And this requires KC_SECRET_1 through KC_SECRET_5 to be defined in your .h file to define the keycodes for the new macros.

.git/info/exclude

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/users/<name>/secrets.c
/users/<name>/secrets.h

Then you can create these files:

secrets.c

#include "<name>.h"  // replace <name> with your keymap's "h" file, or whatever file stores the keycodes

#if (__has_include("secrets.h") && !defined(NO_SECRETS))
#include "secrets.h"
#else
// `PROGMEM const char secret[][x]` may work better, but it takes up more space in the firmware
// And I'm not familiar enough to know which is better or why...
static const char * const secret[] = {
  "test1",
  "test2",
  "test3",
  "test4",
  "test5"
};
#endif

bool process_record_secrets(uint16_t keycode, keyrecord_t *record) {
  switch (keycode) {
    case KC_SECRET_1 ... KC_SECRET_5: // Secrets!  Externally defined strings, not stored in repo
      if (!record->event.pressed) {
        clear_oneshot_layer_state(ONESHOT_OTHER_KEY_PRESSED);
        send_string_with_delay(secret[keycode - KC_SECRET_1], MACRO_TIMER);
      }
      return false;
      break;
  }
  return true;
}

secrets.h

static const char * const secrets[] = {
  "secret1",
  "secret2",
  "secret3",
  "secret4",
  "secret5"
};

Replacing the strings with the codes that you need.

name.c

In the .c file, you will want to add this to the top:

__attribute__ ((weak))
bool process_record_secrets(uint16_t keycode, keyrecord_t *record) {
  return true;
}

This is so that the function can be called here, and replaced in the secrets.c file, and so it won't error out if it doesn't exist.

And then, in the process_record_user function, assuming you have return process_record_keymap(keycode, record) here, you'll want to replace the "final" return with the following. Otherwise, you want to replace the return true; with return process_record_secrets(keycode, record);

  return process_record_keymap(keycode, record) && process_record_secrets(keycode, record);
}

rules.mk

Here, you want your /users//rules.mk file to "detect" the existence of the secrets.c file, and only add it if the file exists. To do so, add this block:

ifneq ("$(wildcard $(USER_PATH)/secrets.c)","")
  SRC += secrets.c
endif

Additionally, if you want to make sure that you can disable the function without messing with the file, you need to add this to your /users//rules.mk, so that it catches the flag:

ifeq ($(strip $(NO_SECRETS)), yes)
    OPT_DEFS += -DNO_SECRETS
endif

Then, if you run make keyboard:name NO_SECRETS=yes, it will default to the test strings in your .c file, rather than reading from your file. Back to Top