Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/AnyImageKit/AnyImageKit

A toolbox for pick/edit/capture photo or video. Written in Swift.
https://github.com/AnyImageKit/AnyImageKit

capture crop-image drawing editor gif ios multiple-photos swift5 uiimagepickercontroller video

Last synced: 4 months ago
JSON representation

A toolbox for pick/edit/capture photo or video. Written in Swift.

Host: GitHub
URL: https://github.com/AnyImageKit/AnyImageKit
Owner: AnyImageKit
License: mit
Created: 2019-09-16T04:59:59.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-01-12T07:29:22.000Z (6 months ago)
Last Synced: 2024-01-12T19:35:17.022Z (6 months ago)
Topics: capture, crop-image, drawing, editor, gif, ios, multiple-photos, swift5, uiimagepickercontroller, video
Language: Swift
Homepage:
Size: 6.91 MB
Stars: 688
Watchers: 21
Forks: 96
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-ios - AnyImageKit
awesome-stars - AnyImageKit/AnyImageKit - A toolbox for pick/edit/capture photo or video. Written in Swift. (Swift)

README

        ![AnyImageKit](https://github.com/AnyImageProject/AnyImageProject.github.io/raw/master/Resources/[email protected])

[![GitHub Actions](https://github.com/AnyImageKit/AnyImageKit/workflows/build/badge.svg?branch=master)](https://github.com/AnyImageKit/AnyImageKit/actions?query=workflow%3Abuild)

[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/AnyImageKit.svg)](https://cocoapods.org/pods/AnyImageKit)

[![Platform](https://img.shields.io/cocoapods/p/AnyImageKit.svg?style=flat)](./)

[![License](https://img.shields.io/cocoapods/l/AnyImageKit.svg?style=flat)](https://raw.githubusercontent.com/AnyImageKit/AnyImageKit/master/LICENSE)

`AnyImageKit` is a toolbox for picking, editing or capturing photos/videos, written in Swift. 

> [中文说明](./Documentation/README_CN.md)

## Features

- [x] Modular design

    - [x] Picker

    - [ ] Browser

    - [x] Editor

    - [x] Capture

- [x] Light mode, dark mode or auto mode support

- [x] Default theme is similar with Wechat 

- [x] Multiple & mix select support

- [x] Supported media types:

    - [x] Photo

    - [x] GIF

    - [x] Live Photo

    - [x] Video

- [x] Camera

    - [x] Photo

    - [x] Video

    - [ ] Live Photo

    - [ ] GIF

    - [ ] Filter Support

- [ ] Edit image ( Technical Preview )

    - [x] Drawing

    - [ ] Emoji

    - [x] Input text

    - [x] Cropping

    - [x] Mosaic

    - [x] Rotate

    - [ ] Filter Support

- [x] Multiple platform support

    - [x] iOS

    - [x] iPadOS

    - [x] Mac Catalyst ( Technical Preview, Not support in editor.)

    - [ ] macOS

    - [ ] tvOS

- [x] Internationalization support

    - [x] English (en)

    - [x] Chinese, Simplified (zh-Hans)

    - [x] Turkish (tr)

    - [x] Portuguese(Brazil) (pt-BR)

    - [ ] and more... (Pull requests welcome)

## Requirements

- iOS 12.0+

- Xcode 14.1+

- Swift 5.7+

## Installation

### [Swift Package Manager](https://swift.org/package-manager/)

⚠️ Needs Xcode 12.0+ to support resources and localization files

```swift

dependencies: [

    .package(url: "https://github.com/AnyImageKit/AnyImageKit.git", .upToNextMajor(from: "0.15.1"))

]

```

### [CocoaPods](https://guides.cocoapods.org/using/using-cocoapods.html)

Add this to `Podfile`, and then update dependency:

```ruby

pod 'AnyImageKit'

```

## Usage

### Prepare

Add these keys to your Info.plist when needed:

| Key | Module | Info |

| ----- | ----  | ---- |

| NSPhotoLibraryUsageDescription | Picker |  |

| NSPhotoLibraryAddUsageDescription | Picker |  |

| PHPhotoLibraryPreventAutomaticLimitedAccessAlert | Picker | Set `YES` to prevent automatic limited access alert in iOS 14+ (Picker has been adapted with Limited features that can be triggered by the user to enhance the user experience) |

| NSCameraUsageDescription | Capture |  |

| NSMicrophoneUsageDescription | Capture |  |

### Quick Start

```swift

import AnyImageKit

class ViewController: UIViewController {

    @IBAction private func openPicker(_ sender: UIButton) {

        var options = PickerOptionsInfo()

        /*

          Your code, handle custom options

        */

        let controller = ImagePickerController(options: options, delegate: self)

        present(controller, animated: true, completion: nil)

    }

}

extension ViewController: ImagePickerControllerDelegate {

    func imagePickerDidCancel(_ picker: ImagePickerController) {

        /*

          Your code, handle user cancel

        */

        picker.dismiss(animated: true, completion: nil)

    }

    

    func imagePicker(_ picker: ImagePickerController, didFinishPicking result: PickerResult) {

        let images = result.assets.map { $0.image }

        /*

          Your code, handle selected assets

        */

        picker.dismiss(animated: true, completion: nil)

    }

}

```

## Release Notes

### Latest version

| Version | Release Date | Xcode | Swift | iOS |

| ---- | ----  | ---- | ---- | ---- |

| [v0.17.1](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0171) | 2024-01-12 | 15.2 | 5.9 | 12.0+ |

   History version  

| Version | Release Date | Xcode | Swift | iOS |

| ---- | ----  | ---- | ---- | ---- |

| [v0.17.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0170) | 2023-10-18 | 15.0 | 5.9 | 12.0+ |

| [v0.16.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0160) | 2023-05-09 | 14.3 | 5.8 | 12.0+ |

| [v0.15.1](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0151) | 2022-12-15 | 14.1 | 5.7 | 12.0+ |

| [v0.15.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0150) | 2022-11-11 | 14.1 | 5.7 | 12.0+ |

| [v0.14.6](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0146) | 2022-07-06 | 13.4.1 | 5.6 | 13.0+ |

| [v0.14.5](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0145) | 2022-07-05 | 13.4.1 | 5.6 | 13.0+ |

| [v0.14.4](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0144) | 2022-04-06 | 13.3 | 5.5 | 12.0+ |

| [v0.14.3](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0143) | 2021-12-28 | 13.2 | 5.5 | 12.0+ |

| [v0.14.2](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0142) | 2021-12-16 | 13.2 | 5.5 | 12.0+ |

| [v0.14.1](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0141) | 2021-11-23 | 13.1 | 5.5 | 12.0+ |

| [v0.14.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0140) | 2021-11-22 | 13.1 | 5.5 | 12.0+ |

| [v0.13.5](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0135) | 2021-10-15 | 13.0 | 5.5 | 12.0+ |

| [v0.13.4](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0134) | 2021-09-23 | 13.0 | 5.5 | 12.0+ |

| [v0.13.3](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0133) | 2021-08-09 | 12.5 | 5.4 | 10.0+ |

| [v0.13.2](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0132) | 2021-06-30 | 12.5 | 5.4 | 10.0+ |

| [v0.13.1](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0131) | 2021-06-01 | 12.5 | 5.4 | 10.0+ |

| [v0.13.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0130) | 2021-02-08 | 12.4 | 5.3 | 10.0+ |

| [v0.12.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0120) | 2020-12-30 | 12.2 | 5.3 | 10.0+ |

| [v0.11.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0110) | 2020-12-18 | 12.2 | 5.3 | 10.0+ |

| [v0.10.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#0100) | 2020-11-03 | 12.1 | 5.3 | 10.0+ |

| [v0.9.0](https://github.com/AnyImageKit/AnyImageKit/blob/master/Documentation/RELEASE_NOTE.md#090) | 2020-10-09 | 12.0 | 5.3 | 10.0+ |

## License

AnyImageKit is released under the MIT license. See [LICENSE](./LICENSE) for details.