BitCrafts Vigil icon

BitCrafts Vigil

Spot every file change, every time.

v0.4.0StablePythonGPL-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.

Install

Debian / Ubuntu, x86-64-v3 baseline. One-time — trust the bit-crafts package registry:

sudo install -d /etc/apt/keyrings
curl -fsSL https://pkgs.bit-crafts.com/api/packages/bit-crafts/debian/repository.key \
  | sudo tee /etc/apt/keyrings/bit-crafts.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/bit-crafts.asc] https://pkgs.bit-crafts.com/api/packages/bit-crafts/debian trixie main" \
  | sudo tee /etc/apt/sources.list.d/bit-crafts.list
sudo apt update

Install Vigil together with the hashing engine it drives:

sudo apt install bitcrafts-tools-x86-v3 bitcrafts-vigil

Then launch BitCrafts Vigil from your application menu, or run bitcrafts-vigil.

Features

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.4.0 — Debian / Ubuntu .deb, served via apt
License
GPL-3.0-or-later
Bug tracker
Forgejo 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