BannerHub v3.5.0

> [!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 a bannerhub/ 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.

BannerHub v3.4.1

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.

New since v3.4.0

Hotfix — Frontend Export option missing from game settings menu

• Frontend Export was not appearing in the per-game settings menu in v3.4.0, despite the feature being fully built and working
• Root cause: the stable build workflow (build.yml) was missing the smali injection that adds the Frontend Export option to GameDetailSettingMenu — it was only present in the pre-release workflow (build-quick.yml), so the option showed correctly in every pre-release but silently disappeared when the stable APK was built
• Fixed by adding the missing option block to the stable workflow; the dialog (Beacon / ES-DE export) is otherwise unchanged

---

Keeping BannerHub up to date with Obtainium

Use Obtainium to automatically track and install new BannerHub releases directly from GitHub.

Starting with v3.4.0, BannerHub reports its own version number to Android (e.g. 3.4.1) instead of the base GameHub version — this means Obtainium can now 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). This tells Obtainium to compare the GitHub release tag against the version installed on your device so updates are detected correctly.

---

Community game configs: the412banner.github.io/bannerhub-game-configs
885 games · 2,325+ 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.

BannerHub v3.4.0

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.

New since v3.3.0

ES-DE frontend export

• Frontend Export dialog now lists both Beacon and ES-DE as export targets
• Selecting ES-DE writes {gameName}.steam to Downloads/bannerhub/frontend/ES-DE/ — same resolved game ID logic as Beacon (localGameId for imports, Steam App ID for catalog games)
• Dialog now shows the base output path above the frontend list so you know where the file will land before selecting
• If a .steam file does not work for a specific game, RobZombie9043/steam-files-es-de maintains a community fallback library

Dynamic versioning

• Android now displays the BannerHub version (e.g. 3.4.0) instead of the base GameHub version
• Game setting profiles automatically embed the BH version at export time
• Version is injected automatically from the git tag at build time — no manual bumping required
• GameHub continues to phone home as 5.3.5 regardless of displayed version

---

Keeping BannerHub up to date with Obtainium

Use Obtainium to automatically track and install new BannerHub releases directly from GitHub.

Starting with v3.4.0, BannerHub reports its own version number to Android (e.g. 3.4.0) instead of the base GameHub version — this means Obtainium can now 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). This tells Obtainium to compare the GitHub release tag against the version installed on your device so updates are detected correctly.

---

Community game configs: the412banner.github.io/bannerhub-game-configs
882 games · 2,325 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.

v3.3.0

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.

New since v3.2.0

Background download service

• Downloads for Epic, GOG, and Amazon now run in a persistent foreground service — leaving the store screen no longer interrupts an active download
• A progress notification appears while downloading with a Cancel action; a completion notification fires when done
• Downloads started from either the game list or the detail screen both route through the service

In-app download manager

• New ⬇ button in each store's header opens the cross-store download manager
• Shows live progress for all active downloads across Epic, GOG, and Amazon simultaneously
• Completed downloads are saved to a persistent library — rows show store badge, Launch, Uninstall, and × remove
• Clear ✓ button to dismiss all completed entries at once

Dashboard download shortcut

• The BCI quick-launch button on the BannerHub dashboard is replaced with a direct shortcut to the download manager
• Button shows a live red count badge (e.g. ⬇ 2) when downloads are active, updating in real time as jobs start and finish — returns to plain ⬇ when idle

Download manager bug fixes

• Uninstalling a game inside the download manager now immediately refreshes the game list on return — no more stale installed state
• Cancelling or erroring a download now correctly shows the Uninstall button on the detail screen so partial game folders can be cleaned up without reopening the screen
• GOG Launch from the download manager no longer closes the download manager activity
• Amazon Launch from the download manager now correctly sets the pending launch exe key

---

Community game configs: the412banner.github.io/bannerhub-game-configs
858 games · 2,226 configs — Growing collection of community-submitted Wine configs. Contributions welcome — every config shared helps others get their games running.

Installation

Install the APK matching your device CPU:

• arm64-v8a — most modern Android phones (64-bit ARM)
• x86_64 — x86 devices / some emulators

BannerHub can coexist with the original GameHub app (different package name).

Bannerhub v3.2.0

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.

New since v3.1.0

Expanded config detail screen

• Config detail card now shows up to 11 rows (was 4)
• Added: Wine / Proton, DXVK, VKD3D, GPU Driver, FEXCore, Box64, Resolution, Command Line, Env Vars
• All new rows are conditional — only shown if the field is present in the config

Frontend Export

• New Frontend Export option in the PC game settings popup (alongside Import/Export Config)
• Tapping opens a frontend list; selecting Beacon creates Downloads/bannerhub/frontend/Beacon/{gameName}.iso containing the game ID
• Automatically uses the correct ID: localGameId for imported games, Steam App ID for catalog games

Beacon integration fixes

• Launching a game via Beacon no longer creates a second BannerHub entry in Android recents
• Beacon .iso files now contain the correct Steam App ID for catalog games

---

Community game configs: the412banner.github.io/bannerhub-game-configs
854 games · 1,148 configs — Growing collection of community-submitted Wine configs. Contributions welcome — every config shared helps others get their games running.

Installation

Install the APK matching your device CPU:

• arm64-v8a — most modern Android phones (64-bit ARM)
• x86_64 — x86 devices / some emulators

BannerHub can coexist with the original GameHub app (different package name).

Bannerhub v3.1.0

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.

New since v3.0.0

Full-screen game detail pages (GOG, Epic, Amazon)

• Game detail dialogs replaced with dedicated full-screen activities
• Shows cover art, description (HTML-stripped), install size, release date (GOG + Epic)
• GOG shows community ratings

Update checker (GOG, Epic, Amazon)

• Check for Updates button compares installed build vs live version
• Update Now re-runs the install pipeline in-place
• Baseline auto-sets on first check if version was never stored

DLC management (GOG, Epic, Amazon)

• DLC section in each game detail page — list, install, and uninstall individual DLCs

Cloud saves (GOG + Epic)

• Browse to pick a local save folder using the in-app folder picker (root dropdown + New Folder)
• Upload Saves — pushes only files newer than the cloud version
• Download Saves — fetches all cloud files, overwrites local copies
• GOG uses a game-scoped token (clientSecret exchange) for cloudstorage API
• Folder selection persists per-game across sessions

Epic free games redesign

• Dedicated full-screen FreeGamesActivity with cover art and claim flow

---

Community game configs: the412banner.github.io/bannerhub-game-configs
Growing collection of community-submitted Wine configs. Contributions welcome — every config shared helps others get their games running.

Installation

Install the APK matching your device CPU:

• arm64-v8a — most modern Android phones (64-bit ARM)
• x86_64 — x86 devices / some emulators

BannerHub can coexist with the original GameHub app (different package name).

BannerHub v3.0.0

⚠️ Install stable releases only. Do not install pre-release builds or CI artifacts — they are untested snapshots used for development. Only stable releases (like this one) are debugged and verified across devices.

New since v2.9.3

• Config metadata — exported configs now tagged with app_source="bannerhub" for community config site filtering and source-based purge

Config Cross-Compatibility with BannerHub Lite

Configs exported from BannerHub are fully compatible with BannerHub Lite, and vice versa.

Why it works: Both apps are built on the same GameHub engine. Per-game Wine settings are stored in SharedPreferences under the same keys (pc_g_setting<gameId>). The Export feature reads those keys and writes them to a JSON file. The Import feature reads that same JSON and writes the keys back — the app that originally exported it doesn't matter.

How to transfer: Export a config in one app (saved to /sdcard/BannerHub/configs/), copy the JSON to the same folder on the device running the other app, then Import it from the game's settings menu. The same folder path is used by both apps intentionally so configs are found automatically without moving files.

The app_source field in the JSON is only used by the community config site to filter by origin — it has no effect on import behavior.

💬 Community game configs: Share and download per-game settings at the412banner.github.io/bannerhub-game-configs. The library grows with every contribution.

Installation

9 APK variants are built — pick the one matching your existing GameHub installation:

• Normal / Normal(GHL) — banner.hub / gamehub.lite
• PuBG — com.tencent.ig
• AnTuTu / alt-AnTuTu — com.antutu.ABenchMark / com.antutu.benchmark.full
• PuBG-CrossFire — com.tencent.tmgp.cf
• Ludashi — com.ludashi.aibench
• Genshin — com.miHoYo.GenshinImpact
• Original — com.xiaoji.egggame

Uninstall your existing GameHub before installing — BannerHub is signed with a different certificate and cannot update over the original.

Bannerhub v2.9.3

Warning

Only install official stable releases (like this one). Do NOT install pre-releases or workflow artifacts — they are untested builds that may be unstable, crash, or corrupt your game configurations.

New since v2.9.2

• Fix: Export/Import Config showed 0 settings, 0 components for all games
  Previously, the Export and Import Config buttons always reported settings_count: 0 and components_count: 0 in the JSON file. Root cause: the gameId was always passed as integer 0 instead of resolving to the correct SharedPreferences key. Now uses GameHub's own resolution logic — catalog games use their integer ID string (e.g. "271590"), locally-added games use their UUID string (e.g. "local_5f129d63-...").

• Fix: GOG Akamai CDN chunk URL construction
  Chunk URLs with Akamai CDN endpoints were being built incorrectly, causing download failures for affected GOG titles.

• Fix: Genshin Impact package name case
  Corrected package name to com.miHoYo.GenshinImpact (mixed case) — the previous lowercase variant failed to detect the installed game.

---

Community Game Configs — the412banner.github.io/bannerhub-game-configs
525 games · 1,071 configs — Share and import community-tested configurations for your games. The library grows with every contribution — if a config works well for you, upload it and help others.

Installation

Download the APK that matches your existing GameHub package name from the latest release:

APK	Package	App Label
BannerHub-vX.Y.Z-Normal.apk	banner.hub	BannerHub
BannerHub-vX.Y.Z-Normal.GHL.apk	gamehub.lite	BannerHub
BannerHub-vX.Y.Z-PuBG.apk	com.tencent.ig	BannerHub PuBG
BannerHub-vX.Y.Z-AnTuTu.apk	com.antutu.ABenchMark	BannerHub AnTuTu
BannerHub-vX.Y.Z-alt-AnTuTu.apk	com.antutu.benchmark.full	BannerHub AnTuTu
BannerHub-vX.Y.Z-PuBG-CrossFire.apk	com.tencent.tmgp.cf	BannerHub PuBG CrossFire
BannerHub-vX.Y.Z-Ludashi.apk	com.ludashi.aibench	BannerHub Ludashi
BannerHub-vX.Y.Z-Genshin.apk	com.mihoyo.genshinimpact	BannerHub Genshin
BannerHub-vX.Y.Z-Original.apk	com.xiaoji.egggame	BannerHub Original

Which APK do I need?

If you do not already have any GameHub variant installed, use the Normal APK (banner.hub). It installs as a completely separate app alongside the official GameHub Lite — both can coexist. If you want BannerHub to take over the gamehub.lite package slot (e.g. so apps that launch GameHub Lite by package name launch BannerHub instead), use Normal.GHL — but you must uninstall the official GameHub Lite first since they share the same package name and have different signing certificates. If you want to use a specific GameHub variant for performance spoofing (e.g. PuBG or Genshin), pick the matching APK. Be aware: performance spoofing variants push your device harder and generate significantly more heat. Do not use these variants without proper cooling and a clear understanding of what you are doing. Use at your own risk.

All 9 variants can be installed simultaneously. All APKs are signed with AOSP testkey (v1/v2/v3).

Note: You must uninstall your existing BannerHub build before installing a new release if the signing certificate changed. Data is not preserved across uninstall.

Bannerhub v2.9.2

⚠️ Only install stable releases (like this one). Do NOT install pre-releases or CI artifacts — they are untested intermediate builds and may be broken or incomplete.

New since v2.9.1

• Fix: imported GPU driver now applies correctly at launch — configs exported from other devices stored the GPU driver display label as the component name. On import this caused the EmuComponents lookup to fail silently, so the game launched without the GPU driver even though all other settings applied correctly. After downloading the GPU driver component, BannerHub now detects the actual registered component name from the filesystem and corrects the game settings entry automatically. Manual re-selection is no longer needed.
• Fix: exported configs only include components selected for that game — previously, all BannerHub-injected components a user had installed could appear in an exported config, prompting unnecessary downloads on import. Exports now only include components actually selected for the specific game being exported.

📋 Community game configs — 364 configs across 227 games
Browse, download, and share per-game Wine/DXVK/component configurations at the412banner.github.io/bannerhub-game-configs — the community grows with every contribution.

Installation

Download the APK matching your GameHub package name:

APK	Package
BannerHub-v2.9.2-Normal.apk	banner.hub (fresh install / standalone)
BannerHub-v2.9.2-Normal.GHL.apk	gamehub.lite
Other variants	PuBG / AnTuTu / CrossFire / Ludashi / Genshin / Original

All 9 variants can coexist simultaneously. The Normal APK installs alongside official GameHub Lite without conflict.

---

To those celebrating Easter this weekend — Happy Easter! To everyone else, hope you're having a great Sunday regardless.

Base APK

Base APK for CI builds (Gamehub 5.3.5 ReVanced, 136MB)