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
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
