Mouse Commands

Moves the cursor by x/y relative to its current position, in one HID report. Values are 16‑bit (-32767–32767).

mouseMove 50 -30

Smooth relative movement with wheel support. The move is broken into a fixed 10 steps; delayMs is the pause between steps. All four arguments are required.

mouseMoveSoft 300 -120 0 3

Human‑friendly smooth relative movement (wheel is always 0). Takes 2 or 4 arguments: with just x y it defaults to steps=20, delayMs=3. If steps ≤ 0 or delayMs < 0, the command is a no‑op.

mouseMoveSmooth 300 -120
mouseMoveSmooth 300 -120 24 3

Optional values must be supplied together as <steps> <delayMs>.

Moves the cursor toward a screen corner. Supported corners: top-left, top-right, bottom-left, bottom-right.

mouseMoveCorner top-right

Clicks a button. Add hold to press and keep it down, or release to let it up.

mouseClick left
mouseClick right hold
mouseClick right release

Double‑clicks a button with a 50 ms gap between the two clicks.

mouseDoubleClick left

Presses a button, moves by x/y, then releases — a relative drag‑and‑drop.

mouseDragDrop 100 50 left

Automated clicking at cps clicks per second for durationMs, with optional jitter. If cps ≤ 0 the command is a no‑op.

autoClicker left 10 5000 true 5

Arguments: <button> <cps> <durationMs> <jitter(true|false)> <jitterRange>. jitterRange is the relative movement applied between clicks.

Scrolls the wheel by amount (8‑bit, -127–127). Positive scrolls up, negative scrolls down.

mouseScroll 5
mouseScroll -3

Scrolls up and down repeatedly: amount up then down, for cycles cycles, pausing stepDelay ms between steps.

mouseScrollPattern 5 3 100

Random micro‑movements for durationMs, moving every posDelay ms, optionally clicking each step. All four arguments are required.

mouseJitter 5000 100 true left

Arguments: <durationMs> <posDelay> <click(true|false)> <button>.

More human‑like jitter with smoother micro‑movements and an optional random click chance. Takes 4 to 6 arguments.

mouseHumanJitter 5000 70 true left
mouseHumanJitter 5000 70 true left 8 20

Arguments: <durationMs> <posDelay> <click> <button> [maxStep=6] [clickChance=100]. maxStep is clamped to 1–30; clickChance (percent) to 0–100.

Pins the cursor to a corner for durationMs, fighting any host movement for the duration.

mouseLock 3000

Moves the cursor in an outward spiral. Holds the left button down for the whole path and releases it at the end (a spiral drag).

mouseSpiral 100 3 50

Arguments: <radius> <turns> <stepDelay>.

Draws a circle. segments is a float — more segments make a smoother circle.

mouseDrawCircle 50 36 20

Arguments: <radius> <segments> <stepDelay>.

Drags from the current position by x/y (16‑bit) while holding a button. The button defaults to left.

mouseDraw 100 200
mouseDraw 50 150 right