SimpleDownloader v1.0.0

Jeetarc — Tue, 08 Sep 2026 12:43:41 +0000

v1.0.0

Stable release of SimpleDownloader with a cleaner API, improved task management, and many more.

Added

Multi-download management
Instance-based downloader API with SimpleDownloader.getInstance(context) and SimpleDownloader.builder(context).
DownloadRequest API for defining individual downloads separately from downloader configuration.
Downloader ownership through ownerId, if not set, it use library default: "default_owner".
Added support for batch downloads and clearer separation between global downloader settings and per download options.

Fixes & Improvements

Safer task management when multiple downloader instances are used.
Improved separation of task state, queues, and concurrency between downloader instances.
Improved database handling and task ownership.
General stability and lifecycle improvements for the stable release.

Migration for beta users

1. Update the dependency:

implementation "com.github.jeetarc:SimpleDownloader:1.0.0"

2. Replace the old download API:

Beta:

DownloadTask task = SimpleDownloader.with(context)
    .setOutput(folderUri, FileName.AUTO)
    .setFileUrl(url)
    .startDownload();

Stable:

SimpleDownloader downloader = SimpleDownloader.getInstance(context);
DownloadRequest request = DownloadRequest.from(folderUri, FileName.AUTO, fileUrl);
DownloadTask task = downloader.startDownload(request);

Use SimpleDownloader.builder(context) and DownloadRequest.builder() for more controls. Read APIs

3. Update listeners:

Move from the beta listener API to the stable APIs:

Beta:

DownloadListener

Stable:

DownloadTask.Listener
SimpleDownloader.Listener

4. Read README for more:

https://github.com/jeetarc/SimpleDownloader/blob/main/README.md

SimpleDownloader on GitHub:
https://github.com/jeetarc/SimpleDownloader

SimpleDownloader - a modern Android file downloader library designed to simplify complex download management

Jeetarc — Tue, 18 Aug 2026 04:48:49 +0000

Downloading files on Android is a headache. You have to deal with file systems, scoped storage, MediaStore, foreground, notifications, lifecycle handling, retries, etc along with optimizations.

Introducing SimpleDownloader - a simple to use library for everything from basic file downloads to advanced download management system.

It supports:

Multiple downloader profiles in a single app
Queues, priorities, and concurrency control
Pause, resume, cancel, retry, remove, requeue, and force download
Network loss handling + Wi-Fi-only mode
Database persistence and automatic restore
Filesystem paths, SAF/Document Tree, and MediaStore
Automatic filename and MIME type handling
Progress, speed, ETA, status, and lifecycle callbacks
Foreground + progress/complete/error notifications, with actions and thumbnails
Custom OkHttpClient, headers, cookies, checksums, RetryPolicy, timeouts, and more

Minimum Android version API 21 (Android 5.0). The below examples are written in Java, the library can be used from both Java and Kotlin.

Installation

Add JitPack to your repositories:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

Then add the dependency:

dependencies {
    implementation "com.github.jeetarc:SimpleDownloader:<latest-version>"
}

Visit Releases page to know latest version:
https://github.com/jeetarc/SimpleDownloader/releases

Quick Start

// Get the default instance
SimpleDownloader downloader = SimpleDownloader.getInstance(context);

// Or create a customized instance
SimpleDownloader downloader = new SimpleDownloader.Builder(context)
    .setMaxConcurrent(3)
    .setRetryCount(3)
    .enableHistory(true)
    .enableForeground(true)
    .setAutoRestore(true)
    .build();

// Filesystem path
DownloadRequest request = DownloadRequest.from(folderPath, FileName.AUTO, fileUrl);
DownloadTask task = downloader.startDownload(request);

// MediaStore (Android 10+)
DownloadRequest request = DownloadRequest.from(MediaStore.Downloads.EXTERNAL_CONTENT_URI, FileName.AUTO, fileUrl);
DownloadTask task = downloader.startDownload(request);

// SAF / Document Tree
DownloadRequest request = DownloadRequest.from(treeUri, FileName.AUTO, fileUrl);
DownloadTask task = downloader.startDownload(request);

The API also gives callbacks for pause, resume, progress, completion, errors, status changes, lifecycle events, etc. Callbacks and Listeners

Permissions

Only request what you use:

POST_NOTIFICATIONS for notifications (runtime permission on Android 13+)
FOREGROUND_SERVICE + FOREGROUND_SERVICE_DATA_SYNC when using foreground mode
Storage permissions only when writing to external filesystem paths

No storage permission is needed for app-specific directories, MediaStore, or SAF. Setup guide

There are many more APIs, customization and control available, view README for more: https://github.com/jeetarc/SimpleDownloader/blob/main/README.md

GitHub: https://github.com/jeetarc/SimpleDownloader

Reddit community: https://www.reddit.com/r/SimpleDownloader

I'd love to hear your feedback, especially if you've dealing with Android's download/storage APIs before.

DEV Community: SimpleDownloader