Skip to content

Obtainium Migration & Sync Guide

DurchEins edited this page Nov 15, 2026 · 2 revisions

πŸ”„ Obtainium Migration & Sync Guide

Starting with v1.40.0+, ApkUp features native integration with Obtainium backups. This guide explains how to migrate your tracked applications from Obtainium to ApkUp, synchronize custom source repositories, and manage your full backup archives.


πŸ“‘ Quick Navigation


1. Why Migrate from Obtainium to ApkUp?

While Obtainium is an excellent tool for scraping open-source repositories directly, ApkUp combines open-source feeds with mainstream package ecosystems into a unified, lightweight updater:

Feature Obtainium ApkUp
Multi-Source Aggregation Scrapes specific URL Aggregates Play Store, APKMirror, IzzyOnDroid, Custom F-Droid, GitHub, GitLab & Codeberg
Automatic Fallback Manual link per app Automatically finds newer releases from alternative reliable sources
Cryptographic Signature Defense Basic checksum check Strict SHA-1 / SHA-256 Android certificate matching prevents tampering
Direct APKMirror Downloads Browser-dependent Built-in high-speed scraper with .apkm split package extraction
Silent Background Updates Notification-driven Native Shizuku IPC with automatic background scheduling (WorkManager)
Modern Jetpack Compose UI Flutter 100% native Kotlin / Material Design 3

2. How to Export from Obtainium

  1. Open Obtainium on your Android device.
  2. Tap the Settings tab (gear icon).
  3. Scroll to Import / Export.
  4. Tap Export Apps to JSON File.
  5. Save the file (e.g., obtainium_export.json) to your device storage (such as your Downloads folder).

3. How to Import into ApkUp

  1. Open ApkUp.
  2. Tap the Setup tab and expand Advanced Settings.
  3. Scroll to Data & Backup and tap Obtainium Import.
  4. Choose your exported obtainium_export.json file in Android's system file picker.
  5. Interactive Preview Sheet (v1.43.0+): Review and toggle the detected items before applying:
    • Repo Links for Installed Apps: Automatically matches installed package IDs against GitHub, GitLab, Codeberg/Forgejo, and asset regex rules.
    • Third-Party F-Droid Repositories: Detects additional HTTPS F-Droid /repo or /archive URLs (including optional 64-character ?fingerprint= pins) configured in Obtainium and lets you import them into ApkUp's unified F-Droid repository manager.
    • Watch Uninstalled Apps (Opt-In): Lists any apps from the export that are not currently installed on your phone (unchecked by default so you only add watchlist apps you explicitly select).
  6. Tap Import selected, then switch to the Updates tab and pull down to refresh!

4. Supported Source Types & Mapping

ApkUp automatically parses and maps the following Obtainium entry types:

  • GitHub Repositories: Mapped to ApkUp's GitHub resolver (supports standard releases, pre-releases, and direct APK asset pattern matching).
  • GitLab Projects: Mapped to ApkUp's GitLab resolver (including multi-level subgroup hierarchies and self-hosted domains).
  • Codeberg & Forgejo Repositories: Mapped to ApkUp's Codeberg/Forgejo v1 resolver (supports codeberg.org and self-hosted Forgejo servers).
  • F-Droid & IzzyOnDroid Links: Mapped to ApkUp's high-efficiency Index V2 streaming feed and Custom F-Droid repository list.
  • APK Filter Regex (apkFilterRegEx): Automatically preserved from Obtainium entries when selecting release assets.

5. Signature Security & Overwrite Protection

When importing apps from Obtainium, security is paramount:

  • Signature Verification Before Install: Even if a custom repository offers an APK with a higher versionCode, ApkUp extracts the package certificate from the downloaded APK and verifies that it cryptographically matches the signature of the installed application on your device.
  • Signature Conflict Warning: If the developer changed their signing key or if the repository contains an incompatible variant, ApkUp flags the update with a prominent amber shield badge and blocks installation until you make an informed decision.

6. Backing Up & Restoring ApkUp Configurations (SAF JSON)

ApkUp also provides complete native backup and restore capabilities:

Creating an ApkUp Backup

  1. Go to Settings βž” Data & Backup βž” Export Configuration.
  2. Select a destination folder using Android's Storage Access Framework (SAF).
  3. ApkUp exports your:
    • Ignored / permanently hidden apps
    • Version skips (versionCode pins)
    • Custom repository links (GitHub, GitLab, custom URLs)
    • General preferences (theme, Shizuku toggles, check intervals)
    • Access token configurations (optional, securely flagged)

Restoring an ApkUp Backup

  1. Go to Settings βž” Data & Backup βž” Import Configuration.
  2. Select your previous apkup_backup_*.json file.
  3. Your preferences and custom sources are restored instantly.

Clone this wiki locally