diff --git a/guides/installation-wizard.md b/guides/installation-wizard.md index 7bb913559..155f2dea8 100644 --- a/guides/installation-wizard.md +++ b/guides/installation-wizard.md @@ -45,27 +45,18 @@ The wizard starts by installing a privileged helper tool. macOS will show a syst └─────────────────────────────────────────────────┘ ``` - -![Screenshot — Helper installation]({{ '/images/help/placeholder-wizard-helper.png' | relative_url }}) - **Why it's needed:** The keyboard driver runs at the system level. A helper tool with elevated privileges is required to manage it safely. ### 2. Accessibility permission macOS asks you to grant KeyPath Accessibility access in System Settings. The wizard shows you exactly where to click. - -![Screenshot — Accessibility permission]({{ '/images/help/placeholder-wizard-accessibility.png' | relative_url }}) - **Why it's needed:** Accessibility access lets KeyPath see which keys you press, so it can decide what to do with them (remap, activate a layer, trigger an action). ### 3. Input Monitoring permission Similar to Accessibility — macOS asks you to grant Input Monitoring access. - -![Screenshot — Input Monitoring permission]({{ '/images/help/placeholder-wizard-input-monitoring.png' | relative_url }}) - **Why it's needed:** Input Monitoring lets KeyPath intercept key events before they reach your apps. This is what makes remapping work — KeyPath catches the physical key, transforms it, and sends the remapped key to your app. ### 4. Karabiner import (if applicable) @@ -90,9 +81,6 @@ The wizard starts the Kanata remapping engine. Once it's running, your keyboard └─────────────────────────────────────────────────┘ ``` - -![Screenshot — Setup complete]({{ '/images/help/placeholder-wizard-complete.png' | relative_url }}) - --- ## If something goes wrong diff --git a/guides/layers.md b/guides/layers.md index 2fe2cc23c..9bddf0c52 100644 --- a/guides/layers.md +++ b/guides/layers.md @@ -82,9 +82,6 @@ These use a two-step activation: hold Space (the Leader key) to enter the naviga | **Window Snapping** | Space + W | Tile windows to halves, corners, screens | | **Mission Control** | Space + M | Expose, desktops, notification center | - -![Screenshot — The overlay showing layer key hints]({{ '/images/help/placeholder-overlay-nav-layer.png' | relative_url }}) - ### Installing a layer pack 1. Open the **Pack Gallery** @@ -101,9 +98,6 @@ See the [Packs & Layers catalog]({{ '/guides/packs/' | relative_url }}) for deta The keyboard overlay updates in real time as you switch layers. When you hold a trigger key, the overlay shows the current layer's key assignments — so you always know what each key does right now. - -![Screenshot — Overlay showing layer transition]({{ '/images/help/placeholder-overlay-layer-transition.png' | relative_url }}) - This is especially useful when you're learning a new layer. Keep the overlay visible and glance at it while you build muscle memory. --- diff --git a/guides/qmk-import.md b/guides/qmk-import.md index 40f180b31..9a55a7866 100644 --- a/guides/qmk-import.md +++ b/guides/qmk-import.md @@ -36,9 +36,6 @@ KeyPath indexes over 3,700 keyboards from the [QMK firmware](https://qmk.fm/) re └─────────────────────────────────────────────────┘ ``` - -![Screenshot — QMK keyboard search]({{ '/images/help/placeholder-qmk-search.png' | relative_url }}) - Select your keyboard and KeyPath downloads the layout definition. The overlay updates immediately to show your physical key arrangement. --- @@ -58,9 +55,6 @@ These keyboards ship with pre-built layouts — no import needed, just select fr If your keyboard is in this list, you don't need to import — it's already available in the overlay's layout picker. - -![Screenshot — Layout picker with custom keyboards]({{ '/images/help/placeholder-layout-picker-custom.png' | relative_url }}) - --- ## Importing from a URL @@ -91,9 +85,6 @@ When importing, you can configure: | **Layout variant** | Some keyboards have multiple layouts (e.g., with/without encoder) | | **Custom name** | Name this layout in the picker (defaults to the QMK keyboard name) | - -![Screenshot — QMK import options]({{ '/images/help/placeholder-qmk-import-options.png' | relative_url }}) - --- ## What gets imported diff --git a/guides/remapping.md b/guides/remapping.md index f209c40c1..5490357c5 100644 --- a/guides/remapping.md +++ b/guides/remapping.md @@ -66,9 +66,6 @@ KeyPath installs Home Row Arrows by default. If it's already running, try it: 3. Press **J, K, I, or L** to move the cursor 4. **Release F** to go back to normal typing - -![Screenshot — Home Row Arrows active in the overlay]({{ '/images/help/placeholder-overlay-home-row-arrows.png' | relative_url }}) - That's it. Your hand never left the home row. No reaching, no looking down, no tiny arrow keys. ### Prefer Vim-style HJKL? @@ -88,18 +85,12 @@ If you're a developer who already knows Vim's HJKL navigation, you can switch la └───┴───┴───┴───┘ └───┴───┴───┴───┘ ``` - -![Screenshot — Home Row Arrows layout picker]({{ '/images/help/placeholder-pack-detail-arrows-picker.png' | relative_url }}) - ### If it's not installed yet 1. Open KeyPath from the menu bar 2. Open the **Pack Gallery** 3. Find **Home Row Arrows** and click **Install** - -![Screenshot — Home Row Arrows in the Pack Gallery]({{ '/images/help/placeholder-pack-gallery-home-row-arrows.png' | relative_url }}) - Or from the command line: ```bash @@ -163,9 +154,6 @@ keypath remap right_option delete The keyboard overlay shows you what every key does right now. Remapped keys are highlighted so you can always tell what's been changed. - -![Screenshot — The overlay highlighting remapped keys]({{ '/images/help/placeholder-overlay-remapped-keys.png' | relative_url }}) - Click any key to see its current mapping. If you ever forget what you've changed, the overlay is your map. --- diff --git a/guides/script-execution.md b/guides/script-execution.md index c3a7132cb..27041dfa4 100644 --- a/guides/script-execution.md +++ b/guides/script-execution.md @@ -24,9 +24,6 @@ Scripts are disabled by default. To turn them on: 3. Toggle **Enable Script Execution** 4. Confirm in the security dialog - -![Screenshot — Script Execution settings]({{ '/images/help/placeholder-settings-script-execution.png' | relative_url }}) - The confirmation dialog explains what scripts can do — run commands, access files, and make network requests. This is a one-time decision; you can disable it again at any time. --- @@ -61,9 +58,6 @@ open "keypath://script/~/scripts/hello.sh" The first time a script runs, KeyPath shows a confirmation dialog with the script path. You can check "Don't show again" to skip the dialog for future scripts. - -![Screenshot — First-run script confirmation]({{ '/images/help/placeholder-script-confirmation.png' | relative_url }}) - --- ## Supported script types @@ -218,9 +212,6 @@ Check "Don't show again" only if you trust all scripts you'll run. This bypasses KeyPath logs every script execution — path, timestamp, success/failure, and any errors. View the log in **Settings > Script Execution > View Execution Log**. - -![Screenshot — Script execution log]({{ '/images/help/placeholder-script-execution-log.png' | relative_url }}) - ### What scripts can't do - Scripts run with your user permissions — they can't do anything you couldn't do in Terminal diff --git a/guides/vallack-nav.md b/guides/vallack-nav.md index 7e126bd04..42eae1047 100644 --- a/guides/vallack-nav.md +++ b/guides/vallack-nav.md @@ -11,9 +11,6 @@ permalink: /guides/vallack-nav/ This pack is a complete home row navigation system inspired by [Ben Vallack](https://www.youtube.com/@BenVallacksKeyboards), a keyboard designer and YouTuber known for pushing the limits of what a keyboard can do. His channel explores minimal keyboard layouts, custom firmware, and the idea that your fingers should never leave the home row — for anything. - -![Screenshot — Ben Vallack's keyboard customization content]({{ '/images/help/placeholder-vallack-youtube.png' | relative_url }}) - Ben's approach is opinionated: modifiers move to the top row, the index fingers become layer toggles, and the entire right hand becomes a navigation surface. It's a different philosophy from the default Vim Navigation pack — where that pack adds navigation alongside your normal keyboard, this one *redesigns* your keyboard around navigation. If you're new to keyboard customization, start with [Home Row Arrows]({{ '/guides/remapping/' | relative_url }}) or [Vim Navigation]({{ '/guides/vim-navigation/' | relative_url }}) first. Come back here when you're ready to go deeper. @@ -57,9 +54,6 @@ Your right hand stays on the home row and handles all cursor movement and basic The core navigation cluster follows the Vim HJKL layout: H is left, J is down, K is up, L is right. But unlike standalone Vim Navigation, the surrounding keys are mapped to editing actions — backspace on U, enter on I, copy on Y, paste on semicolon. Your right hand handles both movement and editing without reaching. - -![Screenshot — Right hand navigation keys in the overlay]({{ '/images/help/placeholder-vallack-overlay-right.png' | relative_url }}) - ### Left hand — switching and jumping Your left hand handles context switching — moving between apps, tabs, and positions within a document: @@ -80,9 +74,6 @@ Your left hand handles context switching — moving between apps, tabs, and posi E and R cycle browser tabs (Ctrl+Shift+Tab and Ctrl+Tab) — invaluable when you have a dozen tabs open. A opens the app switcher (⌘Tab). S and D jump to the start and end of the current line — no more Home/End reaching. T and V navigate back and forward in apps that support ⌘[ and ⌘]. G takes a screenshot. - -![Screenshot — Left hand switching keys in the overlay]({{ '/images/help/placeholder-vallack-overlay-left.png' | relative_url }}) - --- ## The full picture @@ -127,7 +118,6 @@ Tap Q normally to type "q". Hold Q to get Control. Same for W (Option) and E (Co This frees the entire home row for navigation and typing. No conflicts — modifiers live on a row you don't type on as frequently, and the top row is easy to reach without moving your hands. -![Diagram — Standard vs Vallack modifier placement]({{ '/images/help/placeholder-vallack-modifier-comparison.png' | relative_url }}) --- @@ -143,9 +133,6 @@ When you install the Ben Vallack Nav pack, KeyPath sets up three coordinated col These three are designed to work as a system. Installing the pack enables all three and configures them to the Vallack defaults. You can adjust individual settings in each collection if you want to customize. - -![Screenshot — Vallack pack detail with three collections]({{ '/images/help/placeholder-vallack-pack-detail.png' | relative_url }}) - --- ## Who is this for? @@ -169,9 +156,6 @@ These three are designed to work as a system. Installing the pack enables all th 2. Find **Ben Vallack Nav** and click **Install** 3. KeyPath will ask about conflicts if you have Home Row Mods or Vim Navigation enabled — the Vallack system replaces both - -![Screenshot — Ben Vallack Nav in the Pack Gallery]({{ '/images/help/placeholder-pack-vallack-install.png' | relative_url }}) - Or from the command line: ```bash @@ -190,9 +174,6 @@ keypath pack install vallack-system **Give the top-row modifiers a week.** Moving modifiers off the home row feels strange at first. The payoff is that your home row is purely for typing and navigation, with no timing-sensitive tap-hold decisions on your most-used keys. - -![Screenshot — Editing workflow with Vallack navigation]({{ '/images/help/placeholder-vallack-workflow.png' | relative_url }}) - --- ## Learn more from Ben diff --git a/guides/window-management.md b/guides/window-management.md index 543954f92..3cf65907e 100644 --- a/guides/window-management.md +++ b/guides/window-management.md @@ -42,9 +42,6 @@ Now hold Space, press W to enter the window layer, then press a key to snap: , = Previous Space . = Next Space ``` - -![Screenshot — Window Snapping layer in the overlay]({{ '/images/help/placeholder-overlay-window-snapping.png' | relative_url }}) - Release Space to leave the window layer. --- @@ -63,9 +60,6 @@ This works in every app — no per-app configuration needed. The first time you use window snapping, macOS will ask you to grant KeyPath Accessibility permission in **System Settings > Privacy & Security > Accessibility**. Window management won't work without this. - -![Screenshot — Accessibility permission dialog]({{ '/images/help/placeholder-accessibility-permission.png' | relative_url }}) - --- ## All window positions @@ -133,9 +127,6 @@ Beyond window management, KeyPath can detect which app is in the foreground and └─────────────────────────────────────────────────────┘ ``` - -![Screenshot — App-specific rules in Custom Rules]({{ '/images/help/placeholder-custom-rules-app-specific.png' | relative_url }}) - When you switch apps, KeyPath tells Kanata to switch layers automatically. Your keyboard adapts instantly. ### Example: Vim navigation in Safari