Skip to content

ZeroTrace HID

Mouse Injection

Cursor movement, clicks, scroll, jitter, and draw

Full HID mouse control via script primitives or the Live Mode virtual joystick.

Primitives

mouseMove 200 -50           # relative move (dx, dy)
mouseAbs 800 600            # absolute position
mouseClick left             # left / right / middle
mouseScroll 5               # positive = scroll up
mouseJitter 30 50           # random ±30 px every 50 ms
mouseDraw "circle" 100      # built-in shape, 100 px diameter

Coordinate spaces

  • RelativemouseMove deltas are in raw HID mickey units, not pixels. Acceleration applies per OS.
  • AbsolutemouseAbs uses normalized 0..32767 range mapped to the primary display. Multi-monitor setups land on display 1 unless reconfigured.

Anti-idle / human-like behavior

mouseJitter is the primitive for keep-awake / stay-active payloads. The default radius (30 px) and interval (5–10 s) is small enough to be invisible during normal use and large enough to defeat presence-detection idle timers.

Draw shapes

mouseDraw accepts circle, square, triangle, figure8, or line. Useful for proving mouse control works without typing visible text on the target.

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