DEV Community: SimpleDownloader

SimpleDownloader release v1.0.2

Jeetarc — Thu, 08 Oct 2026 06:50:19 +0000

v1.0.2

Improved pause and concurrency handling, better restore behavior, notifications, foreground service management, and HTTP response handling.

Added

Added .setHoldSlotOnPause(boolean enable) to control whether a paused download holds or releases its concurrency slot. Can be configured via SimpleDownloader.builder() or a downloader instance.
Added .hasListeners() and .hasListener(Listener) methods to both DownloadTask and SimpleDownloader.
Added .hasObservers() and .hasObserver(Observer) methods to SimpleDownloader.
Expanded Status with helper methods - isQueued(), isPaused(), isComplete(), isFailed(), isCancelled(), and more.
Auto-restore is now enabled by default, disable it by calling .setAutoRestore(false) via SimpleDownloader.builder().
Added Formatter.formatTime(long timeMillis, String format) for timestamp formatting.
You can now get the current library version by using SimpleDownloader.VERSION.

Improvements

Improved restore behavior when automatic restore is disabled.
Improved pause, concurrency-slot, and notification handling with holdSlotOnPause. Paused downloads now release their concurrency slot by default. holdSlotOnPause is disabled by default.
Improved notification grouping, ongoing notification state, and foreground service handling.
Improved Content-Range and response handling in the HTTP engine.
Improved timeout client caching in the HTTP engine.
Fixed waiting for network state execution ordering that was blocking queued submissions.
Finalized the Listener API, removed deprecated callback signatures from both DownloadTask.Listener and SimpleDownloader.Listener.
Renamed the library package from com.jeet.simpledownloader to com.jeetarc.simpledownloader.
General cleanup and improvements.

Migration

1. Package Rename

The library package has been renamed to:

package com.jeetarc.simpledownloader;

Update any existing imports from com.jeet.simpledownloader to com.jeetarc.simpledownloader

2. Update Dependency

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

3. Listener API

If you are using deprecated Listener callback methods, update them to the new Listener API signatures. Visit Callbacks and Listener

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

Releases:
https://github.com/jeetarc/SimpleDownloader/releases

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

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.