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.6.0
Epic Online Services (EOS) — Phase 1: Online Authentication
🙏 Credit: The Epic Online Services integration in this release is a Java port of the work by the GameNative team, and is built on top of their research and reverse-engineering of Epic's launcher protocols. Massive thanks to utkarshdalal and the GameNative contributors. Specifically, this release ports the Phase 1 launch-arguments + sidecar/exchange-code work from their PR #1286 / commit `cbea7f7` ("Feat/eos overlay utkarsh"). Without GameNative we wouldn't have a roadmap for this — please go support the project: https://github.com/utkarshdalal/GameNative
- Online multiplayer in EOS-integrated Epic games now works. Games like Fall Guys that previously hit "Epic Games Account Error — No exchange code was found" now successfully authenticate to Epic Online Services.
- Behind the scenes: BannerHub injects the standard Epic launch arguments (`-EpicPortal`, `-epicusername`, `-epicuserid`, `-epicsandboxid`, `-epiclocale`) plus the AUTH triple (`-AUTH_LOGIN -AUTH_PASSWORD -AUTH_TYPE`) using a fresh exchange code fetched from Epic's account service per launch.
- Hooks the universal Wine-launch chokepoint, so it activates only for Epic-installed games — Steam, GOG, Amazon, and custom-imported games are completely unaffected.
Blue "EOS" badge in your Epic library
- Installed Epic games that ship the EOS SDK now show a blue EOS pill on both the library tile and the detail page, so you can see at a glance which games will use the integration.
- Detection runs automatically when a new Epic game finishes installing.
- For games installed before this update, tap the ↺ refresh button in the Epic library — BannerHub will scan all your installed Epic games and apply the badge where it belongs (with progress toasts).
Phase 2 — In-game EOS Overlay (NOT yet implemented)
- This release is Phase 1 only: online auth, exchange code, sidecar/deployment ID, library badge.
- Phase 2 — installing the EOS in-game overlay DLL (the Epic friends popup / notifications UI / achievement toasts) — is still pending. Multiplayer / online services / leaderboards / matchmaking all work without it; you just don't get the in-game UI chrome.
- Phase 2 work would also be ported from GameNative's PR #1286, which includes their `EpicOverlayManager`. Estimated 250-400 LOC plus a Wine prefix registry editor. Will land in a future BannerHub release.
Note for upgraders
EOS coverage scope. This release adds Epic Online Services authentication for online multiplayer / friends / leaderboards in EOS-integrated Epic games. The EOS in-game overlay (the friend popup that appears in-game with Shift+F3 in Epic Launcher) is NOT included — games still authenticate and play online; you just don't get the in-game friends UI.
Some Epic games have non-EOS dependencies. Brawlhalla bundles Ubisoft Connect; Firestone bundles Kongregate's launcher SDK. These games may still fail to fully connect to their backends even with EOS auth working — they need their respective third-party launchers running, which BannerHub doesn't emulate.
Pre-existing Epic installs auto-detect. Tap the Epic library ↺ refresh button once after upgrading and BannerHub will scan all your installed Epic games for EOS markers and apply the blue "EOS" badge automatically. No reinstall needed.
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.1`) 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,095 games · 3,425+ 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.