Back to projects

Open-source Windows tool · v1.0

BACKTRAIL

Signed backups with a readable history. I built it for the folders that run a machine, a line or a plant: PLC exports, machine parameters, CSV recipe tables and JSON settings.

  • Windows 10 / 11
  • Python 3.10+
  • No installer, no admin rights
  • ZIP or RAR
  • MIT
01 The idea

A copy is not a history.

The folders that run a machine change in small, undocumented ways, and after an incident nobody can say what was different last week or who touched it. A nightly copy doesn't answer that.

Backtrail compares every backup with the one before and keeps the answer next to the archive, in plain text: which files were added, changed or deleted, and for JSON settings the exact key that moved, old value to new. Each backup also records the Windows user, the PC, whether it was manual or scheduled, and a note.

Every file gets a SHA-256 fingerprint and every backup an Ed25519 signature, so a changed file, a changed list or a changed author claim shows up as INVALID. It works locally: nothing leaves your network.

02 How a backup runs

Five steps, every run.

Hashing runs on all cores and the archive is built during the scan, so a run takes about as long as the compression. In the user guide's example, a 200 MB folder of 1,500 files takes about 2.5 s with Fast compression.

  1. 01

    Scan

    Every file is read and fingerprinted, on all cores.

  2. 02

    Archive

    The folder is packed while the scan runs.

  3. 03

    Compare

    New fingerprints against the previous manifest. No archive is unpacked.

  4. 04

    Write

    The changelog and the manifest, with the user, PC, time and note.

  5. 05

    Sign

    The manifest is sealed with the user's private key. Any later change shows.

03 Features

What it does.

Capture

Any number of local or network folders, in parallel, as ZIP or RAR. Files in use are skipped and listed, never a reason to stop.

Explain

Added, modified and deleted files since the last run, and for JSON settings the key with its old and new value.

Compare and search

Any two backups, however far apart, with the runs in between and their authors. Search finds a file name, a parameter or a value across all changelogs.

Prove

SHA-256 per file and an Ed25519 signature per backup. Backtrail.exe --verify re-checks everything and exits 1 on a problem.

Restore

A whole backup or selected files, into a new folder or over the live source. Every file is verified first, and a restore over the source takes a signed safety backup.

Schedule and prune

A daily Windows scheduled task, with no window and no admin rights. Old backups are pruned by count or age; the newest is never removed.

04 Under the hood

How it's built.

Desktop app

  • Tkinter window
  • Sources and destination
  • History and compare
  • Restore with preview

Backup engine

  • Parallel SHA-256 hashing
  • Archive built during the scan
  • Manifest-to-manifest changelog
  • Retention

Signatures and automation

  • Ed25519 key per user
  • Public keys in the backup folder
  • Windows scheduled task
  • --run and --verify
LanguagePython 3.10+
UITkinter
SignaturesEd25519 (cryptography)
PackagingPyInstaller, one folder
Tests20 test functions (pytest)
LicenseMIT
05 Screenshots

The application in use.

The screenshots show a demo plant generated by a script in the repository.

Main window. Sources, their state, the last backup and who took it.
Version history. Every backup with author, mode, signature and note.
Compare. One changelog between any two backups.
Search. A file name, parameter or value across all changelogs.
Restore. Each file marked identical, different or missing before anything is written.
06 Code

Read the code.

Backtrail is open source under the MIT license. The repository has the source, the tests, the user guide and the build script.