Downloads

Verifying a download

Every available artifact above publishes a SHA-256. Recompute it on your machine and compare:

Linux / macOS:

shasum -a 256 grace-b2u_0.2.1-*-bpv_all.deb
shasum -a 256 grace-0.2.1-*-bpv-portable.zip

Windows PowerShell:

Get-FileHash .\grace-0.2.1-2026.06.01-bpv-setup.exe -Algorithm SHA256

The hash on the page must match the value the command prints. If they differ, the download was corrupted or tampered with — delete and re-download.

Install

Pick the section for the format you downloaded. The Grace desktop app makes no network calls on startup; everything below is one-shot.

Linux — .deb (Ubuntu / Debian / Mint)

Replace the filename below with whatever you downloaded — the ./ in front is required so apt treats it as a local file rather than a repository name.

cd ~/Downloads
sudo apt install ./grace-b2u_0.2.1-2026.06.01-bpv_all.deb

Verify the install landed:

dpkg -l grace-b2u
grace-b2u --help

Install fails with "Depends: python3 (>= 3.12) but 3.10… is to be installed"? Your distribution is older than Grace's minimum (Ubuntu 24.04 / Linux Mint 22 / Debian 13). See Help & Troubleshooting for the fix.

A "Grace" entry appears in your application menu once the install completes. The package and CLI command are named grace-b2u (not grace) to avoid colliding with the unrelated Debian "grace" package (xmgrace).

You may see "Notice: Download is performed unsandboxed as root … couldn't be accessed by user '_apt' … Permission denied". This is harmless and the install still completes: recent apt runs its file-fetch helper as the unprivileged _apt user, which cannot read inside your private home folder, so it falls back to reading the package as root. To avoid the message, install from a world-readable path — for example copy the file to /tmp first:

cp ~/Downloads/grace-b2u_0.2.1-2026.06.01-bpv_all.deb /tmp/
sudo apt install /tmp/grace-b2u_0.2.1-2026.06.01-bpv_all.deb

Linux — Flatpak (universal)

The single-file .flatpak bundle works on any Linux distribution with Flatpak installed (Ubuntu, Debian, Fedora, Arch, openSUSE, Linux Mint, etc.). Verify the SHA-256 first (see Verifying a download above), then:

cd ~/Downloads
flatpak install --user ./grace-0.2.1-2026.06.01-bpv.flatpak

Launch from your application menu, or from a terminal:

flatpak run app.grace.b2u.Grace

First-install prerequisite. The Flatpak runtime (org.kde.Platform//6.10) is downloaded from Flathub on first install. If your system is not already configured for Flathub, run once before installing:

flatpak remote-add --user --if-not-exists flathub \
    https://flathub.org/repo/flathub.flatpakrepo

Windows — installer (.exe)

Double-click grace-0.2.1-2026.06.01-bpv-setup.exe. Windows SmartScreen will warn on first run because the installer is unsigned during the pre-1.0 beta — click More info then Run anyway. Follow the wizard; the default install location is C:\Program Files\Grace.

The installer creates a Start Menu shortcut and a Desktop shortcut (optional during setup). Launch from either to start Grace.

Windows — portable (.zip)

Unzip grace-0.2.1-2026.06.01-bpv-portable.zip to any folder you can write to — your Documents, Desktop, a USB stick, anywhere. Double-click grace.exe inside the unzipped folder to launch. No install, no admin rights, no registry entries from the app itself (a few Qt window-state keys are still written to HKCU\Software\Grace Contributors\Grace when you close the app — see data locations).

macOS — .dmg

Coming soon The macOS .dmg is in beta but not yet published. When it ships:

1. Double-click the .dmg to mount it.
2. Drag Grace to your /Applications folder.
3. First launch: right-click → Open, then confirm. Gatekeeper warns about an unidentified developer during the unsigned pre-1.0 beta; standard double-click launches will work once you've opened it once via the right-click path.

Update to a new version

Beta-preview builds keep the same upstream version (0.2.1) and encode the build date in the filename. Same-version reinstalls are forced explicitly below; once the project moves to 0.2.2 the package manager will pick up new versions automatically.

Linux — .deb

Download the newer .deb from the table above, then:

cd ~/Downloads
sudo apt install --reinstall ./grace-b2u_0.2.1-NEW-DATE-bpv_all.deb

Your preferences, database, notes, and audit logs stay put — they live outside the package's tracked files.

Windows — installer

Download and run the newer -setup.exe. The NSIS installer detects the existing install and overwrites it in place; your data under %APPDATA%\Grace Contributors\Grace stays untouched. No need to uninstall the previous version first.

Windows — portable

Unzip the new -portable.zip to a fresh folder, copy or move any per-folder state you care about, then delete the old folder. Your application data is in %APPDATA%\Grace Contributors\Grace (per-user, not inside the portable folder), so it's already shared between the two installations.

macOS — .dmg

Coming soon Replace the /Applications/Grace.app bundle with the one from the new .dmg. Your data in ~/Library/Application Support/Grace stays put.

Linux — Flatpak

Grace is distributed as a single-file .flatpak bundle directly from this site, not via Flathub. As a result:

• flatpak update will not pull new versions of Grace — there is no remote for it to poll. To update, download the newer .flatpak from the table above and re-run the install command:

  flatpak install --user grace-0.2.1-NEW-DATE-bpv.flatpak

• Your per-user application data under ~/.var/app/app.grace.b2u.Grace/ is not touched by reinstall and survives the upgrade.

First-install prerequisite. The Flatpak runtime (org.kde.Platform//6.10) is downloaded from Flathub on first install. If your system is not already configured for Flathub, run once before installing:

flatpak remote-add --user --if-not-exists flathub \
    https://flathub.org/repo/flathub.flatpakrepo

Where Grace stores your data

Knowing these paths lets you back up your study data, migrate it to a new machine, or wipe it completely. Grace never stores data anywhere except your own user account; nothing is sent to a server.

Flatpak: the sandbox keeps the app's database, preferences, and logs under ~/.var/app/app.grace.b2u.Grace/, but your Notes and downloaded content use your real ~/Documents/Grace/… folders (the Flatpak ships with the narrow xdg-documents permission). Do not copy files into the Flatpak's install directory — that bundled data is read-only and is erased on every update. See Help & Troubleshooting.

Remove Grace, keep your study data

This removes the application and its menu entries but leaves your preferences, databases, notes, and logs in place. Reinstalling later picks back up exactly where you left off.

Linux — .deb

sudo apt remove grace-b2u

Drops /opt/grace-b2u/, /usr/bin/grace-b2u, the menu shortcut at /usr/share/applications/grace-b2u.desktop, and the icon-theme entries under /usr/share/icons/hicolor/*/apps/app.grace-b2u.Grace.png. Your user data under ~/.config/, ~/.local/, ~/.cache/, and ~/Documents/Grace/ is untouched.

Linux — Flatpak

flatpak uninstall --user app.grace.b2u.Grace

Removes the app, its application-menu entry, and its sandbox runtime. Your per-user app data under ~/.var/app/app.grace.b2u.Grace/ and your notes library at ~/Documents/Grace/Notes/ both stay put — reinstalling later picks back up exactly where you left off.

Windows — installer

Settings → Apps → Installed apps → Grace → Uninstall. The NSIS uninstaller removes C:\Program Files\Grace and the Start Menu / Desktop shortcuts. Your data under %APPDATA%\Grace Contributors\Grace and %LOCALAPPDATA%\Grace Contributors\Grace stays put, as does the registry key with your window-layout preferences.

Windows — portable

Delete the folder you unzipped the portable into. There's nothing else to remove on the application side — no Start Menu entry was created, no registry installer keys exist. Your data in %APPDATA%\Grace Contributors\Grace stays put.

macOS — .dmg

Coming soon Drag /Applications/Grace.app to the Trash, then empty the Trash. Your data under ~/Library/Application Support/Grace, ~/Library/Preferences/app.grace-b2u.Grace.plist, and ~/Documents/Grace stays put.

Remove Grace and all your data

Linux — .deb

sudo apt purge grace-b2u
rm -rf ~/.config/Grace \
       ~/.config/"Grace Contributors" \
       ~/.local/share/Grace \
       ~/.local/state/Grace \
       ~/.cache/Grace \
       ~/Documents/Grace

If you previously ran the project under its old name (I2CU, pre-2026-05-03), also remove ~/.config/i2cu/, ~/.local/share/i2cu/, and ~/.local/state/i2cu/.

Linux — Flatpak

flatpak uninstall --user --delete-data app.grace.b2u.Grace
rm -rf ~/Documents/Grace

--delete-data wipes the sandboxed per-user data under ~/.var/app/app.grace.b2u.Grace/. The second command removes your notes library (the Flatpak has xdg-documents filesystem access, so notes live on the host outside the sandbox).

Windows — installer

First uninstall via Settings → Apps → Grace → Uninstall (same as the keep-data flow above). Then, in PowerShell:

Remove-Item -Recurse -Force "$env:APPDATA\Grace Contributors"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Grace Contributors"
Remove-Item -Recurse -Force "$env:USERPROFILE\Documents\Grace"
Remove-Item -Path "HKCU:\Software\Grace Contributors" -Recurse -Force

Windows — portable

Delete the unzipped portable folder, then run the four PowerShell commands above. The data paths are the same for both Windows distributions — portable and installer share per-user data.

macOS — .dmg

Coming soon Drag /Applications/Grace.app to Trash, then in Terminal:

rm -rf "$HOME/Library/Application Support/Grace"
rm -rf "$HOME/Library/Caches/Grace"
rm -rf "$HOME/Library/Logs/Grace"
rm -f  "$HOME/Library/Preferences/app.grace-b2u.Grace.plist"
rm -rf "$HOME/Documents/Grace"