Inspired by the clean presentation style of
OnlineShop.
- 🛡️ Background downloads that don’t stop — Foreground Service keeps downloads running even if the app closes.
- 📊 Live progress, everywhere — Real‑time progress in notification and in‑app UI.
- 📋 Clipboard auto‑paste — Empty field? We paste your latest link automatically.
- 🧰 Multiple downloads — Queue any number without crashing or blocking.
- 🎨 Modern UI — Material 3, smooth animations, and accessible design.
Replace placeholders with your screenshots or GIFs.
| Home | Progress | Notification |
|---|---|---|
 |
 |
 |
| Category | Details |
|---|---|
| Download by username | Saves public posts to /sdcard/InstaLoaderApp/<username> |
| Download by link | Supports …/p/… and …/reel/… to /sdcard/InstaLoaderApp/posts |
| Foreground Service | Reliable background execution with Android‑compliant notifications |
| In‑app progress | Smooth progress bar and status updates |
| Clipboard auto‑paste | One‑tap flow: copy a link, hit Download |
| Queueing | Multiple downloads handled sequentially |
| Localization | English and Persian language selection |
| Layer | Tech |
|---|---|
| Language | Kotlin |
| UI | Material 3, ViewBinding |
| Concurrency | Coroutines |
| Background | Foreground Service + Notifications |
| Python Engine | Chaquopy |
| Downloader | instaloader (Python) |
- Input a username or Instagram link (or leave empty to auto‑paste from clipboard).
DownloadServiceenqueues and performs background downloads as a Foreground Service.- The service updates the persistent notification and broadcasts progress events.
MainActivitylistens for broadcasts and updates the in‑app progress UI.script.py(Python) usesinstaloaderto fetch media and report progress.
- Storage (MANAGE_EXTERNAL_STORAGE or WRITE/READ) — Save media to
/sdcard/InstaLoaderApp/. - Foreground Service — Keep downloads running in background.
- Notifications (Android 13+) — Show progress notifications.
The app guides users via LanguageSelectionActivity → PermissionGrantActivity.
app/
src/main/java/com/alphacorp/instaloader/
MainActivity.kt # UI + in‑app progress
DownloadService.kt # Foreground downloads + notifications
LanguageSelectionActivity.kt # Language bootstrap
PermissionGrantActivity.kt # Permission flow
src/main/python/
script.py # instaloader integration + progress API
src/main/res/ # Material 3 UI, animations, drawables
- Android Studio Iguana or newer
- Android SDK 24+
- Gradle (wrapper included)
git clone https://github.com/your-org/iliDownloader.git
cd iliDownloader- Open in Android Studio and wait for Gradle sync.
- Connect a device (Android 8+) or start an emulator.
- Run the app.
- Generate a release keystore and configure signing in Android Studio or
app/build.gradle. - Build → Generate Signed Bundle/APK to produce AAB/APK.
- Choose language on first launch.
- Grant storage and notification permissions.
- Paste a username or post link (or tap Download to auto‑paste from clipboard).
- Track progress both in‑app and in notification.
- Add more links immediately; they’ll queue in the background.
- Settings screen (destination folder, data saver)
- Pause/Resume queue
- In‑app gallery with share/delete
- More locales
- Downloads only publicly available content. Respect creators’ rights.
- Ensure you have permission to download and use content.
- Not affiliated with Instagram.
- “No posts found or account is private” → Only public profiles are supported.
- No notification on Android 13+ → Enable app notifications in system settings.
- Storage errors on Android 11+ → Grant “All files access” when prompted.
- Slow/stuck progress → Network/rate limiting can affect speed; the UI remains responsive.
Contributions are welcome! Please see CONTRIBUTING.md and open an issue or PR.
MIT — see LICENSE for details.
- Conversion‑focused UX with minimal taps and delightful feedback.
- Enterprise‑grade reliability via Foreground Service.
- Clean, maintainable Kotlin code and clear separation of concerns.
- Extensible for premium features (batch rules, filters, private API with auth).
Need branding, custom flows, or multi‑platform support? Let’s talk.
A luxurious, stylish, and feature-rich Instagram content downloader app with beautiful Material 3 design, smooth animations, and real-time progress tracking.
- Material 3 Design System - Modern, beautiful UI following Google's latest design guidelines
- Gradient Backgrounds - Beautiful gradient backgrounds with Instagram-inspired colors
- Card-based Layout - Elegant card design with proper shadows and elevation
- Custom Icons - Beautiful vector icons for all UI elements
- Responsive Design - Adapts beautifully to different screen sizes
- Real-time Progress Bar - Beautiful gradient progress bar with percentage display
- Status Updates - Dynamic status messages showing download progress
- Progress Animation - Smooth progress updates with beautiful transitions
- Download Simulation - Realistic progress simulation for better user experience
- Entrance Animations - Staggered entrance animations for all UI elements
- Progress Animations - Smooth fade-in/fade-out animations for progress section
- Button Animations - Pulse animation for download button and success animations
- Card Animations - Beautiful slide-up animations for main content
- Status Animations - Smooth alpha transitions for status updates
- Light Theme - Beautiful light theme with Instagram-inspired colors
- Dark Theme - Elegant dark theme with proper contrast and readability
- Auto Theme Switching - Automatic theme switching based on system preferences
- Custom Color Palette - Luxurious color scheme with proper accessibility
- Kotlin Coroutines - Asynchronous download operations
- Material Components - Latest Material Design components
- View Binding - Modern view binding for better performance
- Clean Architecture - Well-structured, maintainable code
- Error Handling - Comprehensive error handling with user-friendly messages
- Primary: Beautiful orange (#FF6B35)
- Secondary: Vibrant yellow (#FFD93D)
- Accent: Modern purple (#6C63FF)
- Instagram Colors: Pink (#E4405F), Purple (#833AB4), Orange (#FD1D1D), Yellow (#FCAF45)
- App Title: 32sp, bold, sans-serif-light
- Section Headers: 18sp, bold
- Body Text: 16sp, regular
- Captions: 14sp, regular
- Progress Text: 14sp, bold
- Main Card: 24dp corner radius, 16dp elevation
- Info Cards: 16dp corner radius, 8dp elevation
- Input Field: 16dp corner radius with Instagram icon
- Download Button: 20dp corner radius with gradient background
- Progress Bar: 12dp corner radius with gradient fill
- Android Studio Arctic Fox or later
- Android SDK 21+ (API Level 21)
- Python 3.8+ (for backend functionality)
- Clone the repository
- Open in Android Studio
- Sync Gradle files
- Build and run on device/emulator
- Enter Instagram username or post URL
- Tap "Download Content"
- Watch beautiful progress animations
- Enjoy your downloaded content!
- MVVM Pattern - Model-View-ViewModel architecture
- Repository Pattern - Clean data management
- Coroutines - Asynchronous operations
- Material 3 - Latest design system
- MainActivity: Main UI controller with animations
- Layout Files: Beautiful XML layouts with Material Design
- Drawable Resources: Custom vector graphics and gradients
- Animation Files: Smooth XML animations
- Theme Files: Comprehensive theming system
- Material Design 3
- AndroidX Core KTX
- ConstraintLayout
- Kotlin Coroutines
- Chaquopy (Python integration)
- Batch Downloads - Download multiple posts simultaneously
- Download History - Track download history with beautiful UI
- Favorites - Save favorite accounts for quick access
- Settings - Customizable download options
- Statistics - Beautiful download statistics dashboard
- Sharing - Share downloaded content directly from app
We welcome contributions! Please see our Contributing Guidelines for details.
This project is licensed under the MIT License - see the LICENSE file for details.
- Instagram - For the inspiration
- Material Design Team - For the beautiful design system
- Kotlin Team - For the amazing language
- Android Community - For continuous support and feedback
Made with ❤️ and beautiful design principles
Transform your Instagram experience with the most beautiful downloader app ever created!