Overview 🎇

https://github.com/user-attachments/assets/79580bc7-237c-46b7-b92e-1479cc6d9079

React Native Multiple Image Picker (RNMIP) enables application to pick images and videos from multiple smart album in iOS/Android. React Native Multiple Image Picker is based on two libraries available, HXPhotoPicker and PictureSelector

Documentation 📚

Features 🔥

| 🤩 | | | --- | ------------------------------------------------------------------------------------- | | 🍕 | Crop single/multiple image. | | 🎑 | Preview image/video. | | 📸 | Camera module for capturing photos and recording videos. | | 🐳 | Keep the previous selection. | | 0️⃣ | Selected order index. | | 🎨 | UI Customization (numberOfColumn, spacing, primaryColor ... ) | | 🌚 | Dark Mode, Light Mode | | 🌄 | Choose multiple images/video. | | 📦 | Support smart album (camera roll, selfies, panoramas, favorites, videos...). | | 📺 | Display video duration. | | ⛅️ | Support iCloud Photo Library. | | 🌪 | Scrolling performance. ☕️ |

Requirements

Because RNMIP uses Nitro Module, it complies with Nitro Modules' requirements. View Nitro Modules' requirements here

• Xcode 16+
• iOS 13+
• react-native 0.75+
• compileSdkVersion 34+

Installation

See more Installation

Usage

Here is a simple usage of the Multiple Image Picker. See more Config

import { openPicker, Config } from '@baronha/react-native-multiple-image-picker'

const config: Config = {
  maxSelect: 10,
  maxVideo: 10,
  primaryColor: '#FB9300',
  backgroundDark: '#2f2f2f',
  numberOfColumn: 4,
  mediaType: 'all',
  selectBoxStyle: 'number',
  selectMode: 'multiple',
  language: 'vi', // 🇻🇳 Vietnamese
  theme: 'dark',
  isHiddenOriginalButton: false,
  primaryColor: '#F6B35D',
}

const onPicker = async () => {
  try {
    const response = await openPicker(config)
    setImages(response)
  } catch (e) {
    // catch error for multiple image picker
  }
}

To Do

• [x] Crop Image in iOS.
• [x] Preview Controller for iOS.
• [x] Handle Permission when limited on iOS.
• [x] Migrating Library to the New Architecture.
• [x] Multiple Crop Image.
• [x] Multiple Preview Image.
• [x] Dynamic Theme.
• [x] Dynamic Language
• [x] Open Crop Controller.
• [x] Open Preview Controller.
• [x] Open Camera Controller.

Sponsor & Support ☕️

To keep this library maintained and up-to-date please consider sponsoring it on GitHub. Or if you are looking for a private support or help in customizing the experience, then reach out to me on Twitter @_baronha. Besides, I also built a product using HXPhotoPicker here, Hope you support:

Built With ❤️

Star History

Showcase ✨

List of used applications with @baronha/react-native-multiple-image-picker

Contributions are welcome! If you have an application that uses @baronha/react-native-multiple-image-picker, please open a pull request to add it to the list.

See all Showcase

Performance

We're trying to improve performance. If you have a better solution, please open a issue or pull request. Best regards!

License

MIT TLPhotoPicker PictureSelector