Repository files navigation

English |简体中文

ZLPhotoBrowser is a Wechat-like image picker. Support select normal photos, videos, gif and livePhoto. Support edit image and crop video.

• Features
• Requirements
• Usage
• Change Log
• Languages
• Installation(Support Cocoapods/Carthage/SPM)
• Support
• Demo Effect

Detailed usage ofSwift andOC, please refer toWiki.

If you only want to use the image edit feature, please move toZLImageEditor.

• Support SwiftUI.
• Portrait and landscape.
• Two framework style.
• Support page loading.
• Preview selection (Support drag and drop).
• Library selection (Support sliding selection).
• Image/Gif/LivePhoto/Video.
• Customize the maximum number of previews or selection, the maximum and minimum optional duration of the video.
• Customize the number of columns displayed in each row.
• Image editor (Draw/Crop/Image sticker/Text sticker/Mosaic/Filter/Adjust(Brightness, Contrast and Saturation)), (Draw color can be customized; Crop ratio can be customized; Filter effect can be customized; You can choose the editing tool you want).
• Video editor.
• Custom camera.
• Multi-language.
• Selected index.
• Selected/unselectable state shadow mask.
• The selected photos are displayed at the bottom of the big picture interface, which can be dragged and sorted.
• The camera's internal photo cell can displays the captured images of the camera.
• Customize font.
• The color of each part of the framework can be customized (Provide dynamic color can support light/dark mode).
• Customize images.

If you have good needs and suggestions in use, or encounter any bugs, please create an issue and I will reply in time.

• iOS 10.0
• Swift 5.x
• Xcode 14.x

• Preview selection

letpicker=ZLPhotoPicker()picker.selectImageBlock={[weak self] results, isOriginalin    // your code}picker.showPreview(animate:true, sender:self)

• Library selection

letpicker=ZLPhotoPicker()picker.selectImageBlock={[weak self] results, isOriginalin    // your code}picker.showPhotoLibrary(sender:self)

• Pay attention, you need to add the following key-value pairs in your app's Info.plist

// If you don’t add this key-value pair, multiple languages are not supported, and the album name defaults to EnglishLocalized resources can be mixed   YESPrivacy - Photo Library Usage DescriptionPrivacy - Camera Usage DescriptionPrivacy - Microphone Usage Description

More logs

● 4.7.3  Fix:    Fixed the issue where the eraser position was displayed incorrectly when editing pictures.● 4.7.2  Add:    Improved video editing experience:      1. Added a shadow area mask for a clearer view of the currently selected video clip.      2. Added a feature to display the duration of the currently selected clip.    The ZLImagePreviewController interface supports disabling the pull-down return gesture.    Change the permission of ZLPhotoPreviewSheet to private.  Fix:    Fixed a bug where the UI of the thumbnail interface might display an error when the permission is "limited".● 4.7.0.1  Add:    Support page loading.    The thumbnail interface supports edge sliding back gesture.    Provide a block that enables external control over whether the camera interface can be accessed.    Replace some deprecated APIs.    Support long-press gestures for more data types in ZLImagePreviewController. Support setting cover images for network videos.    The ZLImagePreviewController interface supports disabling the pull-down return gesture....

🇨🇳 Chinese, 🇺🇸 English, 🇯🇵 Japanese, 🇫🇷 French, 🇩🇪 German, 🇷🇺 Russian, 🇻🇳 Vietnamese, 🇰🇷 Korean, 🇲🇾 Malay, 🇮🇹 Italian, 🇮🇩 Indonesian, 🇪🇸 Spanish, 🇵🇹 Portuguese, 🇹🇷 Turkish, 🇸🇦 Arabic, 🇳🇱 Dutch.

There are four ways to use ZLPhotoBrowser in your project:

• using CocoaPods
• using Carthage
• using Swift Package Manager
• manual install (build frameworks or embed Xcode Project)

To integrate ZLPhotoBrowser into your Xcode project using CocoaPods, specify it to a target in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'platform :ios, '10.0'use_frameworks!target 'MyApp' do  # your other pod  # ...  pod 'ZLPhotoBrowser'end

Then, run the following command:

$ pod install

If you cannot find the latest version, you can executepod repo update first

To integrate ZLPhotoBrowser into your Xcode project using Carthage, specify it in your Cartfile:

github "longitachi/ZLPhotoBrowser"

Then, run the following command to build the ZLPhotoBrowser framework:

$ carthage update

If you get an error likeBuilding universal frameworks with common architectures is not possible. The device and simulator slices for "ZLPhotoBrowser" both build for: arm64 Rebuild with --use-xcframeworks to create an xcframework bundle instead.Click this link.

1. Select File > Add Packages. Enterhttps://github.com/longitachi/ZLPhotoBrowser.git in the "Choose Package Repository" dialog.
2. In the next page, specify the version resolving rule as "Up to Next Major" with "4.7.3" as its earliest version.
3. After Xcode checking out the source and resolving the version, you can choose the "ZLPhotoBrowser" library and add it to your app target.

• ★ Star this repo.
• Support with or or

• Selection

• Image editor

• Video editor

• Multi-language

• Custom camera