photo_gallery_pro 0.0.4

A Flutter plugin for accessing and managing photos and videos from the device gallery. Supports both Android and iOS platforms.

Photo Gallery Pro

A Flutter plugin for accessing and managing photos and videos from the device gallery. Supports both Android and iOS platforms.

Features

• 📱 List all media albums (photos and videos)
• 🖼️ Filter albums by media type (images or videos)
• 📂 Get media items from specific albums
• 🎬 Support for both images and videos
• 👍 Permission handling
• 🔍 Generate thumbnails for:
  • Individual media items
  • Album covers
• ⚡ Optimized performance
• 🎨 Material Design 3 example app

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  photo_gallery_pro: ^0.0.4

Platform Setup

Android

Add the following permissions to your Android Manifest (android/app/src/main/AndroidManifest.xml):

<!-- For Android 12 and below -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<!-- For Android 13 and above -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

iOS

Add the following keys to your iOS Info.plist (ios/Runner/Info.plist):

<key>NSPhotoLibraryUsageDescription</key>
<string>This app requires access to the photo library to display your photos and videos.</string>

Usage

Basic Setup

import 'package:photo_gallery_pro/photo_gallery_pro.dart';

// Initialize the plugin
final photoGallery = PhotoGalleryPro();

// Request permissions if needed
if (!await photoGallery.hasPermission()) {
  final granted = await photoGallery.requestPermission();
  if (!granted) return;
}

Working with Albums

 // Get all albums
_albums = await _photoGallery.getAlbums();

// Or get only image albums
final imageAlbums = await _photoGallery.getAlbums(type: MediaType.image);

// Or get only video albums
final videoAlbums = await _photoGallery.getAlbums(type: MediaType.video);

// Get only image albums
final imageAlbums = await photoGallery.getAlbums(type: MediaType.image);

// Get only video albums
final videoAlbums = await photoGallery.getAlbums(type: MediaType.video);

// Get album thumbnail
final albumThumbnail = await photoGallery.getAlbumThumbnail(
  albums[0].id,
  type: albums[0].type,
);

Working with Media

// Get media in an album
final mediaList = await photoGallery.getMediaInAlbum(
  albums[0].id,
  type: albums[0].type,
);

// Get thumbnail for a specific media item
final thumbnail = await photoGallery.getThumbnail(
  mediaList[0].id,
  type: mediaList[0].type,
);

Example

Check the example directory for a complete sample app demonstrating all features.

Platform Support

Android	iOS
✅	✅

Contributing

Feel free to contribute to this project by:

• Opening issues
• Submitting pull requests
• Adding documentation
• Reporting bugs

License

• LICENSE