Skip to content
DurchEins edited this page Nov 15, 2026 · 5 revisions

📖 Welcome to the Official ApkUp Wiki

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.

📚 Available Guides & Manuals

  • 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 + su fallback), 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 .apkm split 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, APKMirror 404 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 .apk or split .apks files 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. versionCode pinning, battery-friendly job scheduling via Android WorkManager, 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 .json backup 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), and index-v1.jar repositories 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), plus codeberg.org and 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)

🔗 Quick Start & Project Links

Clone this wiki locally