Repository navigation
Obtainium Migration & Sync Guide
DurchEins edited this page Nov 15, 2026
·
2 revisions
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.
- 1. Why Migrate from Obtainium to ApkUp?
- 2. How to Export from Obtainium
- 3. How to Import into ApkUp
- 4. Supported Source Types & Mapping
- 5. Signature Security & Overwrite Protection
- 6. Backing Up & Restoring ApkUp Configurations (SAF JSON)
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 |
- Open Obtainium on your Android device.
- Tap the Settings tab (gear icon).
- Scroll to Import / Export.
- Tap Export Apps to JSON File.
- Save the file (e.g.,
obtainium_export.json) to your device storage (such as your Downloads folder).
- Open ApkUp.
- Tap the Setup tab and expand Advanced Settings.
- Scroll to Data & Backup and tap Obtainium Import.
- Choose your exported
obtainium_export.jsonfile in Android's system file picker. -
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
/repoor/archiveURLs (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).
- Tap Import selected, then switch to the Updates tab and pull down to refresh!
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.organd 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.
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.
ApkUp also provides complete native backup and restore capabilities:
- Go to Settings β Data & Backup β Export Configuration.
- Select a destination folder using Android's Storage Access Framework (SAF).
- ApkUp exports your:
- Ignored / permanently hidden apps
- Version skips (
versionCodepins) - Custom repository links (GitHub, GitLab, custom URLs)
- General preferences (theme, Shizuku toggles, check intervals)
- Access token configurations (optional, securely flagged)
- Go to Settings β Data & Backup β Import Configuration.
- Select your previous
apkup_backup_*.jsonfile. - Your preferences and custom sources are restored instantly.