TailorKey
Supercharging the MoErgo Glove80 default layout, while keeping the familiarity intact
š§æ TailorKey Zero-Code 4.2 Ā Ā š„new
š” Windows/Linux Ā Ā Ā Ā Ā š” macOS & Windows/Linux (Dual OS) Ā Ā Ā Ā Ā Ā Ā Ā š” Bilateral HRM Windows/Linux
Leverages the Layout Editorās built-in capabilitiesāno Custom Defined Behaviors required.
Last updated: Feb 21, 2025 ā Aligned with Glorious Engrammer v42 capabilities
š°Ā TailorKey 4.1
š” Goto version 4.1 page
Powered by Sunaku's GE v41 Custom Defined Behaviors (Code)
Last updated: Jan 14, 2025 ā Upgraded to the Glorious Engrammer v41 codebase
š Compare versions with Glorious Engammer v42Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā š Hotkeys ReferenceĀ Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā Ā š TK Zero HRM tuning
Target Persona:Ā You appreciate the standard MoErgo QWERTY keycap layout and seek to enhance it with best practices, but find Glorious Engrammer too overwhelming.
50-Word Description: Ā TailorKey is a simplified version of Sunakuās Glorious Engammer, tailored to the MoErgo Glove80 default QWERTY keycap layout.
It comes in two variants:
š°Ā TailorKey: Powered by Sunakuās G.E. Custom Defined Behaviors (Code).
š§æ TailorKey Zero: A zero-code replica created using the native (built-in) capabilities of the Layout Editor, maintaining the glorious typing experience.
Highlights:
1.)Ā Advanced Home-row mods enhance your typing flow by placing modifiers at your fingertips.Ā Video: Home-row Mods? Ā Ā ā What is Bilateral HRM?
2.)Ā An Auto-Shift Layer provides effortless use of modifiers as an alternative to homerow mods.Ā Video: Auto-Shift? Ā
3.)Ā Cursor Layer for easy left-hand controls, such as switching apps, copy-pasting, and more. Ā View Ā Ā š Checkout HotKey page
4.)Ā Sunaku's famous Symbol Layer for optimizing symbol efficiency.Ā View
5.)Ā Unleash victory with a flexible Gaming layer.Ā View
Operating system: Supports both Windows (default) and macOS.Ā How to set up for macOS? Ā Ā
Home-row mods
MoErgo Default QWERTY Layer with the following best practices:
1. Sunaku's Home-row modsĀ (HRM) & BHRM
2. Sunaku's Cursor Layer by holding Bkspc
3. Sunaku's Symbol Layer by holding Space
4. Sunaku's Gaming Layer by Layer+Alt combo
5. Sunaku's Mouse Layer by holding Enter
6. F11 and F12 by pressing 2 keys (combos)
āExperience more hotkeys, more comfort, and a better life.Ā
Typing
This layer disables both Home-row Mods and AutoShift, allowing you to focus on precision and improve your touch typing skills.
ā¬¤Ā ON Ā [Magic] + [1]Ā
ā¬¤Ā OFFĀ [Magic] + [=]Ā back to Home-row mods
AutoShiftĀ
AutoShift automatically capitalizes letters when keys are held down.
1. AutoShift - more info and tuning
2/3/4/5/6Ā Same as Homerow Mods Layer
ā¬¤Ā ON Ā [Magic] + [2]
ā¬¤Ā OFFĀ [Magic] + [=]Ā back to Home-row mods
Cursor
Sunaku's Cursor Layer (Glorious Engrammer)
ā¬¤Ā ON Ā Hold [Backspace]
ā¬¤Ā OFFĀ Release [Backspace]
Tip1:Ā Click this link to see some of the hotkey/combos
Tip2:Ā There are several combos on the left thumb cluster
Symbol
Sunaku's Symbol Layer (Glorious Engrammer)
ā¬¤Ā ON Ā Hold [Space]
ā¬¤Ā OFFĀ Release [Space]
Note: Holding the space key will temporarily activate the Symbol Layer. You don't permanently switch to the Symbol Layer.
Lower
MoErgo Default Lower Layer (doc)
ā¬¤Ā ON Ā Hold [Layer]
ā¬¤Ā OFFĀ Release [Layer]Ā
Tip1: Use NumLock on Lower Layer to toggle number input.
Tip2: If you frequently use the numpad, consider setting it to numbers so you don't need NumLock.
Magic
MoErgo Default Magic Layer (doc)
Enhancements:
Moved [BT CLR] to [8] to avoid mistakes
Layer references on Row 2
to avoid confusion this is reduced to 3 in š§æTKZF1 and F2 reference to sample macros
mstr1 sample output = Ā”Hola!
mstr2 sample output = grammar check:<paste>
Gaming
Sunaku's Gaming Layer (Glorious Engrammer)
Toggle:
ā¬¤Ā ON Ā Both keys - Ā Layer + Left [Alt]
ā¬¤Ā OFFĀ Both keys - Ā Layer + Left [Alt]Ā
Toggle keys:Ā 2 Press both LH -T3Ā and LH -T6 Ā
It's a Combo so press the keys simultaneously !!!!
Mouse
Sunaku's Mouse Layer (Glorious Engrammer)
ā¬¤Ā ON Ā Hold [Enter]
ā¬¤Ā OFFĀ Release [Enter]
Required:Ā Enable HID_POINTING to Y in Adv.Config and a Configuration Factory Reset. (bluetooth needs repairing)
Note TKZ: š§æ Slow, Warp, and Fast are not currently supported by the built-in features of the Layout Editor, but support will be available soon.
Per-key RGB
The per-key RGB feature requires the PR36 community firmware, as it is not yet included in ZMK or the official MoErgo firmware.
1.) Ensure the Device Tree has RGB configuration.Ā See note.
2.) Build with PR36 firmware and enable EXPERIMENTAL_RGB_LAYER in Advanced Configuration.
3.)Ā Update both halves and perform a conf factory reset.
4.)Ā Press Magic-T, or cycle with Magic-G.
5.)Ā To revert to regular firmware, perform step 2 again.
Note TKZ41: š§æ To stay true to the zero-code principle, the RGB Device Tree is excluded. You can download it here.Ā video
Additional layers to support BHRMĀ Ā
Bilateral Combinations Enforcement (cross-hand) allows you to hold a modifier key (like "D" for Ctrl) with one hand, while pressing a key on the opposite side of the keyboard (like "U" with your other hand). This technique helps avoid mistakes caused by pressing both a modifier and a regular key on the same side.
Additionally, it offers ergonomic benefits by reducing uncomfortable finger stretches ("finger yoga") that can happen when using the same hand for both modifier and typing keys.
Why Is This Important?
Pressing a home-row modifier (like Ctrl, Shift, or Alt) and another key on the same side of the keyboard can cause:
Misfires or trigger the wrong action. BHRM solves this by disabling the modifier for same-side key combinations. Instead, it ensures modifiers only apply to opposite-hand key presses, resulting in smoother, more accurate typing.
Ergonomically, this approach reduces strain on your fingers and hands by eliminating uncomfortable stretches and improving overall typing comfort.
BHRM only apply to opposite-hand keypresses, making typing smoother and more accurate.
Why Do You Need Extra Layers?
The extra layers help the system understand your keyboard layout so it can:
Avoid Mistakes: Stop modifiers from activating when you press a key on the same side.
Handle Actions Correctly: Release the modifier, tap the right key, and trigger the intended action in the correct order.
In Simple Terms:
Bilateral combinations enforcement make typing smoother by separating modifier keys (one hand) and typing keys (opposite hand).Ā To work correctly with ZMK, it does require additional layers.
Technical Explanation
The extra layers are designed to support bilateral home row mods, enabling opposite-hand combinations for a smoother typing experience with fewer misfires.
Sunaku designed these bilateral combinations with a two-level hold-tap hierarchy, which requires these additional layers.
Q: For the bilateral, shouldn't hold-trigger-key-positions be enough?
A:Ā No, more layers are needed for the system to correctly handle key releases and the sequence of actions during opposite-hand key presses. Ā Read more
Finger Layers
Required to support Bilateral Combinations Enforcement (BHRM)
Capability MatrixĀ
TailorKey Zero resources:
š Ā macOS configuration instructions
FAQ #1: TKZ is an exact replica with the same values as Glorious Engrammer, ensuring it feels identical.
š§æ Setting HRM Difficulty Levels
Installation Instructions
š°Ā TailorKey:Ā Configure for macOS
Powered by Sunaku's GE v40 Custom Defined Behaviors (Code)
Set OPERATING_SYSTEM, Ā if you are on macOS or Linux.
Leave other settings to default or see Glorious Engrammer for details.
Simply set OPERATING_SYSTEM variable:
This is Sunaku's Glorious Engrammer code. One major advantage of code is that it allows you to use IF, THEN, ELSE constructions, enabling OS-specific behaviorāsomething not possible with TailorKey Zero.
Home-rowĀ left:
HRM_Left_Pinky_V1_TKZ LCTRLĀ A
HRM_Left_Ring_V1_TKZ LALTĀ S
HRM_Left_Middy_V1_TKZ LGUI D
HRM_Left_Index_V1_TKZ LSHFT F
š§æ TailorKey Zero:Ā Configure for macOS
Native (Zero-Code) layout editor capabilities Ā
New: See the Dual-OS version on the top of the page.
See more about this version on Discord here š„
Old content:
Mac uses different modifier keys than Windows, but at this moment, MoErgo's native Layout Editor capabilities do not yet include options to set the OS or adjust key functions accordingly. As a result, Mac users need to manually adjust the layout to follow Glorious Engrammer's best practices.Ā
1. Change the order of the Home-row modifier keys: Ā
Modifier keys are assigned to the Home-row in the default 'GACS' order: GUI, Alt, Ctrl, and Shift. Ā However, for macOS users, this should be changed to the 'CAGS' order, Ctrl, Alt, GUI, and Shift.
Refer to the image on the left for a visual guide on how to change the left home row.
CtrlĀ ^Ā on the pinky finger, letter A
Alt Ā ā„Ā on the ring finger, letter S
CommandĀ ā on the middle finger, letter D
ShiftĀ š” on the index finger, letter F
2. Change a few Navigation Macros, used in the Cursor Layer
The Cursor layer features macros that enable text selection and navigation:
The following hotkeysĀ are different on macos and require adjustment.
Impacted: macos win
&cur_REDO_v1_TKZ LG(LS(Z)) LC(Y)
&cur_UNDO _v1_TKZ LG(Z) LC(Z)
&cur_CUT_v1_TKZ Ā Ā LG(X) LC(X)
&cur_COPY_v1_TKZ LG(C) LC(C)
&cur_PASTE_v1_TKZĀ Ā LG(V) LC(V)
&cur_FIND_v1_TKZ LG(F) LC(F)
&cur_FNEXT_v1_TKZĀ Ā LG(G) LC(G)
&cur_FPREV_v1_TKZ LG(LS(G)) LS(LC(G))
&cur_SELECT_ALL_v1_TKZ LG(A) LC(A)
&cur_SELECT_LINE_v1_TKZ LG(ā)Ā LG(LS(ā)) HOME Ā Ā LS(END)
&cur_SELECT_WORD_v1_TKZ LA(ā)Ā LA(LS(ā)) LC(ā) Ā LC(LS(ā))
&cur_EXTEND_LINE_v1_TKZ LG(LS(ā)) LS(END)
&cur_EXTEND_WORD_v1_TKZ LA(LS(ā)) LC(LS(ā))
3. Tab Switching
Window switching differs between macOS and Windows: macOS uses Command (e.g., Command + Tab), while Windows relies on Alt (e.g., Alt + Tab). This can be easily be adjusted.
Impacted combo:Ā &alt_tab_switch_v1_TKZĀ andĀ &ctrl_tab_switch_v1_TKZ
Windows and macOS
Create two main alpha layers: the default layer for Windows with GACS on the home row, and the macOS layer with CAGS (see above).
You can create a layer switch key using &to to switch to the macOS layer and back again.
Create a second Cursor layer with the macOS modifications described above and update the reference key from the base layers to it.
Manually switch to the base layer
Create two main alpha layers: the default layer for Windows with GACS on the home row, and the macOS layer with CAGS (see above).
You can create a layer switch key using &to to switch to the macOS layer and back again.
Create a second Cursor layer with the macOS modifications described above and update the reference key from the base layers to it.
Manually switch to the base layer
Advanced Tuning for Home Row Mods (HRM)
š§æ TailorKey Zero - Manually set DIFFICULTY_LEVEL values for HRM based on below
Sheet URL: https://docs.google.com/spreadsheets/d/1ESgObQelyz4lnKlfwLYsmofLJulOMK5RdGBsopLe2o8/
š§æ TailorKey Zero - Manually set DIFFICULTY_LEVEL values for HRM based on below
Sheet URL: https://docs.google.com/spreadsheets/d/1ESgObQelyz4lnKlfwLYsmofLJulOMK5RdGBsopLe2o8/
Indicators
