BannersComponentInjector

An external component manager for GameHub (Lite) and its variants — no root required.

-ONLY FOR VERSIONS WITH FILES ACCESS PATCHED INTO THEM!

BannersComponentInjector lets you browse, back up, replace, and restore the Windows-emulation components inside GameHub app variants (DXVK, VKD3D-Proton, Box64, FEXCore, Wine, GPU Drivers, and more) directly from your Android device. Components can be installed from local files or fetched and downloaded straight from online repositories — all without needing root access or a PC.

---

Video Tutorial — How to Set Up & Use

▶ Watch on YouTube: https://youtu.be/vVAkRjtW9Gk?si=KY-0ujAoaq2zhdvK

---

Table of Contents

• Features
• Supported Apps
• Installation
• How to Set Up
• How to Use
  • Inject Components Tab
    • Backing Up a Component
    • Replacing a Component — Local File
    • Replacing a Component — From My Downloads
    • Replacing a Component — Online Sources
    • Restoring a Component
  • Download Components Tab
    • Cross-Repo Search
    • Batch Downloads
    • Managing Repositories
    • Reordering Repositories
    • Adding a Custom Repository
    • Editing a Repository
    • Exporting Your Repo List
    • Importing a Repo List
  • My Downloads Tab
  • My Games Tab
  • Backup Manager
  • In-App Updates
  • Theme Customization
• Supported Component Formats
• Online Sources
• Settings
• Requirements
• Building from Source

---

Features

Core

• No root required — uses Android's Storage Access Framework (SAF) for secure folder access.
• Single data/ grant — one SAF permission at <package>/data covers components, virtual containers, and shadercache simultaneously.
• Multi-app support — automatically detects all installed GameHub variants side by side.
• Accurate GameHub detection — borrowed package names (shared with PUBG Mobile, Genshin Impact, AnTuTu, etc.) are verified against the app's display label so real apps are never mistaken for GameHub variants.
• Custom app entries — add any GameHub variant not in the built-in list by entering a display name and package name.
• Fast streaming scanner — components appear progressively as folders are found, with a live "Loading X / Y" counter. Parallel scanning with semaphore limiting keeps load times fast even on large component trees.
• Four-tab layout — Inject Components, Download Components, My Downloads, and My Games (opt-in).
• Landscape NavigationRail — in landscape orientation the top tab row is replaced by a navigation rail on the left side of the screen; content fills the remaining space to the right.

Inject Components

• Backup — back up any component folder to Downloads/BannersComponentInjector/<componentName>/ (or a custom location).
• Replace from local file — pick a .wcp or .zip from your device and inject it into the component folder.
• Replace from My Downloads — inject any file you've previously downloaded directly, without using the file picker.
• Replace from online source — cross-repo search or drill-down browse; file detail sheet with Release Notes; "Download & Replace" injects directly without leaving the app.
• Restore — restore any component to its backed-up state with one tap.
• Replacement notes — the component list remembers what each folder was last replaced with; cleared automatically on restore.
• Backup warning — warns before replacing an unbacked component, with a "Don't ask again" option and a Settings toggle to re-enable.
• Pull-to-refresh — swipe down on the component list to re-scan the folder.

Download Components

• 9 built-in repositories — StevenMXZ, Arihany WCPHub, Xnick417x, AdrenoToolsDrivers (K11MCH1), freedreno Turnip CI, MaxesTechReview (MTR), HUB Emulators (T3st31), Nightlies by The412Banner, and GameNative.
• Unified GPU Drivers category — Turnip, Adreno, Qualcomm, and Mesa driver files all appear together under a single "GPU Drivers" category.
• Release tag browsing — any individual GitHub release can be enabled as its own browseable category; browse all assets (WCP, ZIP, APK, tar.gz, and more) from a single named release.
• Always-visible cross-repo search — search field above the repo list searches all repositories simultaneously; results show file name, source, and type.
• File detail sheet — tap any file to see its name, source/type chips, published date, file size, and scrollable Release Notes (from GitHub release body); download button is at the top of the sheet for quick access.
• Upload dates and file sizes — shown on every file card and in the detail sheet.
• Sort control — Newest First, Oldest First, Name A→Z, Name Z→A.
• Already-downloaded indicator — files you've previously saved are marked with a checkmark.
• Batch multi-select downloads — enter multi-select mode; pick any number of files; "Download X files" downloads them all in parallel, skipping any already downloaded.
• New-item notification — a dot badge appears on the Download tab when any source has items not seen since the last visit; clears when the tab is opened.
• "NEW" chip on source cards — individual source/repo cards show a "NEW" badge when that specific source has unseen items.
• Custom repositories — add any compatible URL; format is auto-detected. Supports plain GitHub repo links, GitHub Releases URLs, raw JSON feed URLs, and WCP hub JSON feeds.
• Multi-URL custom repositories — combine multiple endpoints (e.g. WCP releases + GPU driver releases) into a single repository card.
• Reorder repositories — use Move Up / Move Down in each repo's hamburger menu to arrange the list in any order you prefer.
• Edit Repository — rename any repository, change its URL, choose which component types it shows, and enable individual release tags as browseable categories.
• Hamburger menu per repo — Open in Browser, Edit Repository, Move Up, Move Down, Remove Repository.
• Refresh All — pre-fetches all sources × all types in parallel and caches results in memory.
• Export repo list — saves your complete repo configuration (custom repos, hidden built-in sources, source order) to bci-repos.json in Downloads.
• Import repo list — loads a bci-repos.json file with a preview dialog; choose Merge (add new repos, keep existing) or Replace (swap all custom repos).

My Downloads

• Browse saved files by Repository → Type → File.
• Auto-refresh on open — the list is refreshed and stale records are pruned every time the tab is opened.
• Inject into GameHub — tap the inject icon on any file to choose an app and a component slot; result shown as a Done/Error snackbar.
• Pull-to-refresh — swipe down to prune stale records (files deleted outside the app); snackbar shows how many were removed.
• Verify Downloads — ☁ icon in the top bar runs the same stale-record check on demand.
• Backups folder at the root gives quick access to all component backups.
• Delete individual records or clear all at once.

My Games Tab (opt-in)

• Enable via Settings → Show My Games Tab.
• Auto-discovers Local games (all subdirs in virtual_containers/) and Steam games (shadercache/ dirs keyed by Steam App ID).
• Auto-select on startup — at launch, BCI automatically selects the first GameHub variant that already has access granted; Steam games appear immediately without a manual tap.
• Offline Steam metadata — game name, cover art, genres, description, release year, and Metacritic score are fetched from the Steam Store API and persisted to disk; available without network after first load.
• Steam ISO files — tap the ↓ FileDownload button in the My Games top bar to write <Game Name>.iso files to Downloads/front end/ for all Steam and imported games on demand. ISO export skips files that already exist, and game names are sanitized (colons and other illegal filename characters replaced) before file creation.
• Manual game imports — tap + to add a game by display name and local ID; BCI writes the corresponding .iso to Downloads/front end/.
• Edit game cards — tap any card to open an edit sheet; all fields (name, genres, description, release year, Metacritic score) are editable; "Search Steam" auto-fills fields and links cover art for local import games.
• Launch games — tap the launch button to start a game directly via GameHub's game detail screen.
• ISO creator — write a .iso stub to virtual_containers/ for GameHub launcher compatibility.
• Remove from list — hide a local game without touching the filesystem; persists across restarts.
• Remove and delete folder — permanently delete the virtual container folder (+ ISO stub) for a local game via SAF; protected by a confirmation dialog. Fixes the GameHub leftover-folder problem.

General

• Backup Manager — centralised view of all saved backups with per-backup deletion.
• Custom storage locations — independently set a custom folder for Downloads and for Backups via the SAF folder picker.
• In-app update checker — checks GitHub for new releases on demand or automatically on launch (toggleable); shows a scrollable changelog before you decide; downloads the APK with a progress bar and hands it to the system installer.
• Clickable links in release notes — URLs in component release notes and file detail sheets are tappable and open in your browser.
• Full theme customization — Dark mode, AMOLED black, Dynamic Color (Material You on Android 12+), 8 preset accent colours, and a custom HSV colour wheel with brightness slider and hex input.
• Native back button — steps back through navigation states throughout the app.
• Settings on every screen — accessible via the ⚙ icon from the App List, Component List, and Download screens.

---

Supported Apps

BannersComponentInjector detects the following GameHub variants automatically:

Detection for borrowed package names (shared with real apps like PUBG Mobile, Genshin Impact, and AnTuTu) is verified against the installed app's display label to avoid false positives.

If a variant is not listed, use Add Custom App (+ button in the Inject tab) to add it by package name.

---

Installation

1. Go to the Releases page.
2. Download the APK for your device architecture:
   • arm64-v8a — most modern Android phones (64-bit ARM)
   • armeabi-v7a — older 32-bit ARM devices
   • x86_64 — x86 emulators / tablets
3. On your Android device, enable Install from unknown sources for your file manager or browser (Settings → Apps → Special app access → Install unknown apps).
4. Open the downloaded APK and tap Install.

APKs are signed with a stable certificate — they install as updates over each other without needing to uninstall first.

---

How to Set Up

First Launch

1. Open BannersComponentInjector.
2. The app shows all detected GameHub variants on your device. Only installed GameHub variants appear — uninstalled entries are hidden.
3. Tap the variant you want to manage.
4. A guide dialog appears explaining which folder to select. Tap Open Folder Picker.
5. In the Android folder picker:
   • Tap the ≡ hamburger menu (top-left) and select your GameHub app from the sidebar.
   • Navigate to: data
   • Tap Use this folder and then Allow.
6. The app now has access. Tap the app card again to open the component list.

One grant at <package>/data covers everything — components, virtual containers, and shadercache. You only need to grant access once per app variant. Access is remembered across restarts. To remove access, tap the 🔗 unlink icon next to the app card.

Upgrading from v1.9.0: Previous grants pointed to components/ and are no longer valid. Re-grant at <package>/data when prompted.

Adding a Variant Not in the List

If your GameHub variant uses a package name not listed above:

1. Tap the + button in the top bar of the Inject Components tab.
2. Enter a Display Name and the app's Package Name.
3. Tap Add. The entry appears in the list and works identically to built-in entries.
4. Tap it to grant folder access as normal.

---

How to Use

Inject Components Tab

This tab is the main workspace for managing components already installed inside a GameHub variant.

Backing Up a Component

1. Tap any component card to open its detail sheet.
2. Tap Backup Current Contents.
3. The component folder is copied to Downloads/BannersComponentInjector/<componentName>/ (or your custom Backups location).
4. The component card shows a Backup badge once a backup exists.

Always back up before replacing — if something goes wrong you can restore instantly.

---

Replacing a Component — Local File

1. Tap the component card you want to replace.
2. Tap Select Local File.
3. If no backup exists, a warning appears. Tap Replace Anyway to proceed (or check Don't ask again to skip future warnings).
4. In the file picker, select your .wcp or .zip file.
5. The app extracts the file into the component folder. A snackbar confirms success.
6. The component card shows a Replaced note with the file name.

---

Replacing a Component — From My Downloads

1. Tap the component card you want to replace.
2. Tap From My Downloads.
3. A sheet appears listing all previously downloaded files. Tap one to inject it directly — no file picker needed.
4. A snackbar confirms success or shows the error.

---

Replacing a Component — Online Sources

1. Tap the component card you want to replace.
2. Tap Select Online Source.
3. At the top of the sheet, a search bar lets you search across all repositories at once. Type to see matching files from any repo — tap a result to open its detail sheet.
4. Or browse manually:
   • Step 1 — Choose a repository: tap any repo card to drill in.
   • Step 2 — Choose a component type: select the category (DXVK, VKD3D, Box64, FEXCore, GPU Drivers, Wine, etc.) or any individual release tag you've enabled.
   • Step 3 — Choose a file: sorted list with published date. Tap any file to open its detail sheet.
5. The detail sheet shows the file name, source, type, date, size, and Release Notes (if available). The download button is at the top of the sheet.
6. Tap Download & Replace. A progress indicator shows download status. The component folder is updated on completion.

Repo cards have a ⋮ menu: Open in Browser, Edit Repository, Move Up, Move Down, Remove Repository.

---

Restoring a Component

1. Tap the component card (must have a Backup badge).
2. Tap Restore Original Backup.
3. Confirm in the dialog. The component folder is restored from the backup copy.
4. The Replaced note is cleared from the component card.

---

Download Components Tab

This tab lets you browse online repositories and save component files to your device for later use.

A dot badge on the tab label indicates one or more sources have items you haven't seen yet. Source/repo cards that have unseen items show a "NEW" chip. Both clear when you open the tab.

Cross-Repo Search

The search bar at the top of the tab searches all repositories at once as you type. Results show the file name, source, and component type. Tap a result to open its detail sheet.

---

Batch Downloads

Tap the ☑ checkbox icon in the top bar to enter multi-select mode. Tap files to select them (checkboxes appear). Tap Download X files to save all selected files in parallel. Already-downloaded files are automatically skipped.

---

Browsing a Repository

1. Select a repository from the list.
2. Select a component type — types shown are those the repository actually provides. GPU driver files (Turnip, Adreno, Qualcomm, Mesa) appear together under GPU Drivers. Any individual release tags you've enabled for that repo appear as additional entries in the list.
3. Browse the file list:
   • Each item shows its name, upload date (where available), file size, and a checkmark if you've already downloaded it.
   • Files are sorted newest first by default.
   • Tap the Sort button (top-right) to switch: Newest First, Oldest First, Name A→Z, Name Z→A.
4. Tap a file to open its detail sheet. The detail sheet shows the file name, source/type chips, published date, file size, and scrollable Release Notes (if available). The download button is at the top of the sheet.
5. Tap Download to Device to save it to Downloads/BannersComponentInjector/<Repo>/<Type>/<filename> (or your custom Downloads location).

---

Managing Repositories

Each repository card has a ⋮ menu with options:

• Open in Browser — opens the repository's GitHub page in your browser.
• Edit Repository — opens the edit dialog (see below).
• Move Up / Move Down — reorder the repository in the list.
• Remove Repository — removes the repository from your list (built-ins can be restored with Restore Default Repositories at the bottom of the list).

Tap ⟳ Refresh (top-right when no repo is selected) to pre-fetch all sources and cache the results in memory for instant browsing and search.

---

Reordering Repositories

Tap ⋮ → Move Up or ⋮ → Move Down on any repo card to shift it up or down in the list. The order is saved automatically and persists across restarts.

---

Adding a Custom Repository

Tap + in the header to open the Add Repository dialog.

1. Enter a Repository Name.
2. Enter a URL in the URL field. Supported URL formats:
   • A plain GitHub repo link: https://github.com/{owner}/{repo} — the app reads the folder structure directly from the repo; each folder becomes a component category.
   • A GitHub Releases URL: https://github.com/{owner}/{repo}/releases — the app scans release assets for .wcp or .zip files.
   • A raw JSON feed URL ending in .json (WCP JSON format).
3. To combine multiple endpoints into one card, tap + Add another URL. Repeat for more.
4. Tap Add. The app auto-detects the format of each URL.

---

Editing a Repository

Tap ⋮ → Edit Repository on any card.

• Change the name or URL.
• Component Types — existing configured types always appear first, followed by any newly discovered ones (labelled new). Check or uncheck categories to control which ones are shown.
• Additional Releases — individual GitHub releases listed by name/tag; each can be enabled as its own browseable category.
• Tap Save to apply.

---

Exporting Your Repo List

Tap the ↓ FileDownload icon in the source list header (between Refresh and Add) to export your entire repo configuration to a JSON file.

The export includes:

• All custom repositories you've added (name, URL, format, types, extra endpoints, release tags)
• Any built-in sources you've hidden via Remove Repository
• Your current source order

The file is saved as Downloads/BannersComponentInjector/bci-repos.json and overwrites any previous export. A spinner is shown while writing; a snackbar confirms the path on success.

---

Importing a Repo List

Tap the ↑ FileUpload icon in the source list header to import a bci-repos.json file.

1. A file picker opens — select a .json file.
2. A preview dialog appears showing:
   • All incoming custom repo names (with their source icon)
   • Which built-in sources will be hidden (if any)
   • Whether source order will be applied
3. Choose how to apply:
   • Merge (default) — adds repos not already in your list; your existing repos stay untouched.
   • Replace — removes all current custom repos and replaces them with the imported set.
4. Tap Import to apply. The source list refreshes immediately.

The hidden-defaults and source order from the file are always applied regardless of Merge/Replace mode.

---

My Downloads Tab

Browse and manage all files previously downloaded via the Download Components tab.

• The list is grouped by Repository → Type → File.
• The list auto-refreshes every time the tab is opened — stale records for files no longer on disk are pruned automatically.
• A Backups folder at the root gives quick access to all component backups.
• Inject into GameHub — tap the inject icon (↑ arrow) on any file card to open a two-step picker: choose the GameHub app, then choose the component slot. A snackbar shows Done or the error message.
• Swipe down (pull-to-refresh) to verify all download records — stale records for files deleted outside the app are pruned.
• Tap the ☁ icon in the top bar to run the same check on demand.
• Tap the 🗑 icon on any file to remove its download record.
• Tap Clear All in the top bar to remove all records at once.

Removing a record only removes the tracking entry — it does not delete the file from your device.

---

My Games Tab

Enable this tab in Settings → Show My Games Tab.

Once enabled, BCI automatically selects the first GameHub variant that already has data/ access granted — the game list loads immediately. If no app is pre-selected, tap a variant to grant access. The tab auto-discovers two types of games:

• Local games — every subdirectory in virtual_containers/.
• Steam games — every subdirectory in shadercache/ (directory name = Steam App ID).

Steam metadata (name, cover art, genres, description, release year, Metacritic score) is fetched from the Steam Store API and cached to disk — available offline after the first load.

Editing a Game Card

Tap any game card to open the edit sheet:

• Edit name, genres, description, release year, and Metacritic score manually, or
• Tap Search Steam and type a game name to auto-fill all fields and link the cover art (useful for local import games that aren't already on Steam).
• Tap Save to apply.

Launching a Game

Tap the Launch button on any game card to start the game directly via GameHub's game detail screen.

Steam & Imported Game ISOs

Tap the ↓ FileDownload button in the My Games top bar to write <Game Name>.iso files to Downloads/front end/ for all Steam and imported games on demand. Steam ISOs contain the Steam App ID (plain text); imported game ISOs contain the local ID. BCI skips any file that already exists in the destination and sanitizes game names (removing colons and other illegal filename characters) before writing. These ISO files are used by front-end launchers for compatibility.

Adding a Game Manually

Tap the + button in the My Games header to add a game that isn't auto-discovered:

1. Enter a Display Name and a Local ID.
2. Tap Add. BCI saves the entry and writes <Display Name>.iso to Downloads/front end/.

Manually added games appear in the Local Games section and support Edit, Remove from list, and Remove and delete folder.

ISO Creator

Tap the Create ISO button on a game card to write a .iso stub to virtual_containers/ — required for GameHub launcher compatibility with certain game entries.

Removing Local Games

Local game cards have two removal options in the ⋮ menu (below a divider, separate from Edit/Reset):

• Remove from list — hides the game from My Games without touching any files. The virtual_containers/<gameId> folder stays intact on disk. The hidden state is saved to SharedPrefs and persists across app restarts. Useful for dummy entries or old installs you don't want to see.

• Remove and delete folder — shows a confirmation dialog, then permanently deletes the virtual_containers/<gameId>/ directory via SAF and removes the companion <gameId>.iso stub if present. Use this to properly clean up games that GameHub's dashboard uninstalled but left the virtual container folder behind.

These options appear only on local game cards. Steam game cards are not affected.

---

Backup Manager

Access from:

• The ☁ icon in the Component List top bar.
• The ☁ icon in the Download Components top bar.
• Settings → Backup Manager.
• The Backups folder in the My Downloads tab.

Lists every saved backup across all components and apps. Tap the 🗑 icon next to any entry to remove it permanently.

---

In-App Updates

Automatic check on launch:

1. Open Settings → Updates.
2. Enable Check for updates on launch.
3. Each time the app starts, it silently checks GitHub. If a newer version is found, a dialog appears showing the version, installed version, and a scrollable What's new changelog. Tap Download & Install, View on GitHub, or Not Now.

Manual check:

1. Open Settings → Updates.
2. Toggle Include pre-releases if desired.
3. Tap Check for Updates.
4. If an update is available, a card shows the version and a scrollable changelog. Tap Download & Install to stream the APK with a live progress bar and launch the system installer, or View on GitHub to open the release page.

---

Theme Customization

1. Open Settings → Appearance.
2. Display Mode — toggle Dark Mode on or off. When dark mode is on, check AMOLED Black for a pure #000000 background ideal for OLED screens.
3. Material You (Android 12+) — enable Dynamic Color to derive the theme palette from your wallpaper. This overrides the accent colour and disables the AMOLED option.
4. When Dynamic Color is off, choose one of the 8 preset swatches: Orange (default), Blue, Purple, Green, Red, Teal, Pink, or Amber.
5. For a fully custom colour, tap Custom: drag the colour wheel, use the Brightness slider, or type a hex value.
6. All changes update live and are saved automatically.

---

Supported Component Formats

WCP (Winlator Component Package)

A tar archive compressed with Zstandard (zstd) or XZ. Contains:

• profile.json — metadata: type, version name, description, and file mappings.
• system32/ and syswow64/ subdirectories with DLL files.

Extraction behaviour:

• FEXCore type → files are extracted flat to the component root.
• All other types → system32/syswow64 directory structure is preserved.

ZIP (Turnip / Adrenotools)

A plain ZIP archive with a meta.json file and flat .so library files. Detected by magic bytes. Always extracted flat to the component root.

Release Tag Downloads

When browsing a repository's individual release tags, all assets are shown regardless of file type — WCP, ZIP, APK, tar.gz, etc. Files are downloaded as-is.

---

Online Sources

GPU Drivers consolidates Turnip, Adreno, Qualcomm, and Mesa driver files into a single unified category.

---

Settings

---

Requirements

• Android 10 (API 29) or later.
• One or more GameHub app variants installed on the device.
• No root required.
• Internet access required for online sources and the update checker.

---

Building from Source

git clone https://github.com/The412Banner/BannersComponentInjector.git
cd BannersComponentInjector
./gradlew assembleDebug

The APK is output to app/build/outputs/apk/debug/.

Dependencies (all resolved via Gradle):

• Jetpack Compose + Material 3
• AndroidX Activity, Lifecycle ViewModel, DocumentFile (SAF)
• Apache Commons Compress — WCP/tar extraction
• com.github.luben:zstd-jni — Zstandard decompression
• org.tukaani:xz — XZ decompression
• Coil 2.6.0 — image loading (Steam cover art)
• Material Icons Extended

---

BannersComponentInjector is an independent third-party tool and is not affiliated with, endorsed by, or connected to the GameHub or Winlator projects.

---

_{☕ Support on Ko-fi}

Community

Join our Discord: https://discord.gg/n8S4G2WZQ4