APK Download Helper is a standalone Android helper app for finding and returning original APK files requested by Morphe Manager.

The helper receives a package/version request through an Android intent, lets the user choose a supported APK source, downloads a matching file when direct download is available, and returns a readable content:// URI back to the caller.

This project is independent from the APK source websites listed below. Source availability, package versions, download formats, and region/device access can change at any time.

Features

• Handles app.morphe.manager.action.DOWNLOAD_ORIGINAL_APK requests.
• Shows the requested app's real icon (Android default when not installed), name, package, version, build, format, and ABI hints in a compact stat-card header.
• Lets you narrow the request to a single file format (APK/APKM/APKS/XAPK) when Morphe allows several.
• Fast Mode: auto-searches sources in order for the exact requested version + version code and returns it to Morphe without manual taps.
• Four version types per source: Manual (open the source site), Recommended (exact requested version), Latest (newest compatible), and History (browse every version).
• Collapsible source grid — pick a source and the list collapses so the page stays clean.
• Returns APK, APKS, APKM, or XAPK files when the selected source provides a compatible direct download, and validates downloaded files before returning them.
• Shows live download speed and ETA in the progress notification and the in-app card (38% · 6.3 MB/s · 0:55 left).
• Themes: dark, light, or follow-the-system, plus an optional Material You mode that tints accents and card surfaces from the wallpaper (Android 12+). A quick theme toggle sits in the home header, no need to open Settings.
• In-app captcha browser: sources that gate files behind Cloudflare-style challenges open a real WebView; the download it produces is captured back into the helper.
• Falls back to web/manual flows when direct download is not available.
• Keeps Play Store listing opens separate from Aurora's Play-backed download flow.
• Tabs in settings (Settings / Health / History / Logs) with an in-app log of every request and HTTP exchange, plus a Share button to export it for bug reports.

Supported Sources

• APKMirror
• Uptodown
• APKPure
• APKCombo
• Aptoide
• Evozi
• Mi9
• APK Downloader
• Aurora / Google Play
• Play Store listing

Every source can be individually enabled or disabled from Settings → Sources. Not every source can provide every requested version or file format: some only expose latest versions, some require manual web interaction, and some split formats may not match the patch request.

Helper Settings

The helper has a tabbed settings screen:

• Save downloads: store in Helper's cache (honoring the auto-clear toggle) or keep a validated copy in Downloads/APK Download Helper; a storage card shows cache and Downloads sizes and clears both with one tap.
• Connection: allow Wi-Fi only, mobile data only, or both Wi-Fi and mobile data.
• Sources: toggle each APK source on or off — disabled sources disappear from the picker, manual links, and Fast Mode.
• Fast Mode: enable auto-search of the exact requested version across sources.
• Appearance: pick System / Dark / Light and toggle Material You colors (wallpaper-tinted accents and surfaces on Android 12+).
• Logging: mirror request/HTTP details to Logcat.
• Health / History / Logs tabs: per-source health, past hand-offs, and the full in-app log.

Temporary hand-off is the default because Morphe Manager copies the returned APK URI into its own private workspace before patching.

Debugging & Bug Reports

When a source fails to resolve or a download stalls, the Logs tab shows the full story — the request data, every URL fetched, HTTP status codes, redirects, and timing — with no adb needed. Use Share to export the log (including the app/device info) to any app.

GitHub issues use a bug report template that asks for this exported log, so reports arrive with the exact failing request and HTTP trace.

Release Signing

Release APKs must be signed with a private release certificate. Debug signing is only for local test builds and must not be used for public releases.

GitHub Actions expects these repository secrets:

• HELPER_RELEASE_KEYSTORE_BASE64: base64-encoded release keystore
• HELPER_RELEASE_STORE_PASSWORD
• HELPER_RELEASE_KEY_ALIAS
• HELPER_RELEASE_KEY_PASSWORD

For local release builds, place the same values in local.properties or pass them as Gradle properties/environment variables. Do not commit keystores or signing passwords.

Source Audit Script

Use tools/audit_helper_sources.py to test source availability for every app declared in a Morphe Constants.kt file without launching the Android app:

python tools\audit_helper_sources.py --output reports\source-audit.csv

Useful targeted checks:

python tools\audit_helper_sources.py --package club.boxbox.android --sources apkpure,aptoide,apkcombo
python tools\audit_helper_sources.py --limit 20 --sources apkmirror,uptodown,apkpure,apkcombo,aptoide

The CSV/JSON output reports whether each source matched the requested version, only found latest, found the wrong file format, or failed to resolve the package.

Intent Contract

Request action:

app.morphe.manager.action.DOWNLOAD_ORIGINAL_APK

Important request extras:

app.morphe.manager.extra.CALLER_PACKAGE
app.morphe.manager.extra.PROTOCOL_VERSION
app.morphe.manager.extra.PACKAGE_NAME
app.morphe.manager.extra.APP_NAME
app.morphe.manager.extra.VERSION_NAME
app.morphe.manager.extra.VERSION_CODES
app.morphe.manager.extra.COMPATIBLE_VERSION_NAMES
app.morphe.manager.extra.SUPPORTED_ABIS
app.morphe.manager.extra.FILE_TYPE
app.morphe.manager.extra.ALLOW_SPLIT_ARCHIVE
app.morphe.manager.extra.STOCK_INSTALL_REQUIRED
app.morphe.manager.extra.FALLBACK_WEB_URL

The helper also accepts older local draft keys for compatibility, including REQUESTED_FILE_TYPE, INSTALL_STOCK_AFTER_DOWNLOAD, VERSION_CODE, COMPATIBLE_VERSION_CODES, and SOURCE_HINT_URLS.

Successful result:

• Activity.RESULT_OK
• Intent.data points to the downloaded file URI
• Intent.FLAG_GRANT_READ_URI_PERMISSION is granted to the caller

Credits

• APKUpdater
• Aurora Store
• Public web pages and APIs exposed by APKMirror, Uptodown, APKPure, APKCombo, and Aptoide

This helper does not claim ownership of source website data, packages, trademarks, or services.

Support APK Sources

APK hosting and indexing costs money. If this helper saves you time, consider supporting the services it relies on:

• APKMirror
• Uptodown
• APKPure
• APKCombo
• Aptoide
• Aurora Store

License

APK Download Helper is licensed under the GNU General Public License v3.0. See LICENSE.

Notes

• Only download apps you are allowed to access.
• This helper does not bypass paid apps, license checks, account restrictions, or DRM.
• Always verify downloaded files before installing them on a device you care about.
• Source matching is best-effort because APK providers can change their sites and APIs without notice.