ZeroTrace HID
Gamepad Emulation
Emulate a USB gamepad with buttons, sticks, and D-Pad
ZeroTrace HID can present itself as a USB HID gamepad, recognized natively by Windows, macOS, Linux, Android, and iOS without drivers.
Gamepad primitives are USB-only — the gamepad report is not carried over BLE. In BLE mode these commands no-op silently.
Inputs
| Control | Values |
|---|---|
| Buttons | A, B, C, X, Y, Z, TL, TR, TL2, TR2, SELECT, START, MODE, THUMBL, THUMBR (aliases: SOUTH=A, EAST=B, NORTH=X, WEST=Y) |
| Left stick | X / Y axes, signed -128 to 127 |
| Right stick | Z / RZ axes, signed -128 to 127 |
| Triggers | leftTrigger, rightTrigger, signed -128 to 127 |
| D-Pad (hat) | CENTER, UP, UP_RIGHT, RIGHT, DOWN_RIGHT, DOWN, DOWN_LEFT, LEFT, UP_LEFT |
An unknown button name is a no-op.
Script primitives
pressButton 'A' # press and hold
releaseButton 'A' # release
tapButton 'B' 50 # press, wait 50 ms, release
leftStick 100 -50 # left stick to x=100 y=-50
rightStick 0 127 # right stick
hat 'UP_RIGHT' # D-Pad direction
rapidFire 'B' 10 50 # tap B 10 times, 50 ms interval
comboPress presses several buttons at once — its list is comma-separated (comboPress 'A,B,START'), unlike keyboard's +-joined comboKey. comboRelease takes no arguments and clears all buttons (equivalent to reset).
See the Gamepad scripting reference for the full command set (tapDpad, sweepSticks, leftTrigger / rightTrigger, reset). Mix gamepad commands with delay, repeat, and IF blocks for full payloads.
The gamepad descriptor is selectable in the mobile app alongside keyboard, mouse, and MSC modes.