Mouse Commands
Move the cursor, click, drag, scroll, and run automated mouse patterns — the full relative mouse command set
Mouse commands move the cursor and click relative to its current position. They are sent over USB‑HID only.
Buttons
Every clicking command takes a button name. Supported buttons: left, right, middle, backward, forward. An unknown (or omitted) button falls back to left.
Moving the cursor
Moves the cursor by x/y relative to its current position, in one HID report. Values are 16‑bit (-32767–32767).
mouseMove 50 -30Smooth 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 3Human‑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 3Optional 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-rightClicking
Clicks a button. Add hold to press and keep it down, or release to let it up.
mouseClick left
mouseClick right hold
mouseClick right releaseDouble‑clicks a button with a 50 ms gap between the two clicks.
mouseDoubleClick leftPresses a button, moves by x/y, then releases — a relative drag‑and‑drop.
mouseDragDrop 100 50 leftAutomated 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 5Arguments: <button> <cps> <durationMs> <jitter(true|false)> <jitterRange>. jitterRange is the relative movement applied between clicks.
Scrolling
Scrolls the wheel by amount (8‑bit, -127–127). Positive scrolls up, negative scrolls down.
mouseScroll 5
mouseScroll -3Scrolls up and down repeatedly: amount up then down, for cycles cycles, pausing stepDelay ms between steps.
mouseScrollPattern 5 3 100Movement patterns and jitter
Random micro‑movements for durationMs, moving every posDelay ms, optionally clicking each step. All four arguments are required.
mouseJitter 5000 100 true leftArguments: <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 20Arguments: <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 3000Moves 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 50Arguments: <radius> <turns> <stepDelay>.
Draws a circle. segments is a float — more segments make a smoother circle.
mouseDrawCircle 50 36 20Arguments: <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