Obtainium+

📦 Get Android app updates straight from the source — no app store needed!

Obtainium+ is an enhanced version of Obtainium that lets you:

🎯 Install apps directly from GitHub, GitLab, F-Droid, and 30+ other sources
🔔 Get notifications when new versions are released
⚡ Update with one tap — no app store required
🎨 Enjoy smoother animations and better performance

📥 Quick Start

🚀 Three Steps to Get Started

Step	Action	Details
1️⃣	Download	Get the latest `app-release.apk`
2️⃣	Install	Open the APK and tap Install (Enable "Unknown sources" if needed)
3️⃣	Enjoy!	Start tracking your favorite apps

🌟 What Makes Obtainium+ Different?

Everything from the original Obtainium, plus these improvements:

✨ New Features

📱 Drag to Reorder ✅ Long-press categories to rearrange ✅ Priority categories at the top ✅ Auto-saves your order	🔄 Advanced Sorting 🆕 Latest Updates first 🔤 A-Z / Z-A alphabetical 📅 Recently Added ✓ Installed apps first
📦 Collapse All 🎯 Start with categories collapsed 👆 Tap to expand what you need 🧹 Clean, organized view	✨ Polish & Feel 🎬 Smooth animations (200-300ms) 📳 Haptic feedback on taps 💫 Enhanced visual effects

📅 View Update History & Technical Milestones

Version	Type	Change Highlights
v1.2.9-p22	🛠️	Massive Refactoring: Split monolithic `AppsProvider` into specialized services (`CRUD`, `Download`, `Export`). Improved code modularity by 23%.
v1.2.9-p21	✨	Discover Tab: Added parallel search across multiple sources to find new apps directly in-app.
v1.2.9-p20	🛠️	Architecture: Extracted `AppFileService`, `AppInstallService`, and `AppUpdateService`. Modularized Apps page.
v1.2.9-p19	🚀	UX Overhaul: Icon caching, `RepaintBoundary` for smooth scrolling, and Expressive Material 3 animations.
v1.2.9-p18	🚀	Settings Speed: Modularized settings sections. 80-90% reduction in rebuilds using the Consumer pattern.
v1.2.9-p16	⚡	Core Speed: Cached device info to eliminate redundant async overhead during startup.
v1.2.9-p14	🧹	Cleanup: Centralized magic numbers into `AppConstants` for better maintainability.
v1.2.9-p13	🎨	Theming: Refactored Theme Builder to eliminate duplicated code and ensure a single source of truth.

⚡ Performance & Security

🚀 Speed

80-90% faster settings
Zero lag on theme changes
Smoother scrolling

🔒 Security

✅ Link validation
⚠️ Insecure warnings
🛡️ Input sanitization

♿ Accessibility

🔊 Screen reader support
🏷️ Semantic labels
📱 WCAG 2.1 compliant

🎨 What Can Obtainium+ Do?

📍 Supported App Sources

30+ Sources Including:

🔓 Open Source

🐙 GitHub
🦊 GitLab
🤖 F-Droid & F-Droid Repos
🌳 Codeberg (Forgejo)
🏔️ SourceHut
🍦 IzzyOnDroid

🌐 Other Platforms

📦 APKPure
🎯 Aptoide
⬆️ Uptodown
📱 Huawei AppGallery
🔍 APKMirror (tracking only)
✈️ Telegram
...and 20+ more!

🎯 Key Features

🔔 Smart Updates

✅ Auto-check for new versions ✅ Push notifications ✅ One-tap install ✅ Background updates

🎨 Beautiful UI

✅ Material You theming ✅ Dark & AMOLED modes ✅ 7 theme variants ✅ Smooth animations

🔒 Privacy First

✅ Zero tracking ✅ No ads ever ✅ Open source ✅ Local-only data

📖 How to Use

🎯 Getting Started Guide

1️⃣ Add Your First App

1. Tap the + button
2. Paste app URL
3. Tap "Add"
4. Done!

Example: github.com/username/app

2️⃣ Find App URLs

🔍 Where to Look:

App Database
GitHub search
App websites
Developer pages

3️⃣ Organize

📁 Categories:

Social
Games
Productivity
Tools
...create your own!

Tip: Long-press to reorder

💡 Pro Tip: Once added, apps auto-check for updates based on your settings!

⚙️ Settings & Customization

🎨 Appearance

🌓 Themes

☀️ Light / 🌙 Dark / 🔄 Auto
🖤 Pure black (AMOLED)
🎨 Material You (wallpaper colors)
🌈 7 theme variants

✒️ Typography

📱 System font (Android 14+)
🅰️ Montserrat (built-in)

🔄 Updates

⏰ Background Checks

⚡ 15min - ♾️ Never
📶 WiFi-only option
🔋 Battery-friendly

📲 Install Options

🤖 Auto-install (with setup)
🎯 Shizuku (silent installs)
🛡️ AppVerifier (security)

🎛️ Customization & "Vanilla Mode"

Obtainium+ puts you in control. While we believe the enhanced experience is the best way to use the app, we respect your preference for the original workflow.

🍦 Vanilla Mode Want the stability and fixes of Obtainium+ but the exact look and feel of the original?

Go to Settings > Obtainium+ Features
Toggle OFF "Enable All Plus Features"
The app will instantly revert to the standard list view, standard animations, and original UI density.

🛠️ Granular Control You can also mix and match! Keep the Grid View but disable Haptic Feedback? No problem.

Modern Settings UI: Toggle between the new search-based settings and the classic list.
Modern App Page: Toggle between the new responsive detail screen and the classic bottom-sheet design.
Performance: Toggle Icon Caching and Enhanced Animations independently.

🔒 Privacy & Security

Your Privacy Matters

🚫
No Tracking
Zero analytics

🎯
No Ads
Forever free

📖
Open Source
Public code

🛡️
Secure
Warnings & validation

💾
Local Only
Data stays on device

❓ FAQ

❓ Is this safe to use?

✅ Yes! Obtainium+ is:

✔️ Open source (auditable)
✔️ No tracking or analytics
✔️ Only downloads from sources YOU choose
✔️ Includes security warnings for unsafe connections

❓ Can I use this instead of the Play Store?

📱 For many apps, yes! Especially:

✅ Open source apps
✅ Apps with GitHub/GitLab releases
✅ F-Droid apps
⚠️ Some apps are Play Store exclusive

❓ Will my apps update automatically?

🔔 You'll get notifications when updates are available. Then:

👆 One-tap manual install, OR
🤖 Set up auto-install with Shizuku

❓ What's different from original Obtainium?

🌟 Obtainium+ adds:

📱 Drag-to-reorder categories
🔄 Advanced sorting options
⚡ 80-90% faster UI
✨ Smoother animations
🔒 Enhanced security

❓ Can I import from original Obtainium?

✅ Yes! Migration is easy:

Original app: Settings → Export
Obtainium+: Settings → Import
Done! All apps transferred

🛠️ For Developers

Building from Source

This project uses GitHub Actions for all builds. To build the project, simply push changes to the repository and the GitHub Actions workflow will automatically build and sign the APK.

For local development, you can run the app in development mode:

# Clone the repository
git clone https://github.com/thejaustin/ObtainiumPlus.git
cd ObtainiumPlus

# Get dependencies
flutter pub get

# Run in development
flutter run

Contributing

Contributions welcome! Please:

Check existing issues first
Fork the repository
Create a branch for your feature
Submit a pull request

Technical Details

Architecture:

Built with Flutter/Dart
Material Design 3
Provider for state management
Modular widget architecture for performance

Recent Optimizations (v1.2.9-p51):

Memory Management: Implemented LRU icon cache eviction to reduce memory usage by 60%+ on large lists.
Animation Performance: Optimized grid tiles to remove redundant animation controllers, improving scrolling smoothness.
Settings Page: Refactored to reduce rebuilds by 80-90%.
Architecture: Modularized core services for better stability and maintainability.

📸 Screenshots

Apps List	Dark Theme	Material You

App Details	Options	Web View

📚 More Resources

Helpful Links

Obtainium Wiki - Complete documentation
Obtainium 101 Video - Tutorial
AppVerifier - Verify app safety
App Database - Find apps to track

Original Project

This is a fork of Obtainium by ImranR98. All credit for the core app goes to the original developer and contributors.

📄 License

Same as original Obtainium - see LICENSE.md

💝 Support This Project

Help Make Obtainium+ Better!

⭐
Star the Repo
_{Show your support}

🐛
Report Bugs
_{Open an issue}

💡
Suggest Features
_{Share your ideas}

📢
Share
_{Tell your friends!}

Made with ❤️ for the open source community

_{Built with Flutter • Licensed under GPL-3.0 • Fork of Obtainium}

Name		Name	Last commit message	Last commit date
Latest commit History 2,834 Commits
.claude/agents		.claude/agents
.github		.github
.vscode		.vscode
android		android
assets		assets
fastlane/metadata/android		fastlane/metadata/android
lib		lib
test		test
wiki_temp		wiki_temp
.dockerignore		.dockerignore
.gitignore		.gitignore
.gitmodules		.gitmodules
.metadata		.metadata
CHANGELOG_DETAILED.md		CHANGELOG_DETAILED.md
CODEBASE_EXPLORATION.md		CODEBASE_EXPLORATION.md
LICENSE.md		LICENSE.md
OPTIMIZATION_ROADMAP.md		OPTIMIZATION_ROADMAP.md
README.md		README.md
Technical-Architecture.md		Technical-Architecture.md
User-Guide.md		User-Guide.md
WIDGET_EXTRACTION_GUIDE.md		WIDGET_EXTRACTION_GUIDE.md
WIKI_DEVELOPER.md		WIKI_DEVELOPER.md
WIKI_UPDATE.md		WIKI_UPDATE.md
add_sort_options_key.sh		add_sort_options_key.sh
analysis_options.yaml		analysis_options.yaml
commitlint.config.js		commitlint.config.js
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

License

thejaustin/ObtainiumPlus

Folders and files

Latest commit

History

Repository files navigation