warpd

warpd [OPTIONS]

warpd is a modal keyboard-driven pointer manipulation program. It provides three main modes for moving the mouse cursor without a physical mouse, using an interaction model inspired by vi.Normal mode (activated by default with A-M-c) provides vi-like cursor movement using hjkl keys, with support for numeric multipliers to control movement distance. Hint mode (A-M-x) overlays labeled hints on screen locations, allowing quick pointer warping by typing the corresponding label. Grid mode (A-M-g) divides the screen into a 2x2 grid, recursively subdividing on each selection to narrow down the target location.Additional modes include history mode which shows hints over previously selected targets, and screen mode for navigating between multiple monitors. Configuration is done via `~/.config/warpd/config`.

-f, --foreground

Run in the foreground (useful for debugging).

Print a list of valid keys which can be used as config values.

Print all configurable options.

Display version information.

Use the provided config file (use - for stdin).

Run in daemonless hint mode.

Run in two-stage hint mode.

Run in grid mode (divides screen into quadrants for selection).

Run in normal mode (vi-like cursor movement).

Run in history hint mode (hints over previously selected targets).

Run in screen selection mode (for multi-monitor setups).

Exit after mode completion instead of dropping into normal mode.

Send a mouse click and exit.

Position pointer at the specified coordinates.

h, j, k, l

Move cursor left, down, up, right (normal mode).

Jump to left edge, middle, right edge of screen.

Scroll down, scroll up.

Left click.

Middle click.

Right click.

Activate hint mode from normal mode.

Requires X11 or Wayland (with wlroots-based compositors). The daemon must be running for activation key bindings to work. Key bindings may conflict with other applications. Hint mode may not label all clickable elements depending on the platform.

xdotool(1), keynav(1), xbindkeys(1)