Skip to content

ZeroTrace HID

Mouse Injection

Cursor movement, clicks, scroll, jitter, and draw primitives

Full HID mouse control from a script, or interactively through Live Mode.

Mouse primitives require USB-HID. BLE-HID does not carry pointer reports, so these commands no-op silently in BLE mode. See SilentTrace.

Coordinate space

All mouse motion is relativemouseMove deltas (and the movement in mouseMoveSoft, mouseMoveSmooth, and mouseDraw) are raw HID mickey units, not pixels, and per-OS acceleration applies. There is no absolute-positioning command. Use mouseMoveCorner to reach a known anchor (top-left, top-right, bottom-left, bottom-right), then move relative from there.

Move and click

mouseMove jumps by a delta. mouseMoveSmooth interpolates over steps for a less mechanical path.

mouseMove 200 -50
mouseMoveSmooth 200 -50 20 3
mouseMoveCorner 'top-left'

Anti-idle and human-like motion

mouseJitter <durationMs> <posDelay> <click> <button> is the primitive for keep-awake / stay-active payloads. mouseHumanJitter adds smoothed micro-movements and an optional random click chance (arguments 5–6: maxStep, clickChance). mouseLock <durationMs> pins the cursor to a corner for a set time.

mouseJitter 5000 50 false 'left'
mouseHumanJitter 5000 50 false 'left' 6 20
mouseLock 10000

Motion patterns

For visible motion that proves control without typing, use the shape primitives: mouseDrawCircle <radius> <segments> <stepDelay>, mouseSpiral <radius> <turns> <stepDelay> (holds left, releases at the end), or mouseDraw <x> <y> [button] (drags from the current position to a relative offset while holding a button).

mouseDrawCircle 50 36 20
mouseSpiral 40 3 15

See the Mouse scripting reference for every command and its full argument list.

Command Palette

Search for a command to run...