Download Open Grind
Never download Open Grind from unofficial sources. The only official sources of Open Grind are https://git.opengrind.org/open-grind/open-grind/releases and Google Play. All releases are signed and reproducible.
🚧 Open Grind is in active development. 🚧
Contribute to the project or join the discussion to help us prioritize features and improvements.
Android
To install the APK, use your system's APK installer and optionally enable auto updates.
- Smaller APKs for one processor type: arm64-v8a (most phones), armeabi-v7a, x86_64, x86.
- Switching between Google Play and the APK (or F-Droid) requires uninstalling first, because Google signs its version with its own key. Uninstalling signs you out and resets app settings.
- Add-ons (Google sign-in, fast notifications, reCAPTCHA helper) can't be installed by the Google Play version. Install them from their pages: Sign in with Google, Notifications.
- To verify the Google Play version, follow Verify Google Play install.
Windows
Launch the installer and follow the steps.
- To install updates, enable the auto-updater.
- To uninstall, use the bundled uninstall.exe. Check "delete app data" to delete the session and preferences.
Linux
Notes:
- GPS is not available through the geolocation plugin on Linux
- Without a Secret Service your sign-in is kept in a plain file under the app data directory
- If the window stays blank, flickers, closes instantly or draws parts of the app wrong, see Rendering problems
AppImage (any distribution)
The AppImage runs on any distribution that has WebKitGTK 4.1.
Install WebKitGTK 4.1:
| Distribution | Package |
|---|---|
| Debian, Ubuntu | libwebkit2gtk-4.1-0 |
| Arch Linux | webkit2gtk-4.1 |
| Fedora | webkit2gtk4.1 |
| openSUSE | libwebkit2gtk-4_1-0 |
Make the AppImage executable and run it:
chmod +x open-grind-*.AppImage
./open-grind-*.AppImageIn GNOME Files, the same thing is Properties → Permissions → "Executable as Program".
- To play videos, install a H.264 decoder. See Install video codecs on Linux.
- To add a desktop entry, click App Settings → Display → "Show in apps menu".
- To install updates, enable the auto-updater.
- To uninstall, clear Open Grind's secrets from your Secret Service, then delete the AppImage.
deb (Debian, Ubuntu, Linux Mint, other Debian-based)
- To install updates, set up apt. Auto-updater is not available for deb releases.
- To uninstall, manually clear all secrets from your Secret Service, then run
apt purge.
apt repository
Debian, Ubuntu and derivatives can install Open Grind from the project's own repository, so apt handles updates:
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://git.opengrind.org/api/packages/open-grind/debian/repository.key \
| sudo tee /etc/apt/keyrings/opengrind.asc > /dev/null
sudo tee /etc/apt/sources.list.d/opengrind.sources > /dev/null <<'EOF'
Types: deb
URIs: https://git.opengrind.org/api/packages/open-grind/debian
Suites: beta
Components: main
Signed-By: /etc/apt/keyrings/opengrind.asc
EOF
sudo apt update && sudo apt install open-grindOpen Grind is still in beta, so every release so far is published to the beta suite. Once stable, use Suites: stable to track those instead. To remove the repository, delete both files.
Trust
The repository index is signed by a key held on the server. The release artifacts and their .minisig signatures stay the canonical, reproducible download — the repository only exists so updates arrive through your package manager.
Arch Linux
As of September 1st, 2026, AUR has disabled account registration and new package publishing, so it's not possible to install Open Grind from AUR right now.
The PKGBUILD for Arch Linux can be found in ci/aur/PKGBUILD.
Rendering problems
Window is drawn with WebKitGTK and your graphics driver. With some combinations, parts of the window draw wrong.
Update your system. WebKitGTK 2.54 fixed several scrolling glitches.
Try closing Open Grind, then launching from a terminal with one of these settings:
WEBKIT_SKIA_ENABLE_CPU_RENDERING=1if icons, images or text look broken. Blur works.WEBKIT_DMABUF_RENDERER_FORCE_SHM=1if the window flickers or turns black. Blur works.WEBKIT_DISABLE_DMABUF_RENDERER=1if rows disappear while you scroll, or if nothing else helps. Blur is turned off and scrolling is less smooth.
shWEBKIT_DISABLE_DMABUF_RENDERER=1 ./open-grind-*.AppImage
For the deb or Arch package, run WEBKIT_DISABLE_DMABUF_RENDERER=1 open-grind.
On NVIDIA, the launcher already sets __NV_DISABLE_EXPLICIT_SYNC=1, which fixes the "Error 71 (Protocol error)" crash on Wayland. If the window only flickers, try __NV_DISABLE_EXPLICIT_SYNC=0 before the settings above.
When you report a rendering problem, include your GPU and driver version, your WebKitGTK version, whether you use Wayland or X11, and which settings you tried.
macOS
Requires macOS 11.6 or later. Extract Open Grind.app from the zip archive and move it to the Applications folder. Open Grind updates itself in place, so it only runs from Applications.
- Updating from 0.1.0-beta.5.1 or earlier, macOS asks up to three times whether Open Grind may use what it saved in your keychain. Enter your Mac password and click "Allow" each time to stay signed in. If you deny, sign in again.
- To install updates, enable the auto-updater.
- To verify the download, follow Reproducibility → macOS.
- To uninstall, move the app from Applications to Trash. To also remove your data, delete the
org.opengrind.appfolders in~/Library/Application Support,~/Library/Cachesand~/Library/WebKit, and theorg.opengrind.appitems in Keychain Access.
Homebrew
Homebrew can install Open Grind from the project's own tap:
brew tap open-grind/tap https://git.opengrind.org/open-grind/homebrew-tap
brew trust open-grind/tap
brew install --cask open-grindAlways tap with the URL above. To uninstall, run brew uninstall --cask open-grind (add --zap to also delete your data, except the keychain items), then brew untap open-grind/tap.
iOS
iOS is currently not supported. Open Grind iOS builds are likely to be released in Fall 2026 with the upcoming publishing in the third party app stores.