Skip to content

v0.1.1-ALPHA

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Jul 11:47
v0.1.1-ALPHA
This tag was signed with the committer’s verified signature.
darrendignam Darren Dignam
GPG key ID: E2CFCD701A5157DB
Verified
Learn about vigilant mode.
f89726d
This commit was signed with the committer’s verified signature.
darrendignam Darren Dignam
GPG key ID: E2CFCD701A5157DB
Verified
Learn about vigilant mode.

OpenFixity 0.1.1-ALPHA

OpenFixity monitors the integrity (fixity) of digital collections. It scans files on local disks, removable storage and network locations, computes cryptographic checksums, and reports whether anything has changed, been added, removed, moved or renamed since the last scan. It is the successor to Fixity Pro, originally developed by AVP and now stewarded by the Open Preservation Foundation.

Status: pre-alpha. These builds are for testing and feedback only, and are not yet ready for use against collections you care about.

This is the first tagged release series, so the notes below cover everything built across 0.1.0-ALPHA and 0.1.1-ALPHA rather than a single increment.

Fixity checking

  • Scans filesystem paths and records a full inventory for every scan.
  • Thirteen digest algorithms: MD2, MD5, SHA-1, SHA-224, SHA-256, SHA-384, SHA-512, SHA-512/224, SHA-512/256, SHA3-224, SHA3-256, SHA3-384 and SHA3-512. The default is SHA-1.
  • Change detection across scans: reports files that are verified, added, changed, removed (not found), moved or renamed, and unverified.
  • Flags files it could not check: damaged (unreadable), denied (no permission) and ignored.
  • Directory-aware scanning, with per-folder aggregates and a summary of each scan (file count, total bytes, damaged count and denied count).
  • Scans are persisted transactionally to an embedded database, so scan history survives restarts.

Ways to run it

  • Desktop app (primary). Native installers for Windows, macOS and Linux, each bundling its own Java runtime, so users install nothing else. The app opens the interface in its own window and keeps all data on the local machine.
  • Server. The same application run as a web server, for example alongside the network storage it scans, with the interface served in a browser.
  • Docker. The server, containerised, to run as a long-lived service next to network drives.

Scheduled scans

  • Recurring scans on a friendly preset: hourly, daily or weekly at a chosen time.
  • Schedules are persisted and re-registered on startup, so they survive restarts and fire on their own.
  • Manage schedules from both the modern and the legacy interface: create, list and remove them, and pause or resume the scheduler.
  • An optional advanced mode exposes a raw cron expression for power users.

Interface

  • A React single-page application, served by the app itself, with light and dark themes.
  • Dashboard, collection and path management, a file-system browser for registering paths, scan history, and per-scan detail down to per-file status.
  • A settings page with system information (the local URL and port, version, uptime, Java and operating system), links to the project and its issue tracker, and user preferences.
  • A legacy server-rendered interface remains available during the transition.
  • All front-end assets are bundled and served locally, with no content delivery networks, so the interface renders correctly on air-gapped and network-restricted preservation workstations.

Platforms and distribution

  • Installers are built automatically on each tagged release: .deb (Linux x64), .dmg (macOS Intel and Apple Silicon) and .msi (Windows x64).
  • Each release is published here on GitHub and mirrored on the OPF artifact server, with direct download links and build metadata.

Notable fixes and hardening

  • Digest algorithms are stored by name rather than by position, so reordering the algorithm list can no longer silently re-attribute existing checksums to the wrong algorithm (e3c1465).
  • Relative paths use forward slashes, so folders and scans resolve correctly on Windows (9c4e81a).
  • Corrected audit-status and path-handling edge cases in the scanner (551c1e7).
  • The front end is served locally, so the app works fully offline (48eab93).
  • Scheduler status is served as JSON, so pause and resume now reflect in the interface, and scheduling a scan is idempotent so re-running a scan no longer fails (9788a44).
  • The desktop window opens maximised, so the title bar is always reachable on smaller or scaled displays (419440e).
  • The dashboard "view all scans" links always open the Scans tab (d76b36a, fixes #3).

Downloads

Grab the installer for your platform from the assets below.

The installers are not yet code-signed, so on first launch:

  • macOS: right-click the app and choose Open, then confirm, to get past Gatekeeper.
  • Windows: on the SmartScreen prompt, choose More info then Run anyway.

Code-signing and notarization are planned (see #2). See INSTALL.md for details.

Heritage

OpenFixity is the spiritual successor to Fixity Pro, originally developed by AVP and since transferred to the Open Preservation Foundation. With thanks to Carl Wilson, who led the backend work. See ACKNOWLEDGEMENTS.md for the project's history.

Licence

Apache License 2.0.

Alternative downloads (OPF artifact server)

The same installers are mirrored on the OPF artifact server, browsable at https://artifacts.opf-labs.org/browse/openpreserve-OpenFixity/v0.1.1-ALPHA:

Assets 6
Loading