{"id":17203245,"url":"https://github.com/longitachi/zlimageeditor","last_synced_at":"2025-05-16T18:07:58.821Z","repository":{"id":38219028,"uuid":"315232174","full_name":"longitachi/ZLImageEditor","owner":"longitachi","description":"A powerful image editor framework. Supports graffiti, cropping, mosaic, text stickers, image stickers, filters.","archived":false,"fork":false,"pushed_at":"2024-08-26T11:47:32.000Z","size":969,"stargazers_count":563,"open_issues_count":6,"forks_count":103,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-03T17:12:59.205Z","etag":null,"topics":["crop","draw","filter","graffiti","image-editor","image-sticker","mosaic","text-sticker"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/longitachi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-23T07:22:12.000Z","updated_at":"2025-04-03T08:13:46.000Z","dependencies_parsed_at":"2023-02-19T05:31:31.616Z","dependency_job_id":"cbba8518-b0d9-4205-b8e4-f5a53988ede2","html_url":"https://github.com/longitachi/ZLImageEditor","commit_stats":{"total_commits":65,"total_committers":9,"mean_commits":7.222222222222222,"dds":0.3846153846153846,"last_synced_commit":"fe55f57bd087ec24d210a9a9d4c2e07bd7d4e884"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longitachi%2FZLImageEditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longitachi%2FZLImageEditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longitachi%2FZLImageEditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/longitachi%2FZLImageEditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/longitachi","download_url":"https://codeload.github.com/longitachi/ZLImageEditor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248598683,"owners_count":21131134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crop","draw","filter","graffiti","image-editor","image-sticker","mosaic","text-sticker"],"created_at":"2024-10-15T02:17:23.849Z","updated_at":"2025-05-16T18:07:58.816Z","avatar_url":"https://github.com/longitachi.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Version](https://img.shields.io/github/v/tag/longitachi/ZLImageEditor.svg?color=blue\u0026include_prereleases=\u0026sort=semver)](https://cocoapods.org/pods/ZLImageEditor)\n[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-brightgreen.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![SwiftPM compatible](https://img.shields.io/badge/SwiftPM-supported-E57141.svg)](https://swift.org/package-manager/)\n[![License](https://img.shields.io/badge/license-MIT-black)](https://raw.githubusercontent.com/longitachi/ZLImageEditor/master/LICENSE)\n[![Platform](https://img.shields.io/badge/Platforms-iOS-blue?style=flat)](https://img.shields.io/badge/Platforms-iOS-blue?style=flat)\n![Language](https://img.shields.io/badge/Language-%20Swift%20-E57141.svg)\n\n\u003cimg src=\"https://github.com/longitachi/ImageFolder/blob/master/ZLImageEditor/ZLImageEditor.png\" width = \"277\" height = \"600\" div align=center/\u003e\n\n---------------\n\nZLImageEditor is a powerful image editor framework. Supports graffiti, cropping, mosaic, text stickers, picture stickers, filters, adjust(brightness, contrast, saturation).\n\nZLImageEditor is extracted from [ZLPhotoBrowser](https://github.com/longitachi/ZLPhotoBrowser).\n\n### Directory\n* [Features](#Features)\n* [Requirements](#Requirements)\n* [Usage](#Usage)\n* [Change Log](#ChangeLog)\n* [Languages](#Languages)\n* [Installation(Support Cocoapods/Carthage/SPM)](#Installation)\n* [Support](#Support)\n* [Demo Effect](#DemoEffect)\n\n### \u003ca id=\"Features\"\u003e\u003c/a\u003eFeatures\n- [x] Draw (Support custom line color).\n- [x] Crop (Support custom crop ratios).\n- [x] Image sticker (Support custom image sticker container view).\n- [x] Text sticker  (Support custom text color).\n- [x] Mosaic.\n- [x] Filter (Support custom filters).\n- [x] Adjust (Brightness, Contrast, Saturation).\n\n### \u003ca id=\"Requirements\"\u003e\u003c/a\u003eRequirements\n | v \u003e= 2.0.0 | iOS 10.0+ |\n | --- | --- |\n | v \\\u003c 2.0.0 | iOS 9.0+ |\n * Swift 5.x\n * Xcode 12.x\n\n### \u003ca id=\"Usage\"\u003e\u003c/a\u003eUsage\n```swift\nZLImageEditorConfiguration.default()\n    .editImageTools([.draw, .clip, .imageSticker, .textSticker, .mosaic, .filter, .adjust])\n    .adjustTools([.brightness, .contrast, .saturation])\n\nZLEditImageViewController.showEditImageVC(parentVC: self, image: image, editModel: editModel) { [weak self] (resImage, editModel) in\n    // your code\n}\n```\n\n### \u003ca id=\"ChangeLog\"\u003e\u003c/a\u003eChange Log\n\u003e [More logs](https://github.com/longitachi/ZLImageEditor/blob/master/CHANGELOG.md)\n```\n● 2.0.4\n  Add:\n    Added a callback for cancelling editing.\n● 2.0.3\n  Add:\n    Enhance the user experience of the image cropping interface and optimize the animation effects.\n  Fix:\n    Fix the bug that causes a crash when entering the cropping interface while the app only supports landscape mode.\n● 2.0.2\n  Add:\n    Adapt the text sticker input interface for iPad landscape mode.\n  Fix:\n    Fix the bug where cropping square images to circular shape fails.\n...\n```\n\n### \u003ca id=\"Languages\"\u003e\u003c/a\u003eLanguages\n🇨🇳 Chinese (Simplified/Traditional), 🇺🇸 English, 🇯🇵 Japanese, 🇫🇷 French, 🇩🇪 German, 🇺🇦 Ukranian, 🇷🇺 Russian, 🇻🇳 Vietnamese, 🇰🇷 Korean, 🇲🇾 Malay, 🇮🇹 Italian, 🇮🇩 Indonesian, 🇪🇸 Spanish, 🇵🇹 Portuguese, 🇹🇷 Turkey, 🇸🇦 Arabic, 🇳🇱 Dutch.\n\n### \u003ca id=\"Installation\"\u003e\u003c/a\u003eInstallation\nThere are four ways to use ZLImageEditor in your project:\n\n  - using CocoaPods\n  - using Carthage\n  - using Swift Package Manager\n  - manual install (build frameworks or embed Xcode Project)\n\n#### CocoaPods\nTo integrate ZLImageEditor into your Xcode project using CocoaPods, specify it to a target in your Podfile:\n\n```\nsource 'https://github.com/CocoaPods/Specs.git'\nplatform :ios, '10.0'\nuse_frameworks!\n\ntarget 'MyApp' do\n  # your other pod\n  # ...\n  pod 'ZLImageEditor'\nend\n```\n\nThen, run the following command:\n\n```\n$ pod install\n```\n\n\u003e If you cannot find the latest version, you can execute `pod repo update` first\n\n#### Carthage\nTo integrate ZLImageEditor into your Xcode project using Carthage, specify it in your Cartfile:\n\n```\ngithub \"longitachi/ZLImageEditor\"\n```\n\nThen, run the following command to build the ZLImageEditor framework:\n\n```\n$ carthage update ZLImageEditor\n```\n\n#### Swift Package Manager\n1. Select File \u003e Swift Packages \u003e Add Package Dependency. Enter https://github.com/longitachi/ZLImageEditor.git in the \"Choose Package Repository\" dialog.\n2. In the next page, specify the version resolving rule as \"Up to Next Major\" with \"2.0.4\" as its earliest version.\n3. After Xcode checking out the source and resolving the version, you can choose the \"ZLImageEditor\" library and add it to your app target.\n\n### \u003ca id=\"Support\"\u003e\u003c/a\u003e Support\n* [**★ Star**](#) this repo.\n* Support with \u003cimg src=\"https://github.com/longitachi/ImageFolder/blob/master/ZLPhotoBrowser/ap.png\" width = \"100\" height = \"125\" /\u003e or \u003cimg src=\"https://github.com/longitachi/ImageFolder/blob/master/ZLPhotoBrowser/wp.png\" width = \"100\" height = \"125\" /\u003e or \u003cimg src=\"https://github.com/longitachi/ImageFolder/blob/master/ZLPhotoBrowser/pp.png\" width = \"150\" height = \"125\" /\u003e\n\n### \u003ca id=\"DemoEffect\"\u003e\u003c/a\u003e Demo Effect\n![image](https://github.com/longitachi/ImageFolder/blob/master/ZLImageEditor/editImage.gif)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongitachi%2Fzlimageeditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flongitachi%2Fzlimageeditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flongitachi%2Fzlimageeditor/lists"}