Repository navigation
Home
DurchEins edited this page Nov 15, 2026
·
5 revisions
Welcome to the central knowledge base and documentation for ApkUp!
Every guide in this Wiki is crafted to serve both regular users and developers:
- 🟢 Part 1 (Explained Simply for Everyone): Step-by-step instructions in plain, everyday language without technical jargon.
- 💻 Part 2 (Technical Documentation for Experts & Power Users): Deep-dive explanations covering architecture, security mechanisms, cryptography, and Android system interfaces.
- ❓ Part 3 & 4 (Comprehensive FAQs, Troubleshooting & Self-Help): Practical solutions for common real-world error codes, setup edge cases, and best practices.
-
For Beginners: What is Shizuku, why does it save you from confirming every single update dialog manually, and how do you set it up in 2 minutes completely without Root — or enable the optional Root Installer (
su) fallback on rooted devices? - Quick Setup Guide: Setting up Shizuku (Wireless Debugging, USB ADB, and Root walkthroughs).
-
For Experts: Dual-path installation pipeline (Shizuku Binder IPC +
sufallback),pm install-create -r -i com.android.vending(Play Store attribution), batch ETA progress, and Android 14+ Background Activity Launch (BAL) resilience. - OEM Troubleshooting: Specific guides for Xiaomi / HyperOS, Samsung One UI, and OnePlus background optimizations.
- For Beginners: Overview of all update sources (Google Play Store, APKMirror, IzzyOnDroid, Custom F-Droid Repositories, GitHub, GitLab, Codeberg / Forgejo), direct in-app downloads, how digital app signatures protect you against tampered updates, and how to link custom repositories with optional regex asset filters.
-
For Experts: Parallel multi-source aggregation, cryptographic SHA-1/SHA-256 certificate verification, FOSS build flavor preference, hardened
.apkmsplit extraction (Zip-Slip protection), per-app APKMirror cooldowns, and automatic HTTP 429 session rotation for the Google Play Store. -
Self-Help Catalog: What to do on
INSTALL_FAILED_UPDATE_INCOMPATIBLE, APKMirror404 Not Found, GitHub rate limits, or connection errors (DNS,Timeout,HTTP 401/403/429/5xx).
-
For Beginners: How to watch uninstalled apps (
+/ Watched filter), export single.apkor split.apksfiles to Downloads or a custom folder, search and sort Updates/Apps (including release date), skip builds, and transfer settings to a new phone. -
For Experts: Package-wide exclusion vs.
versionCodepinning, battery-friendly job scheduling via AndroidWorkManager, persistent update snapshot cache, offline sanitized diagnostic log export, and the JSON backup format via Storage Access Framework (SAF). -
Practical Help: Why background notifications might not arrive (Android 13+ permission & OEM battery optimization) and how to safely edit the
.jsonbackup file in a text editor.
-
Migrating from Obtainium: Complete walkthrough for importing your Obtainium setup (
obtainium_export.json) via the interactive preview sheet into ApkUp with automatic source mapping (GitHub, GitLab, Codeberg, IzzyOnDroid, Custom F-Droid) and Watchlist suggestions for uninstalled apps. - Conflict Resolution & Signatures: How ApkUp verifies app certificates against currently installed packages before importing to prevent update failures.
- Cross-Sync & Backup: Maintaining backups, JSON structure, and synchronizing between devices without losing custom repository links.
-
Modern Streaming & Incremental Diffs: How ApkUp processes modern F-Droid
index-v2.json(entry.jar), incremental V2 diffs (RFC 7396), andindex-v1.jarrepositories via streaming JSON parsing with cryptographic JAR & SHA-256 verification. - Unified Repository Manager & Presets: Manage IzzyOnDroid, Official F-Droid, NewPipe Repo, Guardian Project, microG Repo, and custom third-party HTTPS F-Droid repositories in one unified Setup bottom sheet.
- SHA-256 & TOFU Certificate Pinning: Pre-pinned official presets plus optional SHA-256 fingerprints with automatic Trust-on-First-Use (TOFU) pinning and status badges for custom repositories.
- Overcoming Rate Limits & GraphQL Batching: Raise GitHub's hourly rate limit from 60 to 5,000 requests per hour and batch multiple GitHub repository checks into a single GraphQL request with a free Personal Access Token.
-
GitLab & Codeberg / Forgejo Support: Access private or enterprise repositories and multi-level GitLab subgroups (
group/subgroup/project), pluscodeberg.organd self-hosted Forgejo instances. - One-Tap Token Verification: How to use the built-in Test Token feature in ApkUp's source sheets to instantly confirm token validity.
-
Direct Error Resolution: Instant explanation and self-help guides for every error badge shown in ApkUp:
-
DNS Resolution Failed/UnknownHostException -
Connection Timeout/SocketTimeoutException -
HTTP 401 Unauthorized/HTTP 403 Forbidden/HTTP 429 Too Many Requests -
HTTP 404 Not Found& APKMirror variant indexing delays -
INSTALL_FAILED_UPDATE_INCOMPATIBLE(Signature Conflicts) -
No matching release asset found(Repository Linking)
-