Skip to content
pubscout

background_downloader

9.6.6, released 2 weeks ago by bbflight.com

Multi-platform background file downloading and uploading for Flutter.

Rock solid
$ flutter pub add background_downloader
Source repository

What it does

Enables robust, background file transfers (downloads and uploads) across Android, iOS, macOS, Windows, and Linux. Transfers continue running even when the app is placed in the background or terminated by the operating system, using native URLSession on Apple platforms and WorkManager/JobService on Android.

AI-written summary of version 9.6.6, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Your app needs to download or upload large files in the background.
  • Transfers must persist and complete even if the app is suspended, closed, or terminated by the OS.
  • You require fine-grained progress tracking, notifications, pausing, and resuming for file tasks.

Skip it when

  • You only need simple, short-lived foreground HTTP requests that fail if the app closes.
  • You are targeting platforms without proper native background transfer support or constraints.

Strengths

  • Cross-platform support for Android, iOS, macOS, Windows, and Linux.
  • Resilient background operation using native platform APIs (URLSession, WorkManager).
  • Provides both a high-level reactive Transfer API and low-level queue/stream methods.

Weaknesses

  • Requires specific Kotlin configuration on Android and network entitlements on macOS.
  • If a user forcefully swipes the app away from the app switcher, background transfers may still be terminated by the OS.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
8

Requires Kotlin 2.1.0+ for Android settings.gradle, and client network entitlements on macOS for debug and release profiles.

final task = DownloadTask(
  url: 'https://example.com/large_video.mp4',
  filename: 'video.mp4',
);
final transfer = await FileDownloader().transfers.start(task);
final file = await transfer.file;

Alternatives

Packages that do the same job and could replace background_downloader.

Works with

Packages commonly used together with background_downloader: ones it builds on, ones built on it, and its own family.