ZeroTrace HID
USB Identity Spoofing
Present a custom or randomized USB device identity (VID/PID and descriptor strings)
The USB identity a device advertises — its vendor/product IDs and descriptor strings — is part of how a host fingerprints and allow-lists peripherals. ZeroTrace can present a randomized identity, a custom one, or its plain default, controlled by usb_spoof_mode.
Modes
usb_spoof_mode defaults to random.
| Mode | What the host sees |
|---|---|
none / off | The device's real, default USB identity — no spoofing. |
custom | The exact VID, PID, manufacturer, product, and serial strings you set. |
random (default) | A randomized product/manufacturer string and a random PID (with vendor ID 0x0011), re-rolled each boot. Any unrecognized value behaves as random. |
Custom identity fields
When usb_spoof_mode is custom, these keys are applied. Any left blank keep the device default; an invalid usb_vid/usb_pid is logged and ignored.
| Setting | Meaning |
|---|---|
usb_vid | 16-bit Vendor ID — decimal or 0x hex (0x0000–0xFFFF) |
usb_pid | 16-bit Product ID — decimal or 0x hex |
usb_vendor_name | Manufacturer string |
usb_product_name | Product string |
usb_serial_number | Serial-number string |
Custom values can mimic a specific peripheral vendor (for example a known gaming mouse) for descriptor-level fingerprinting bypass.
This spoofs the device's identity (IDs and strings), not its HID class. ZeroTrace always enumerates as a composite keyboard + mouse + consumer control device; it does not switch its descriptor class to a mouse-only or gamepad-only device. Mass storage is exposed separately at runtime via the storageMode script command, not through this setting.
Notes
- The selected mode and custom values persist across reboots.
- Spoofing changes how the device presents on enumeration; it does not defeat a host policy that denies unknown HID devices by default.