Skip to content

ZeroTrace HID & Dongle

Your First Payload

Write, upload and run your first ZeroTrace Script payload.

Your First Payload

The quickest way to see the device work is a two-line payload that opens a text editor and types a line. Run it against a computer you own.

  1. Open the payload editor

    Connect the device in the ZeroTrace app and open the payload editor (the Executor).

  2. Set the keyboard layout

    Add a keyboardLayout line for your host's locale so the right characters land, for example keyboardLayout en_US. An unrecognised layout silently falls back to US English, so spell it correctly. See ZeroTrace Script.

  3. Write the payload

    A minimal example that waits, then types a line:

    keyboardLayout en_US
    delay 500
    writeLn 'Hello from ZeroTrace'
    

    delay pauses so the host is ready; writeLn types the text and presses Enter.

  4. Check it before uploading

    Validate the payload in the app. A line with the wrong number of arguments is skipped silently on the device, it is not an error at runtime, so checking first is what catches typos. See Limitations.

  5. Run it

    Point the device at a focused text field on the host and run the payload from the app. The device types the line as if you were at the keyboard.

Importing a DuckyScript payload

Already have a Hak5 DuckyScript payload? The app can import it and convert it into ZeroTrace Script for you. See ZeroTrace Script.

Run only what you understand

A payload types and clicks with full host privileges. Read every payload before running it, and only run against machines you own or are authorized to test. See Safety & Legal.

Command Palette

Search for a command to run...