📦 picker_pro_max_ultra #

A powerful and customizable media picker for Flutter, built with performance and ease of use in mind.

Easily pick images , file and videos from device storage or capture new ones with camera support. Comes with advanced features like folder browsing, multi-selection, capture image from camera, and custom UI also allow to pick file.

✨ Features #

• 📸 Capture image & video using the camera
• 🖼 Pick images & videos from the gallery
• 📂 Folder-based media browsing
• 🔁 Multi-selection support
• 📁 File pick support
• 🎵 Audio picker (Android only)
• ⚡ Fast loading with optimized performance

🛠 Installation #

Add this to your pubspec.yaml:

dependencies:
  picker_pro_max_ultra: ^<latest_version>

Replace <latest_version> with the latest version on pub.flutter-io.cn.

⚙️ Setup #

📝 Note

Permission handling (e.g. for accessing media, storage, or camera) must be implemented from the Flutter side using packages like permission_handler or through manual platform configuration.

This plugin does not request or manage permissions internally.

✅ Android #

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

    <!-- Media Access -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
    <!-- Camera Access -->
<uses-permission android:name="android.permission.CAMERA" />

🍏 iOS #

Add the following entries to your ios/Runner/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>This app requires access to your photo library.
</string>

<key>NSCameraUsageDescription</key>
<string>This app requires access to the camera.</string>

<key>NSMicrophoneUsageDescription</key>
<string>This app requires access to the microphone.</string>

🧪 Example Usage #

// Pick media

  // show loader
              MediaPicker(
                      context: context,
                      maxLimit: 5 ?? 1,
                      mediaType: MediaType.image)
                  .showPicker()
                  .then((file) {
                // hide loader
                if (file != null) {
                  filePath = file.first.mediaFile!.path;
                  setState(() {});
                }
              }).catchError((onError) {
                // hide loader
              });
			  
			  
// Capture from camera
     MediaPicker(
                context: context,
              ).capturedFile().then((file) {
               /// hide loader
               if (file != null) {
                 filePath = file.path;
                 setState(() {});
               }
             }).catchError((onError) {
               /// hide loader
             });
// Document
    MediaPicker(
                context: context,
              ).picFile().then((file) {
                /// hide loader
                if (file != null) {
                  filePath = file.path;
                  setState(() {});
                }
              }).catchError((onError) {
                /// hide loader
              });

For a full example, check out the example folder. | |

🎥 Demo (Screen Recording) #

🧩 Contributions #

Contributions, issues, and feature requests are welcome!
Feel free to check issues page.

📄 License #

This project is licensed under the MIT License.