Skip to content

ZeroTrace HID

File System

On-device storage for scripts and payloads

Every ZeroTrace HID device has a persistent on-device filesystem (LittleFS) that holds your scripts and payloads. You manage it from the mobile app's file browser over BLE.

What lives here

  • ZT scripts and any payload files they reference
  • The device configuration
  • The autostart marker (/__autoStart__) — the script run automatically at boot

Operations

File operations are performed from the mobile app:

ActionHow
Upload / edit / rename / deleteMobile app file browser
Set autostartProvision the autostart script from the app (autostart.set / autostart.get / autostart.clear)

Autostart

If an autostart script is set, it runs at boot. The firmware waits briefly for OS detection first and requires the USB HID keyboard to be mounted; if HID isn't up, the autostart run is skipped.

Wiping the filesystem

  • formatStorage — a script command that formats the filesystem in place (scripts and payloads gone; firmware and config kept).
  • Web Flasher → Erase Filesystem — wipes user data over the wired connection while preserving firmware.
Self-destruct is different

Files survive normal reboots and firmware updates. They do not survive self-destruct, which erases the entire flash chip.

Command Palette

Search for a command to run...