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
- Developer
- Younes Benmoussa
- 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











