README.md

Overview 🎇

ImagePicker.mp4

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 🔥

🤩
🐳	Keep the previous selection.
0️⃣	Selected order index.
🎨	UI Customization (numberOfColumn, spacing, primaryColor ... )
🌚	Dark Mode, Light Mode
🌄	Choose multiple images/video.
🤐	Compress image after selected (new) ✨
📦	Support smart album (camera roll, selfies, panoramas, favorites, videos...).
📺	Display video duration.
🎆	Preview image/video.
⛅️	Support iCloud Photo Library.
🔪	Crop single/multiple image (new) ✨
🌪	Scrolling performance. ☕️

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

• Crop Image in iOS.
• Preview Controller for iOS.
• Handle Permission when limited on iOS.
• Migrating Library to the New Architecture.
• Multiple Crop Image.
• Multiple Preview Image.
• Dynamic Theme.
• Dynamic Language
• Open Crop Controller.
• Open Preview Controller.
• 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.

Built With ❤️

Star History

Performance

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

Contributors ✨

Thanks go to these wonderful people:

cd-butterfly	Bảo Hà.	Alireza	Phạm Ngọc Thạch	crockalet	Denis Bevilacqua
Chandu J S	shafiqjefri	Rajnarayan Dutta	vivianLee	Yogesh Mane	abing
hieuphan1030	Nick - Ngoc Pham

License

MIT
TLPhotoPicker
PictureSelector