🚀 Smart Download Manager Plus #

A powerful, resumable, and queue-based download manager for Flutter — built for production apps.

✨ Highlights #

• ⚡ Parallel downloads with queue system
• 🔄 Resume & pause downloads
• 🔁 Smart retry mechanism
• 📊 Real-time progress & speed tracking
• 📁 Save directly to Downloads (Android MediaStore)
• 🍎 iOS support (Documents directory)
• 🔔 Built-in notifications
• 📦 Batch downloads
• 💾 Persistent tasks (auto restore)
• 🚀 Open file automatically after download

🤔 Why Smart Download Manager Plus? #

• Built for real production apps, not just demos
• Supports resume downloads (Range requests)
• Handles Android scoped storage (MediaStore) correctly
• Clean and simple API
• Designed for performance and reliability

🎥 Demo #

📸 Preview #

🚀 Installation #

dependencies:
  smart_download_manager_plus: latest

⚡ Quick Start #

Initialize #

await DownloadNotificationService.init();
await DownloadNotificationService.requestPermission();

Create Controller #

final controller = DownloadController(
  maxConcurrent: 2,
);

Download a File #

final task = controller.addTask(
  'https://example.com/file.pdf',
  subFolder: 'MyApp',
  openAfterDownload: true,
);

await controller.startTask(task);

📥 Usage Examples #

📄 Download PDF #

controller.addTask(
  'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
  openAfterDownload: true,
);

🖼 Download Image #

controller.addTask(
  'https://www.w3.org/Icons/w3c_home.png',
);

📦 Batch Download #

controller.addBatch([
  'https://example.com/file1.pdf',
  'https://example.com/file2.png',
]);

⏸ Pause / Resume #

controller.pauseTask(task);
controller.resumeTask(task);

❌ Cancel Download #

await controller.cancelTask(task);

🚀 Open File After Download #

Automatically open files when completed:

controller.addTask(
  url,
  openAfterDownload: true,
);

📂 File Storage #

Android #

• Uses MediaStore API
• Saves to Downloads/
• No storage permission required

iOS #

• Saves to Application Documents Directory

📡 Listen to Progress #

controller.onTaskUpdated.listen((task) {
  print(task.progress);
});

⚙️ Configuration #

🆚 Comparison #

🧠 How It Works #

• Uses Dio for downloading
• Supports HTTP Range requests (resume downloads)
• Stores tasks using SharedPreferences
• Uses MethodChannel for Android file saving

⚠️ Notes #

• Resume requires server support for Range headers
• Some file types require external apps to open
• Android 13+ requires notification permission

📌 Roadmap #

• ❌ Background downloads (WorkManager / BGTaskScheduler)
• ❌ File preview inside app
• ❌ Download grouping
• ❌ Web support

🤝 Contributing #

Contributions are welcome! Feel free to open issues or submit PRs.

📄 License #

MIT License © 2026