BitCrafts Vigil icon

BitCrafts Vigil

Spot every file change, every time.

v0.2.1StablePythonGPL-3.0

Vigil watches the folders you pick, fingerprints every file with BLAKE3 (or xxh3 / sha256), and tells you exactly what changed since the last snapshot. No daemon, no cloud, no telemetry — a single GTK4 + libadwaita window with a sidebar and a Verify button.

Why Vigil exists

Silent file change is everywhere — a botched rsync, a partial restore, a process that overwrites a config file you forgot existed. The classic answers (tripwire, aide, a cron job piping into sha256sum) work, but they live in /etc and crontab, ask you to learn their config syntax, and only speak to ops people. Vigil is the same idea — fingerprint, store, diff — wrapped in a GTK4 window so the rest of us can run it on a Documents folder, an external drive, or the pictures we actually care about.

The hashing engine isn’t reinvented: every algorithm comes from the BitCrafts Toolkit, running through bchash. Vigil is the UI that makes the toolkit usable without a terminal.

Releases

Current release: v0.2.1 — Debian / Ubuntu .deb packages, GPG-signed (verify with GPG-KEY-bitcrafts.asc and SHA256SUMS.asc). Pick the x86-v3 variant for any Haswell-or-later CPU, or x86-v4 if your CPU supports AVX-512.

  • bitcrafts-vigil — the GTK4 desktop app. Depends on bitcrafts-tools (let apt pull it in, or install the matching architecture variant first).
  • bitcrafts-tools — the three CLI binaries bchash, bcduplicate, bcintegrity, statically linked. x86-v3 · x86-v4
sudo apt install ./bitcrafts-tools-x86-v3_0.1.1_amd64.deb
sudo apt install ./bitcrafts-vigil_0.2.1_amd64.deb

Verify

Hash any folder against a saved baseline. The algorithm picker offers blake3 (default), xxh3, sha256, with the full bc-hash family behind an Advanced expander.

History

Browse every snapshot you ever took, with relative timestamps and per-run duration + file count.

Compare

Diff any two snapshots side-by-side. See added, removed and modified files in a single pane.

Export

Save the findings as a self-contained ZIP bundle — manifest, diff NDJSON, per-target preferences.

Set baseline

Two-click reset of the reference snapshot. Future Verify runs diff against whatever baseline is current.

i18n

English + French shipped. Drop-in de.po or es.po for new locales.

Additional information

Version
0.2.1 — Debian / Ubuntu .deb, GPG-signed
License
GPL-3.0-or-later
Bug tracker
GitHub Issues
Runtime
GNOME 50 (GTK 4.22, libadwaita 1.9)
Architecture
x86-64-v3 (AVX2 + BMI2)
Languages
English, Français
Built with
Python · GTK4 · libadwaita · BLAKE3 · xxHash · io_uring · SQLite · Meson