image_downloader_saver #

A no-dependency Flutter plugin for downloading and saving images to the Gallery or App Files (Downloads) directory, with smart duplicate detection and clear HTTP-style status codes. Works fully on Android and iOS.

Features #

• Save image to Gallery or Files (Downloads)
• Detect duplicates before saving
• Return clear HTTP-style status codes
• Works offline and online
• Native Android & iOS implementation
• No extra dependencies for saving
• Full example app included

Status Codes #

API Reference #

ImageSaver.saveImage #

Downloads an image from a URL and saves it either to the Gallery or Files (Downloads) directory.

Parameters

Returns

A SaveResult object with:

• code → Numeric HTTP-style status code
• message → Human-readable message
• isSuccess → Boolean (true if code is 200, 201, or 208)

SaveResult #

SaveLocation #

Usage Example #

import 'package:image_downloader_saver/image_downloader_saver.dart';

void main() async {
  final result = await ImageSaver.saveImage(
    'https://picsum.photos/400',
    saveTo: SaveLocation.gallery,
  );

  print('${result.code} → ${result.message}');
}

Permissions #

Android #

Add the following permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

iOS #

Add these keys to your Info.plist:

<key>NSPhotoLibraryAddUsageDescription</key>
<string>We need permission to save images to your gallery.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>We need access to check existing images.</string>

Example App #

An example Flutter app is included in the example/ directory.

Run the example:

cd example
flutter run

Troubleshooting #

Supported Platforms #

Maintainer #

Author: Mohamed Elshenawy
Email: [email protected]
Repository: GitHub - melshenawyarabapps/image_downloader_saver
License: MIT