Gal 🖼️

Dart3 plugin for saving image or video to gallery/photos

Please LIKE👍 and STAR⭐️ to support our volunteer efforts.

	Android	iOS	macOS	Windows
Support	SDK 21+	11+	11+	10+

	iOS	Android
Example

✨ Features

Open gallery
Save video
Save image
Save to album
Save with metadata
Handle permission
Handle errors
Lots of docs and wiki

🚀 Get started

Add dependency

You can use the command to add gal as a dependency with the latest stable version:

$ flutter pub add gal

iOS

Add the following keys to the ios/Runner/Info.plist:

<key>NSPhotoLibraryAddUsageDescription</key> Required
<key>NSPhotoLibraryUsageDescription</key> Required for ios < 14 or saving to album

You can copy from Info.plist in example.

Android

Add the following keys to the android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" /> Required for API <= 29
android:requestLegacyExternalStorage="true" Required for saving to the album in API 29

You can copy from AndroidManifest.xml from example.

🔴 Warning: Android emulators with API < 29 require SD card setup. Real devices don't.

macOS

Add the following keys to the macos/Runner/Info.plist:

<key>NSPhotoLibraryAddUsageDescription</key> Required
<key>NSPhotoLibraryUsageDescription</key> Required for saving to album

You can copy from Info.plist in example.

🔴 Warning: Flutter has fatal crash issue for loading info.plist on macOS now.

Windows

Update Visual Studio to the latest version for using C++ 20.

✅ Usage

Save from local

// Save Image (Supports two ways)
await Gal.putImage('$filePath');
await Gal.putImageBytes('$uint8List');

// Save Video
await Gal.putVideo('$filePath');

// Save to album
await Gal.putImage('$filePath', album: '$album')
...

Download from the Internet

$ flutter pub add dio

// Download Image
final imagePath = '${Directory.systemTemp.path}/image.jpg';
await Dio().download('$url',imagePath);
await Gal.putImage(imagePath);

// Download Video
final videoPath = '${Directory.systemTemp.path}/video.mp4';
await Dio().download('$url',videoPath);
await Gal.putVideo(videoPath);

Save from Camera

$ flutter pub add image_picker

// Shot and Save
final image = await ImagePicker.pickImage(source: ImageSource.camera);
await Gal.putImage(image.path);

$ flutter pub add camera

// Record and Save
...
final video = await controller.stopVideoRecording();
await Gal.putVideo(video.path);

Handle Permission

// Check Permission
await Gal.hasAccess();

// Request Permission
await Gal.requestAccess();

Handle Errors

// Save Image with try-catch
try {
  await Gal.putImage($imagePath);
} on GalException catch (e) {
  log(e.type.message);
}

// Exception Type
enum GalExceptionType {
  accessDenied,
  notEnoughSpace,
  notSupportedFormat,
  unexpected;

  String get message => switch (this) {
        accessDenied => 'You do not have permission to access the gallery app.',
        notEnoughSpace => 'Not enough space for storage.',
        notSupportedFormat => 'Unsupported file formats.',
        unexpected => 'An unexpected error has occurred.',
      };
}

📝 Ducuments

If you write an article about Gal, let us know in discussion and we will post the URL of the article in the wiki or readme 🤝

💚 Trusted by huge projects

Although Gal has only been released for a short time, it is already trusted by huge projects.

and more...

About

The Answer of How to Save Image/Video to the Photo Gallery in Flutter

https://pub.dev/packages/gal

BSD 3-Clause "New" or "Revised" License

Languages

Language:Dart 31.8%Language:Java 24.6%Language:C++ 17.4%Language:Swift 17.3%Language:CMake 5.4%Language:Ruby 2.2%Language:C 1.2%

boyan01 / gal