Swiftpack.co - longitachi/ZLPhotoBrowser as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
Wechat-like image picker. Support select normal photos, videos, gif and livePhoto. Support edit image and crop video. 微信样式的图片选择器,支持预览/相册内拍照及录视频、拖拽/滑动选择,编辑图片/视频,支持多语言国际化等功能;
.package(url: "https://github.com/longitachi/ZLPhotoBrowser.git", from: "4.1.8")

Version Carthage compatible SwiftPM compatible License Platform Language


Warning: If your APP includes China in the App Store sales area, please update to the latest version(>= 4.1.9). issue

English | 简体中文

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


Detailed usage of Swift and OC, please refer to Wiki.

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


  • ☑ iOS14 supported.
  • ☑ Portrait and landscape.
  • ☑ Two framework style.
  • ☑ 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), (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 12.x


  • Preview selection
let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] (images, assets, isOriginal) in
    // your code
ps.showPreview(animate: true, sender: self)
  • Library selection
let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] (images, assets, isOriginal) in
    // your code
ps.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 English
Localized resources can be mixed   YES

Privacy - Photo Library Usage Description

Privacy - Camera Usage Description

Privacy - Microphone Usage Description

Update Log

More logs

● 4.1.9
    Remove CallKit.
● 4.1.8
    Support crop round image.
    Show an alert to prompt that app cannot access the microphone.
    Wrap to display when the text is too long.
    The http header of the network video can be configured.
    Improve the judgment logic of Live Photo.
    Edit the image directly after taking the photo.
    Camera cannot turning on while calling.
● 4.1.7
    Add a property to control whether to display the selection button animation when selecting.
    Separate the colors shared by album list interface and perview interface.
    Add a cancel block in the camera view controller.
    Support export video.


🇨🇳 Chinese, 🇺🇸 English, 🇯🇵 Japanese, 🇫🇷 French, 🇩🇪 German, 🇷🇺 Russian, 🇻🇳 Vietnamese, 🇰🇷 Korean, 🇲🇾 Malay, 🇮🇹 Italian.


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'

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

Then, run the following command:

$ pod install

If you cannot find the latest version, you can execute pod 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 ZLPhotoBrowser

If you get an error like Building 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.

Swift Package Manager

  1. Select File > Swift Packages > Add Package Dependency. Enter https://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.0.9" 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

Demo Effect

  • Selection image image image

  • Image editor


  • Video editor


  • Multi-language


  • Custom camera



Stars: 3869
Last commit: 6 hours ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

6 hours ago


  • Remove CallKit because it resulted in rejection of app review.#650

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics