# KeyPilot Settings

Changes sync across tabs automatically.

## Search engine

Used by the New Tab search box and KeyPilot’s omnibox (Alt+L).

Brave Google DuckDuckGo

## Keyboard

Layout and floating keyboard reference panel behavior.

Keyboard layout family
Controls which built-in layout family is active. Handedness is set separately so cycling families never flips left/right.
Left-handed
Use the left-handed variant of the selected layout family (shortcuts primarily on the right side).
Show number row
Include the 1–0 row in the floating keyboard reference panel and layout editor.
Show pressed-key feedback
Highlights keys in the floating keyboard reference panel on keydown/keyup.

## Cursor

Whether KeyPilot overrides the page cursor with a crosshair.

Cursor mode
When “No custom cursors” is selected, KeyPilot won’t override the page cursor and per-mode cursor controls are hidden. “Crosshair” shows KeyPilot’s crosshair cursor instead.

## Scrolling

Keyboard page scrolling for C / V (smaller step). Z / X jump to the edge. Optional middle-click Scroll Line.

C / V distance
Pixels scrolled by C (up) and V (down). Default 500.
Scroll speed
Animation for keyboard scrolling (C/V, Z/X, B/N).
Middle click starts Scroll Line
On empty page area, the middle mouse button runs the Scroll Line action (same as the bound key). Links, clickables, and text fields keep native middle-click. On by default on Mac.

## Click Mode

Cursor + hover focus rectangle behavior.

### Cursor

Type
Preview
Line width
Thickness of the crosshair lines (1–12).
Size
Size of the cursor in pixels (5–60px).
Gap
Gap between center and crosshair bars in pixels. 0 = intersecting lines, >0 = separate bars (0–20px).

### Focus rectangle

Live hover outline on clickable targets. Changes apply immediately (including in this Settings window).

Color
Outline color for the focus rectangle.
Show transparent overlay
Adds a translucent fill inside the focus rectangle.
Show shadow / glow
Soft outer glow around the focus rectangle.
Rectangle thickness
Border thickness for the focus rectangle (1–16px).

### Keyboard Reference

Glow keys when hovering a link
While the Keyboard Reference is open, matching green action keys get an outline and glow when you hover a clickable link on the page. Off by default.

### Click effect

Visual feedback when you press `F` to activate a link-style target.

Flash Hard strobe on the outline (default) Dash chase Dashed border marches around the edge Marquee Solid light travels around the border Scale Outline expands outward and fades None No activation animation

## Text Mode

Cursor + focus style + labels for text fields.

### Text mode cursor

Type
Preview

### Focused text field style

How the active text field looks while typing (text mode). Hover still shows an orange outline and “Press F to select text field”.

Left edge pulse Orange bar on the left edge, pulsing (default). “press Esc to exit” stays on the field. Background tint Full orange wash over the field (previous style), plus the Esc hint.
Left edge bar width
Width of the pulsating left-edge bar (1–24px). Default 5px.

### Labels & outlines

Show labels above and below focused text field
Shows “Active text field” and “Press ESC to close”. Turn off for outline-only.
Stroke thickness
Thickness of the orange text-mode outlines (1–16px).

## Control Strip

Compact status strip in the upper-left of every page (macOS Control Strip style). Press `Alt`+`J` to show it again after closing.

Show control strip
When off, the strip is hidden until you enable this or press Alt+J to toggle it back on.
Collapsed by default
Shows only the On/Off status segment until you expand the strip.

## About

KeyPilot settings sync via Chrome profile storage.

noctivagous.com

Settings are stored in `chrome.storage.sync` so they stay consistent across tabs.