AdlerIT

AdlerIT is a small native Windows GUI for computing Adler-32 checksums. It is a single desktop executable: open it, type or paste text, and copy the checksum.

The app is intentionally quiet. It performs no network access, writes no settings or history, and uses direct Win32 controls rather than a browser engine, web runtime, or GPU-rendered cross-platform UI toolkit.

Features

• Live Adler-32 calculation from text typed into the desktop window
• Hex checksum output
• One-click copy
• Standard Windows controls with a fixed blue accent
• Bundled JetBrains Mono for checksum/input text
• No network access, telemetry, update checks, persisted state, or background activity

Implementation

• Single-crate Rust GUI app (adlerit)
• Native Win32 desktop UI in src/platform/win32_app.rs
• Small in-tree Adler-32 implementation in src/hash.rs
• JetBrains Mono embedded directly in the executable

Layout

src/
  main.rs               GUI entry point
  hash.rs               Adler-32 calculation
  platform/
    win32_app.rs        native Windows desktop UI

assets/
  fonts/
    JetBrainsMono-Regular.ttf
    OFL.txt

Scripts/
  build-windows-gui.ps1 Windows release build helper
  generate-release-notes.sh
  version.ps1

quickstart.txt          user-facing usage handout

App Data

AdlerIT stores nothing. It writes no settings, history, cache, or data files. There is nothing to back up, clear, or migrate between versions.

Security Notes

AdlerIT has a deliberately small surface area:

• It performs no network access at all: no update checks, telemetry, or outbound connections.
• It only reads the text you type or paste into the app window.
• It persists no state, so there is no settings or data file to tamper with.
• The Windows build runs an offline-capability guard that checks the dependency graph and scans the binary for network, URL-opening, and startup-registry capability markers.
• Release builds are scanned with Microsoft Defender and carry GitHub build-provenance attestations.

Adler-32 is a fast checksum for integrity and error detection, not a cryptographic hash. Do not use it to verify authenticity against a malicious party or to store or compare secrets.

Build And Run

AdlerIT targets Windows. Release builds produce one portable executable:

AdlerIT-Windows-x64.exe

Run locally during development:

cargo run
cargo test

Build the Windows release executable:

Scripts\build-windows-gui.ps1

The Windows build targets 64-bit Windows:

x86_64-pc-windows-msvc

If Rust says the target is missing, install it once:

rustup target add x86_64-pc-windows-msvc

The build output is:

dist\AdlerIT-Windows-x64.exe
dist\AdlerIT-Windows-x64.exe.sha256

Releases

The version in Cargo.toml is the single source of truth for the AdlerIT release version. Update it, let Cargo refresh Cargo.lock, commit both files, then create a matching vX.X.X tag.

To publish a GitHub Release, push a version tag:

git tag v0.2.0
git push origin v0.2.0

Before tagging, run Build release app manually from the GitHub Actions page with the intended vX.X.X tag. The dry run checks formatting, tests, Clippy, the dependency audit, the offline-capability guard, the Windows package, and the Microsoft Defender scan.

Verify a downloaded release artifact with the GitHub CLI:

gh attestation verify AdlerIT-Windows-x64.exe --repo Joshndroid/AdlerIT

Appearance

The desktop app uses standard Windows controls, the default Windows GUI font for labels and buttons, JetBrains Mono for text/checksum fields, and a fixed blue accent.

Bundled Fonts

AdlerIT bundles JetBrains Mono Regular for checksum and input text. The font is licensed under the SIL Open Font License 1.1; see assets/fonts/OFL.txt.

License

AdlerIT is released under the GNU Affero General Public License v3.0; see LICENSE.