> [!WARNING]
> **Only install official stable releases** (like this one). Do NOT install pre-releases or raw CI artifacts — pre-release builds use a different package name (com.tencent.ig) and cannot be upgraded to stable without uninstalling first.
Important
Notification permission required. BannerHub will prompt for the Post Notifications permission when you start your first Epic, GOG, or Amazon download. You must allow it to receive download progress and completion notifications. Without it, you will not be notified when downloads finish or fail.
Important
Files access required for SD card storage. To save games to your SD card, BannerHub must be granted the Files and Media permission. Go to Android Settings → Apps → BannerHub → Permissions → Files and media and set it to Allow management of all files (or equivalent on your device). Without this permission the SD card toggle will have no effect.
New since v3.5.0
SD card toggle decoupled from Steam
- The "Save Store Games to External Storage (SD Card)" toggle now affects only GOG, Epic, and Amazon downloads — Steam game installs are no longer touched by this toggle
- BannerHub uses its own SharedPreferences (`bh_storage_pref`) for store storage decisions, leaving GameHub's native Steam-storage prefs untouched
- One-time migration prompt on first GOG/Epic/Amazon library visit asks whether to switch Steam back to internal storage if you previously had the toggle on
Per-download speed picker
- New tappable Download speed row on the install confirmation dialog with five presets: Low (4 threads), Medium (8), High (16), Max (24), and Auto (CPU-derived)
- Default opens at Low to be conservative on CPU and battery — bump it up for faster downloads on a fast network
- Per-install only; every dialog opens fresh at Low. No global setting.
Epic CDN auto-ranking
- Epic downloads now HEAD-probe each CDN URL in parallel before chunk downloads start, then reorder by latency
- Particularly noticeable on networks where Epic's API-returned CDN order isn't optimal for your geography
Downloads screen UX improvements
- Active download cards now show the colored store badge (GOG / Epic / Amazon) the entire time, not just after the download completes
- Both downloading and completed cards are now tappable — opens that game's detail page
Other
- CI: build pipeline hardened to handle branch names containing `/`
Note for upgraders
Tap-to-open detail pages — pre-existing installs. Cards in the in-app downloads manager are now tappable. Games installed before upgrading to v3.6.0 may not have the metadata needed to launch directly into the game's specific detail page — tapping their cards may open the store's main library instead. New installs going forward have full detail-page support.
SD-card toggle is BannerHub-only. There is no separate Steam SD-card toggle in the BannerHub UI. Steam stays on whatever storage it currently uses; the migration prompt offers a one-time switch back to internal if you had Steam-on-SD via v3.5.0 or earlier.
Default download speed is Low. The new Download speed picker opens at Low (4 threads) — slower than the previous hardcoded behavior. Tap the row on the install dialog to bump it up.
Keeping BannerHub up to date with Obtainium
Use Obtainium to automatically track and install new BannerHub releases directly from GitHub.
BannerHub reports its own version number to Android (e.g. `3.6.0`) so Obtainium can correctly detect when a new release is available and prompt you to update.
When adding BannerHub in Obtainium, make sure "Reconcile version string with version detected from OS" is turned on.
Community game configs: the412banner.github.io/bannerhub-game-configs
1,088 games · 3,393+ configs — Growing collection of community-submitted Wine configs. Contributions welcome — every config shared helps others get their games running.
Installation
See the Installation section in the README for APK selection guidance and setup instructions.