HoldTapDocumentation
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 eight 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 →Script
Executes a Shell command, AppleScript, or Shortcuts automation when triggered. Choose from built-in suggestions or write your own. Perfect for toggling system settings, controlling apps, or running custom workflows.
Media Control
Controls media playback and system settings directly from your keyboard. Adjust volume, brightness, or control music playback (play/pause, next/previous track) with native macOS visual feedback.
Window Tiling
Snap windows to predefined positions on your screen. Tile to halves (left, right, top, bottom), quarters (corners), or maximize. Uses the macOS Accessibility API for precise window management.