Skip to content

ZeroTrace HID

Lock & USB Status

Live host-state indicators in the web UI

The web UI's status bar mirrors what the host reports back to the device:

  • Caps Lock — on / off
  • Num Lock — on / off
  • Scroll Lock — on / off
  • USB connection — enumerated / not-enumerated

States are read from standard HID lock-state reports and update within ~50 ms of host changes. On Kit hardware the same indicators appear on the OLED display.

Why it matters

  • Caps Lock — verify the host before running case-sensitive payloads (or pair with the Disable Caps Lock feature).
  • Num Lock — a script that uses numpad scancodes (KEY_num0KEY_num9) needs Num Lock on or output drops.
  • Scroll Lock — rare; some legacy environments use it as a meta-state signal.
  • USB — confirm the target accepted device enumeration before firing payloads.

Script access

The same data is available in scripts as state variables:

_@capslockState     # "on" / "off"
_@numlockState      # "on" / "off"
_@scrolllockState   # "on" / "off"
_@usbState          # "on" / "off"

Use them in IF blocks to gate payload execution on the host being in the right state.