> [!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.4.1
External Storage (SD Card) support for GOG, Epic & Amazon
- New "Save Store Games to External Storage (SD Card)" toggle in the BannerHub side menu settings
- When enabled, GOG, Epic, and Amazon game downloads are saved to your SD card at
{SD card}/bannerhub/{store}/{game}/— visible as abannerhub/folder at the root of the SD card - When disabled, games save to internal app storage as before
- The install location is locked in at install time — toggling the switch after a game is installed will not affect where it uninstalls from. Each game always uninstalls from its original install location regardless of the current toggle state
- Turning the toggle on or off now shows a confirmation dialog explaining exactly what will change before applying anything
Install location display on game detail pages
- GOG, Epic, and Amazon detail pages now show the full install path in the ACTIONS card when a game is installed
- A colored pill badge indicates where the game is stored: 💾 SD Card (green) or 📁 Internal (grey)
- Path and badge are hidden when the game is not installed
System bars hidden across all store screens
- Status bar and navigation bar are now hidden across all GOG, Epic, and Amazon screens — store lists, game detail pages, download manager, Component Manager, and Component Download — so they no longer overlap buttons
Uninstall improvements
- A spinner dialog ("Uninstalling…") now appears immediately after confirming uninstall, covering the file-deletion delay before the completion toast
- Applied to all uninstall paths: game list, detail page, and download manager for all three stores
- GOG detail page uninstall now correctly uses the stored absolute path (consistent with the game list and download manager)
GOG install reliability
- Non-critical GOG CDN metadata files (
goggame-*.hashdb,.info,.ico,.script) no longer abort the install when their download fails — these files are cosmetic and skipped automatically
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.5.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 (see screenshot below).
Community game configs: the412banner.github.io/bannerhub-game-configs
920 games · 922+ 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.