AFTRIMGE

Documentation

Installing AFTRIMGE

AFTRIMGE 0.2.0 is released for Windows x64 and Linux x64. There is no macOS release. Each release file is listed with its SHA-256 checksum in SHA256SUMS.txt, published beside the downloads.

Every release file is unsigned. Read the section for your platform before running one.

Checking a download

Compare the checksum of the file you downloaded with the one published in SHA256SUMS.txt.

Windows, in PowerShell:

Get-FileHash .\AFTRIMGE-0.2.0-Windows-x64-Installer.exe -Algorithm SHA256

Linux:

sha256sum AFTRIMGE-0.2.0-Linux-x64.AppImage

A checksum proves the file is the one that was published. It does not prove who published it: that is what code signing would add, and these files are not signed. The release process is prepared to sign with a certificate, but no certificate is configured.

Windows installer

File: AFTRIMGE-0.2.0-Windows-x64-Installer.exe

  • Installs for the current user only. It does not ask for administrator rights.
  • Installs the program to %LOCALAPPDATA%\AFTRIMGE, adds a Start menu entry and a desktop shortcut, and registers an uninstaller under Settings, Apps.
  • AFTRIMGE needs the Microsoft Edge WebView2 Runtime, which Windows 11 already includes. If it is missing, the installer downloads Microsoft's WebView2 bootstrapper and runs it. That download is the only network activity in the installation.
  • Your archive is created on first launch in %APPDATA%\com.aftrimge.desktop. See Data and storage.

Because the installer is unsigned, Windows SmartScreen may warn that the publisher is unknown. On a machine where Smart App Control is enforcing, Windows may block the installer outright. AFTRIMGE does not work around that policy.

Tested on Windows 11 Home 10.0.26200 (x64). Windows 10 has not been tested.

Uninstalling on Windows

Use Settings, Apps, AFTRIMGE, Uninstall. It removes the program, its Start menu entry, its desktop shortcut and its registration.

The uninstaller offers a checkbox, Delete the application data, which is unticked by default.

  • Left unticked, the program is removed and your archive stays in %APPDATA%\com.aftrimge.desktop. Installing AFTRIMGE again opens it.
  • Ticked, the archive is deleted: every recorded version, permanently. Copy the folder first if there is any chance you want it.

Windows portable

File: AFTRIMGE-0.2.0-Windows-x64-Portable.zip

Extract the whole folder anywhere you can write to, including a removable drive, and run AFTRIMGE.exe. Nothing is installed. The portable copy keeps everything beside itself. See Portable mode.

It needs the Microsoft Edge WebView2 Runtime to be present already. It does not download it.

Linux AppImage

File: AFTRIMGE-0.2.0-Linux-x64.AppImage

chmod +x AFTRIMGE-0.2.0-Linux-x64.AppImage
./AFTRIMGE-0.2.0-Linux-x64.AppImage
  • Runs without installation. It carries its own copy of the web engine and most libraries it needs.
  • Running an AppImage needs FUSE 2. On Ubuntu 24.04 that is the libfuse2t64 package.
  • It was built on Ubuntu 24.04 and needs a distribution whose C library is at least as new (glibc 2.39).
  • Your archive is created in ~/.local/share/com.aftrimge.desktop.

Tested on Ubuntu 24.04.4 LTS under WSL2 with WSLg. It has not been tested on other distributions or on a desktop Linux installation.

Linux Debian package

File: AFTRIMGE-0.2.0-Linux-x64.deb

sudo apt install ./AFTRIMGE-0.2.0-Linux-x64.deb

Installs system-wide and uses the WebKitGTK libraries of your distribution rather than bundled ones. Remove it with sudo apt remove aftrimge; the archive in your home directory is not touched.

Upgrading

A newer AFTRIMGE upgrades an existing archive in place the first time it opens it, when the newer release uses a newer database format. Before upgrading, it writes a copy of the database to backups/aftrimge-v<old>-to-v<new>-<timestamp>.db in the archive folder and checks that copy (an SQLite integrity check and its format version). If the copy cannot be made, for example because the disk is full, the database is not upgraded, nothing is changed, and AFTRIMGE shows why and does not start. The newest 3 of these backups are kept and older ones are removed; nothing else in backups/ is touched.

That backup covers the database only, not objects/. Copying the whole archive folder before upgrading is still the complete backup.

AFTRIMGE 0.2.0 uses the same database format (7) as the previous release, so upgrading from that release does not change the database and makes no backup.

An older AFTRIMGE refuses to open an archive written by a newer one and says so.

AFTRIMGE does not check for, download or install updates. A new version is installed over the old one.

Source: docs/INSTALL.md