// OPENBOX DOCS

Downloads

Every way to install OpenBoxGL 3.0, with verification steps per method.

Downloads

One table for every install method. Pick the row that matches your system, then follow its verify step. All methods install the same OpenBox application, currently v3.0.0 (2026-11-19).

MethodBest forUpdatesVerify
AppImage with installerLinux desktop, Steam Deck, handhelds, immutable systemsBuilt-in verified updateropenbox-release.pub Ed25519 plus SHA-256 checksum
AppImage manualOffline or custom pathManual re-downloadchmod +x, then ./OpenBox-$(uname -m).AppImage --web prints the server URL
FlatpakSandboxed installsFlatpak workflowflatpak info io.openbox.GameLauncher
From sourceDevelopment, patchinggit pull and rebuildcargo build --release --locked -p openbox-cli, then ./openbox.sh
System installInstall to /usr/localsudo make install againopenbox --web prints the server URL
Windows portable with installerWindows 10 and 11, x86_64 or ARM64Re-run install.ps1 from the new releaseinstall.ps1 Ed25519 plus SHA-256 checksum
macOS app bundlemacOS 11 or newer, Apple Silicon or IntelRe-run install-macos.sh --replace from the new releaseinstall-macos.sh verifies the release key, SHA-256, and Ed25519 signature

Every 3.0 release publishes these artifacts:

AssetArchitectureType
install.shanyLinux release installer (bash)
install.ps1anyWindows release installer (PowerShell 5.1), run from the extracted release archive
install-macos.shanymacOS release installer (bash), run with the tag pinned
verify_release.pyanyRelease signature verifier that install-macos.sh runs
openbox-release.pubanyEd25519 release public key
OpenBox-x86_64.AppImagex86_64AppImage (9.7 MiB), signed
OpenBox-x86_64.AppImage.sha256x86_64SHA-256 checksum sidecar
OpenBox-x86_64.AppImage.sigx86_64Ed25519 signature sidecar
OpenBox-x86_64.AppImage.zsyncx86_64zsync delta-update metadata
OpenBox-aarch64.AppImageARM64AppImage (9.0 MiB), signed
OpenBox-aarch64.AppImage.sha256ARM64SHA-256 checksum sidecar
OpenBox-aarch64.AppImage.sigARM64Ed25519 signature sidecar
OpenBox-aarch64.AppImage.zsyncARM64zsync delta-update metadata
OpenBox-x86_64.flatpakx86_64Flatpak bundle (7.1 MiB)
OpenBox-x86_64-windows.zipx86_64Windows portable (14.6 MiB), signed
OpenBox-x86_64-windows.zip.sha256x86_64SHA-256 checksum sidecar
OpenBox-x86_64-windows.zip.sigx86_64Ed25519 signature sidecar
OpenBox-x86_64-windows-native-host.exex86_64WebView2 window host, signed
OpenBox-x86_64-windows-native-host.exe.sha256x86_64SHA-256 checksum sidecar
OpenBox-x86_64-windows-native-host.exe.sigx86_64Ed25519 signature sidecar
OpenBox-arm64-windows.zipARM64Windows portable (13.8 MiB), signed
OpenBox-arm64-windows.zip.sha256ARM64SHA-256 checksum sidecar
OpenBox-arm64-windows.zip.sigARM64Ed25519 signature sidecar
OpenBox-arm64-windows-native-host.exeARM64WebView2 window host, signed
OpenBox-arm64-windows-native-host.exe.sha256ARM64SHA-256 checksum sidecar
OpenBox-arm64-windows-native-host.exe.sigARM64Ed25519 signature sidecar
OpenBox-macos.zipUniversal (arm64 and x86_64)macOS app bundle (17.4 MiB), ad-hoc signed, with a signed release
OpenBox-macos.zip.sha256UniversalSHA-256 checksum sidecar
OpenBox-macos.zip.sigUniversalEd25519 signature sidecar
OpenBox-3.0.0-sbom.jsonx86_64SBOM (CycloneDX 1.4)
OpenBox-3.0.0-aarch64-sbom.jsonARM64SBOM (CycloneDX 1.4)
OpenBox-3.0.0-macos-sbom.jsonUniversalSBOM (CycloneDX 1.4)
OpenBox-3.0.0-arm64-windows-sbom.jsonARM64SBOM (CycloneDX 1.4)

The Windows archive ships with the same .sha256 sidecar and .sig signature as the AppImages, verified by install.ps1; the in-app update check uses the Rust verifier. The native-host executable is the same binary that archive carries, published on its own for source checkouts, and it goes through the same checksum and signature ladder.

The macOS bundle is signed the same way. install-macos.sh verifies its SHA-256 checksum and Ed25519 signature before it installs it. The bundle is also ad-hoc signed, so macOS asks you to allow it on first launch.

The installer pins the release public key, verifies the SHA-256 checksum, and verifies the Ed25519 signature before installing to ~/.local/bin.

VERSION=3.0.0
curl --proto '=https' --tlsv1.2 --fail --location \
  --output install.sh \
  "https://github.com/vindeckyy/OpenBoxGL/releases/download/v${VERSION}/install.sh"
less install.sh
OPENBOX_RELEASE_TAG="v${VERSION}" bash install.sh

To launch right after installing:

OPENBOX_RELEASE_TAG="v${VERSION}" bash install.sh --run

Install to a different directory with OPENBOX_INSTALL_DIR, for example OPENBOX_INSTALL_DIR="$HOME/Applications". Omit OPENBOX_RELEASE_TAG only when you intend to track the latest stable release.

The installer selects the AppImage that matches uname -m. Override detection for a packaging or emulation environment with OPENBOX_ARCH=x86_64 or OPENBOX_ARCH=aarch64.

Manual download:

chmod +x OpenBox-$(uname -m).AppImage
./OpenBox-$(uname -m).AppImage
./OpenBox-$(uname -m).AppImage --web

Windows portable with installer

Windows 10 and 11 on x86_64 or ARM64 install from a signed portable archive. Download the archive, extract it, and run the bundled installer. The installer resolves and pins the release public key, verifies the archive's SHA-256 checksum and its Ed25519 signature, and only then extracts the runtime to %LOCALAPPDATA%\OpenBox\share\openbox.

$Version = '3.0.0'
Invoke-WebRequest -UseBasicParsing -OutFile OpenBox-x86_64-windows.zip `
  "https://github.com/vindeckyy/OpenBoxGL/releases/download/v$Version/OpenBox-x86_64-windows.zip"
Expand-Archive OpenBox-x86_64-windows.zip -DestinationPath .
Get-Content .\OpenBox\scripts\install.ps1   # read it before running it
powershell -ExecutionPolicy Bypass -File .\OpenBox\scripts\install.ps1 -Tag "v$Version"

The install.ps1 release asset is the same installer that ships inside the archive, and it needs the release verifier (updates.py) one directory above it. The verifier is the trust anchor for the Ed25519 check, so it is never downloaded on its own — run the script from the extracted release, where updates.py sits one directory above it.

To launch right after installing, add -Run. Install to a different directory with -InstallDir, or skip the user PATH edit with -NoPathUpdate. The installer requires Windows PowerShell 5.1 and Python 3.11 or newer on PATH; it needs neither curl nor OpenSSL, because signature verification uses the same standard-library RFC 8032 implementation as the in-app update check. The portable runtime does not need Python: OpenBox\openbox.cmd launches the bundled openbox-server.exe.

It keeps the previous runtime at share\openbox.previous, registers the Start Menu shortcut and the openbox:// protocol handler, and adds the runtime folder to your user PATH. The release publishes three installers (install.sh, install.ps1, and install-macos.sh) plus verify_release.py and openbox-release.pub. The uninstaller is not a release asset: it ships inside the zip and inside the install tree, so you run it from scripts\uninstall.ps1 under your install directory (for a default install, %LOCALAPPDATA%\OpenBox\share\openbox\scripts\uninstall.ps1). It removes exactly what this installer created — the install tree, the PATH entry, the shortcut, and the openbox:// registration — and never touches your library. See Windows for the launcher ladder, the WebView2 native window, and the full uninstall procedure.

macOS app bundle

macOS 11 or newer on Apple Silicon or Intel installs from the signed universal app bundle. The installer pins the release key, verifies the bundle's SHA-256 checksum and Ed25519 signature, and installs OpenBox.app into ~/Applications:

VERSION=3.0.0
curl --proto '=https' --tlsv1.2 --fail --location \
  --output install-macos.sh \
  "https://github.com/vindeckyy/OpenBoxGL/releases/download/v${VERSION}/install-macos.sh"
less install-macos.sh
OPENBOX_RELEASE_TAG="v${VERSION}" bash install-macos.sh

The bundle ships the universal Rust openbox-server and the WKWebView host with zero bundled Python, so the app needs nothing installed to run. The installer needs curl, shasum, ditto, and python3 3.11 or newer on PATH. It refuses to replace an existing OpenBox.app unless you pass --replace. The bundle is not notarized, so the first launch asks you to allow it in System Settings > Privacy & Security > Open Anyway. See macOS for the native window, updates, data location, and what is hidden on macOS.

Flatpak

Install the published bundle directly — no build step needed:

curl --proto '=https' --tlsv1.2 --fail --location \
  --output OpenBox-x86_64.flatpak \
  "https://github.com/vindeckyy/OpenBoxGL/releases/download/v3.0.0/OpenBox-x86_64.flatpak"
flatpak install --user --bundle OpenBox-x86_64.flatpak
flatpak run io.openbox.GameLauncher

Or build from the project's manifest with flatpak-builder:

git clone https://github.com/vindeckyy/OpenBoxGL.git
cd OpenBoxGL
cargo build --release --locked -p openbox-cli
cp target/release/openbox-server .
flatpak-builder --user --install --force-clean build-dir io.openbox.GameLauncher.yml
flatpak run io.openbox.GameLauncher

The manifest targets the GNOME Flatpak runtime (org.gnome.Platform 51) and grants --filesystem=home, so Steam, Heroic, Lutris, and ROM folders under home remain readable. The Flatpak is not updated by the built-in updater. Rebuild or reinstall the bundle to update.

From source

git clone https://github.com/vindeckyy/OpenBoxGL.git
cd OpenBoxGL
cargo build --release --locked -p openbox-cli
./openbox.sh

Requirements: Rust 1.92 or newer (the pinned toolchain is 1.99.1) with standard desktop tooling. On Linux the native window additionally needs WebKitGTK 4.1, and make native-host builds native_host. On macOS the native window uses WKWebView, which ships with the OS. No Python is required for the Rust server. The Python fallback (OPENBOX_BACKEND=python python3 web_app.py) requires Python 3.11 or newer. See .env.example for optional local configuration, never commit secrets.

System install

make build-rust
sudo make install
openbox          # native window, default
openbox --web    # headless Rust server on loopback

Prerequisites

RequirementAppImageFlatpakSourceWindowsmacOS app bundle
Linux desktop, X11 or WaylandYesYesYesNot applicableNot applicable
glibc 2.35 or newerYesNot applicableYesNot applicableNot applicable
Windows 10 or 11, x86_64 or ARM64Not applicableNot applicableNot applicableYesNot applicable
macOS 11 or newer, Apple Silicon or IntelNot applicableNot applicableNot applicableNot applicableYes
WebKitGTK for native windowBundledBundledRequired, libwebkit2gtk-4.1Not usedNot used
WebView2 runtime for native windowNot usedNot usedNot usedRequired by native_host.exe; already present on Windows 11 and most Windows 10Not used
WKWebView for native windowNot usedNot usedNot usedNot usedBuilt in
Rust toolchainNot neededNot needed1.92+Only to build from sourceOnly to build from source
PythonNot required; python3 3.11+ only for .py pluginsNot required; python3 3.11+ only for .py plugins3.11+ only for OPENBOX_BACKEND=python3.11+ only for install.ps1 and .py pluginsNot required to run; python3 3.11+ for install-macos.sh and .py plugins
flatpak and flatpak-builderNot neededRequiredNot neededNot neededNot needed
gitNot neededNot neededRequiredNot neededNot needed
FUSE to mount AppImagesRequiredNot neededNot neededNot applicableNot applicable
bubblewrap bwrapOptional, plugins sandboxed when presentBundled checkOptionalNot applicableNot applicable

See Installation for prerequisites in detail, Updating for the update flow and rollback, and Getting started for the first import. v3.0.0 publishes signed x86_64 and aarch64 AppImages, an x86_64 Flatpak bundle, signed x86_64 and ARM64 Windows portable archives, and a signed universal macOS app bundle.