Skip to content

Installing Trusty Track on Windows

This guide walks you through installing Trusty Track on a Windows PC. No terminal or technical knowledge required.

Requirements

  • Windows 10 or later (64-bit)
  • About 200 MB of free disk space

Step 1 — Download the installer

Download for Windows

Prefer to pick a specific version, or check a file's checksum? The Trusty Track Releases page on GitHub lists every release, each with its own copy of the installer.

Step 2 — Run the installer

Double-click the downloaded file to run it.

If Windows Defender SmartScreen appears

Windows may show a blue screen saying "Windows protected your PC." This happens because the installer hasn't been signed with a paid certificate.

To continue:

  1. Click More info.
  2. Click Run anyway.

Step 3 — Follow the installer wizard

  1. Click Next on the welcome screen.
  2. Choose an installation folder (the default is fine for most users). Trusty Track installs for your user account only and does not ask for an administrator password — useful on a school or church laptop you do not administer.
  3. Optionally check Create a Desktop shortcut.
  4. Click Install.
  5. Click Finish — Trusty Track will launch automatically.

Step 4 — Use Trusty Track

The first time it starts, Windows will ask whether to allow Trusty Track on your network. Click Allow — this is what lets the audience displays and a second operator's laptop connect. (If you click the wrong button, see Troubleshooting below.)

After installation, Trusty Track will open your browser to https://localhost:8000. If it doesn't open within 30 seconds, open your browser and go to that address manually.

Your browser will warn you the first time

Trusty Track serves https:// using a certificate it generates on your own machine. Browsers do not recognise it, so the first visit shows "Your connection is not private" or similar.

Click Advanced, then Proceed to localhost. Nothing is leaving your machine — the certificate exists so that the camera and the barcode scanner work, which browsers only allow on a secure connection.

If the warning is a bigger problem for your event than losing the camera on a second device, the tray icon has a Use Plain HTTP option that turns it off — see HTTPS, certificates, and plain HTTP.

The first time you run it, you'll see a setup wizard to configure your organization and track.

Starting Trusty Track later

  • Double-click the TrustyTrack shortcut on your Desktop.
  • Or click Start → search for TrustyTrack → click it.

Quitting Trusty Track

Trusty Track runs in the background while open. To quit:

  • Right-click the TrustyTrack icon in the system tray (bottom-right corner of your taskbar, near the clock).
  • Click Quit.

Your data is saved automatically. Quitting and reopening the app picks up where you left off.

Where your data is stored

Trusty Track stores its data and photos in:

%APPDATA%\TrustyTrack\

To open this folder, press Win+R, type %APPDATA%\TrustyTrack, and press Enter.

Updating

To update to a new version:

  1. Download the new installer from the Releases page.
  2. Quit Trusty Track if it's running (system tray → Quit).
  3. Run the new installer — it will replace the previous version while keeping your data.

Uninstalling

  1. Open Settings → Apps (or Add or Remove Programs on older Windows).
  2. Search for TrustyTrack.
  3. Click Uninstall and follow the prompts.

Your data folder (%APPDATA%\TrustyTrack\) is not deleted by the uninstaller. Delete it manually if you want to remove all data.

Troubleshooting

Watching the application log

Right-click the TrustyTrack icon in the system tray and choose View Logs. This opens a PowerShell window that follows the log live, so you can watch what the app is doing as you reproduce a problem.

Other devices cannot reach the app

This usually means the Windows Firewall prompt from Step 4 was dismissed or answered Don't allow. Re-allow it in Settings → Privacy & security → Windows Security → Firewall & network protection → Allow an app through firewall.

"Windows cannot find the file" after install

Make sure the installation completed without errors. Try re-running the installer.

App starts but browser doesn't open

Go to https://localhost:8000 in your browser manually — note the https.

Antivirus flags the installer

The installer is safe, but unsigned — some antivirus software may flag unsigned executables. You can: - Add an exception for the installer file. - Download the installer again and verify the file size matches the Releases page. - Run from source if your organization's security policy prevents running unsigned software.

App starts but shows an error page

Check that nothing else is using port 8000. If so, the app cannot start. Quit other applications that might use that port and try again.