ZLPhotoBrowser

ZLPhotoBrowser is a WeChat-style image picker for iOS (supporting iOS 10.0+) that provides:

• Selection Modes: Drag-to-select in preview, slide-to-select in albums, and mixed media support (Image/Gif/LivePhoto/Video).
• Editing: Built-in image editing (crop, stickers, text, mosaic, filters) and video editing.
• Custom Camera: WeChat-style camera with support for custom recording durations, resolutions, and flash modes.
• UI Customization: Support for SwiftUI, iPad multi-window, landscape mode, custom fonts, and dynamic colors (Light/Dark mode).
• Internationalization: Support for multiple languages including Chinese, English, Japanese, French, German, and more.

Add ZLPhotoBrowser to your Podfile to integrate it into your Xcode project. Ensure your platform is set to iOS 10.0 or higher and use_frameworks! is enabled.

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target 'MyApp' do
  # your other pod
  # ...
  pod 'ZLPhotoBrowser'
end

Then run:

$ pod install

To ensure proper functionality, you must configure your Info.plist with the following keys:

Localization Support

To enable multi-language support (otherwise album names default to English), add:

• CFBundleAllowMixedLocalizations (set to YES or add as Localized resources can be mixed)

Privacy Permissions

You must provide usage descriptions for the following keys:

• NSPhotoLibraryUsageDescription (Privacy - Photo Library Usage Description)
• NSCameraUsageDescription (Privacy - Camera Usage Description)
• NSMicrophoneUsageDescription (Privacy - Microphone Usage Description)

You can install ZLPhotoBrowser using several dependency managers:

CocoaPods

Add the following to your Podfile and run pod install:

pod 'ZLPhotoBrowser'

Note: If the latest version is not found, run pod repo update first.

Carthage

Add the following to your Cartfile and run $ carthage update:

github "longitachi/ZLPhotoBrowser"

Note: If you encounter architecture errors, rebuild using the --use-xcframeworks flag.

Swift Package Manager (SPM)

1. In Xcode, select File > Swift Packages > Add Package Dependency.
2. Enter the repository URL: https://github.com/longitachi/ZLPhotoBrowser.git.
3. Specify the version (minimum version required is 5.0.0).

Manual Installation

Drag the Sources folder directly into your Xcode project.

To support multiple languages (so album names are localized) and to access system resources, you must add the following keys to your Info.plist:

• Localized resources can be mixed: Set to YES
• Privacy - Photo Library Usage Description
• Privacy - Camera Usage Description
• Privacy - Microphone Usage Description

Use ZLPhotoPreviewSheet to skip the preview and go directly to the album selection interface.

let picker = ZLPhotoPreviewSheet()
picker.selectImageBlock = { [weak self] results, isOriginal in
    // your code
}
picker.showPhotoLibrary(sender: self)

Initialize ZLPhotoPicker and set the selectImageBlock to handle the results. Use showPhotoLibrary(sender:) to present the photo library selection interface.

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

Initialize ZLPhotoPicker and set the selectImageBlock to handle the results. Use showPreview(animate:sender:) to present the preview selection interface.

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

Use ZLPhotoPicker to present a picker that starts with a preview interface. The selectImageBlock is called when the user finishes selecting images.

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