ZeroTrace Mobile
HID in the App
Write and run scripts, drive live mouse and gamepad, and manage payloads, layouts and files.
HID in the app
When you connect a ZeroTrace HID dongle, the app opens a full tab bar built around scripting and live control: Executor, Live, Pad, Files, TraceNet and Settings, plus a set of off-bar screens for layouts, firmware and diagnostics.
Executor
The Executor tab is where you write and run payloads. It's a script editor built into the app:
- Write a script in the ZeroTrace scripting language, or bring one in from the DuckyScript importer (below).
- As you type, the editor checks your script against the keyboard layout you've selected, so a key that doesn't exist on that layout is flagged before you run, not after.
- Press run to execute the script on the connected dongle. Saved runs are kept so you can re-run or edit a payload later without retyping it.
The full scripting language, every command, argument and category, is documented in the HID section. Rather than repeat it here, see the complete reference:
The complete ZeroTrace Script language lives at ZeroTrace Script. Everything you write in the Executor uses that language.
Importing DuckyScript
If you already have payloads written in Hak5 DuckyScript, the Executor can import them directly. The importer understands DuckyScript's core commands, typing text (STRING), timing (DELAY, DEFAULTDELAY) and comments (REM), and converts them into an editable script in the Executor.
The importer covers DuckyScript 1.0's core surface, text and timing. Once imported, a script is a normal ZeroTrace Script payload, so anything beyond DuckyScript's basics, conditions, variables, the fuller command set, you add using the full ZeroTrace Script language after import.
Live
The Live tab is a real-time trackpad: drag to move the target machine's pointer, tap to click, right where your thumb is. It includes a jiggler, a small motion loop that nudges the pointer periodically to keep a target session from going idle or locking, useful during a long engagement where you want to hold a session open without typing anything.
Pad
The Pad tab is an on-screen gamepad, buttons and sticks mapped to controller input, for driving the dongle's HID gamepad emulation by hand instead of scripting it.
Files
The Files tab manages what's stored on the dongle: saved scripts, payload libraries and captured logs, browse, rename, delete and organize without needing a cable.
TraceNet
The TraceNet tab shows the dongle's view of ZeroTrace's mesh networking, other TraceNet-capable devices it can see and talk to.
Keyboard layouts
Payloads are layout-aware, a key on a US keyboard is not the same physical key as on a German or French one. The app carries a library of keyboard layouts, bundled layouts covering common regions plus any custom .ztkl layouts you add, so you can match the layout of the machine you're targeting and have your script's keystrokes land exactly where you intend. The layout you pick in Settings is what the Executor lints against as you write.
Settings and off-bar screens
Beyond the main tabs, a connected HID dongle exposes:
- Firmware — check and flash firmware updates over BLE, see Firmware updates.
- Diagnostics and Logs — device health and activity history for troubleshooting a run.
- BLE Peers — other Bluetooth devices the dongle can see.
- Troubleshoot — guided fixes for common connection and execution problems.
- About — firmware version and device identity.
HID is the one family with the full destructive-action set available from the app, reboot, format, and self-destruct. All of them are gated behind App lock & biometrics when app lock is on, so they can't be triggered by an accidental tap.