Skip to content

ZeroTrace Companion

Installation

Download Companion for Windows, macOS, or Linux and connect your first device

The Companion app is a free download from GitHub Releases. No account required, no telemetry, no install-time license check.

Download

PlatformReleaseSizeRequirements
WindowsWindows release~11.5 MBWindows 10 or later (64-bit)
macOSmacOS release~5 MBIntel + Apple Silicon
LinuxLinux release~10 MBTested Ubuntu 20.04+ (64-bit)

Source: github.com/ZeroTracePW/desktop. Release notes accompany every tag.

Install

  1. Download the Windows installer (.exe or .msi).
  2. Run the installer. SmartScreen may warn for fresh release builds — click More info → Run anyway.
  3. Launch from the Start menu.
  4. The CH343 USB-Serial driver is bundled.

USB drivers (rare cases):

  • Most ZeroTrace devices auto-install drivers on first plug.
  • If a device doesn't appear in the COM port list, install the CH340 / CP210x driver from the manufacturer's site or via Windows Update.
  • Confirm the COM port number in Device Manager → Ports (COM & LPT).

Connect your first device

  1. Plug the device's COM port (not USB) into your computer with a USB-C data cable.
  2. Open Companion.
  3. The device auto-appears in the device list within ~2 s.
  4. Click Connect.

Device dashboard opens with firmware version, storage usage, and connectivity. See First Launch for the full tour.

First-time USB permission prompts

Grant any USB-access permission your OS asks for. macOS in particular prompts on first connection — click Allow.

Troubleshooting

SymptomFix
Device not in port listCable is charge-only (most "USB-C cables" are). Try a known-good data cable.
Wrong port (USB instead of COM)Switch the cable to the device's COM port. The USB port talks to targets, not the host.
Permission denied (Linux)Group change isn't active — groups should list dialout (Debian) or uucp (Arch). Log out / log in.
Companion launches but stays emptyApp not yet detecting devices — confirm the OS sees the COM port (Windows Device Manager / `dmesg
Port busyAnother app is holding it (Web Flasher, browser serial monitor, the dashboard's COM picker). Close it.
Firmware update stallsDon't unplug. ESP32-S3 flashing takes ~2 minutes; only retry after >5 minutes idle.