pointer
Perform mouse actions—move, click, drag, scroll—on Hyprland desktops. Use global coordinates or target a window with relative percentages to maintain accuracy even if the window moves or resizes.
Instructions
Mouse. action='move' (x,y) | 'click' (optional x,y first; button left/right/middle; double=true) | 'drag' (x,y → to_x,to_y holding button) | 'scroll' (scroll_dy notches, positive = content down; optional x,y first).
Coordinates are GLOBAL logical pixels by default. Pass window (address,
class/title substring, or a description like "the file browser") plus
x_pct/y_pct in 0.0–1.0 to click RELATIVE to that window instead: (0.5,0.5)
is its centre, (0.1,0.05) near its top-left. The window is focused first.
This is the robust form — it survives the window moving or resizing.
then appends the result to this call so you skip a round-trip: 'desktop'
a fresh snapshot, 'screenshot' a stable capture, 'ui' the focused window's
elements with current values, 'none' (default) nothing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | ||
| y | No | ||
| then | No | none | |
| to_x | No | ||
| to_y | No | ||
| x_pct | No | ||
| y_pct | No | ||
| action | Yes | ||
| button | No | left | |
| double | No | ||
| window | No | ||
| to_x_pct | No | ||
| to_y_pct | No | ||
| scroll_dx | No | ||
| scroll_dy | No | ||
| allow_auth | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |