Skip to content
pubscout

photo_manager

3.12.0, released 3 months ago by fluttercandies.com

Manage and retrieve photo, video, and audio assets on Android, iOS, macOS, and OpenHarmony.

$ flutter pub add photo_manager
Source repository

What it does

Provides low-level APIs to access, query, filter, and manage device media albums and files without built-in UI components. Supports requesting permissions, handling limited access, modifying asset metadata, and watching for library changes.

AI-written summary of version 3.12.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to build a custom media picker or gallery browser from scratch.
  • You require fine-grained programmatic control over device photo and video libraries.

Skip it when

  • You just want a ready-made picker UI without writing custom views.
  • You only need to pick a single image or file and can rely on higher-level drop-in pickers.

Strengths

  • Extensive support for albums, custom filters, pagination, and file caching.
  • Cross-platform support covering Android, iOS, macOS, and OpenHarmony.
  • Active maintenance with advanced features like Live Photos, adjustments, and cloud identifiers.

Weaknesses

  • Requires manual configuration of native platform permissions and dependencies.
  • Does not include any ready-to-use UI widgets for displaying or selecting media out of the box.

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
1

Requires adding platform permissions (NSPhotoLibraryUsageDescription for iOS/macOS) and configuring minimum Android/Gradle/Kotlin versions.

final PermissionState ps = await PhotoManager.requestPermissionExtend();
if (ps.isAuth) {
  List<AssetPathEntity> paths = await PhotoManager.getAssetPathList();
}

Alternatives

Packages that do the same job and could replace photo_manager.

  • image_picker

    Pick images and videos quickly using the platform's native picker UI with minimal configuration.

Works with

Packages commonly used together with photo_manager: ones it builds on, ones built on it, and its own family.