Documentation
HoldTap gives you absolute control over your input device. By distinguishing between a quick tap and a hold, you can effectively double the number of keys on your keyboard without moving your hands.
Core Concepts
Tap
A normal keystroke. Press and release the key quickly (usually under 200ms). Used for standard typing (letters, numbers, etc.).
Hold
Press and keep the key down. This activates a secondary function, such as a modifier (Shift, Ctrl) or a temporary layer, until you release the key.
Layers
Think of layers like the Fn key on a laptop, but supercharged. Layer 0 is your default layout. Holding a specific key can temporarily switch your entire keyboard to Layer 1, Layer 2, etc., giving you access to completely different maps for navigation, media controls, or symbols.
Action Types
Any key event (Tap or Hold) can be assigned one of five powerful action types.
Standard Key
Sends a standard keyboard code (e.g., 'A', '1', 'Enter'). Can also map special keys like F-keys, Arrows, or Media keys.
Example: Mapping Arrow Keys →Modifier
Acts as Shift, Control, Option (Alt), or Command (GUI). Crucial for "Home Row Mods" where holding a letter key acts as a modifier.
Layer Trigger
Temporarily activates another keyboard layer while held. Releasing the key returns you to the previous layer. Ideal for momentary access to numbers or symbols.
Example: App Launcher Layer →Macro / Shortcut
Sends a sequence of keys instantly (e.g., Cmd+C). You can record complex combinations to automate workflows or type special characters.
Application Launch
Launches or switches to a specific application on your computer. Turns your keyboard into a powerful app switcher.
Example: Launching Apps →