Animoji

Build Status Carthage Compatible Language Version License Platform

Animoji is an iOS library that gives access to the private framework AvatarKit to generate Animoji, just like the Messages app.

Supports iOS 12.2 Animoji (Boar, Giraffe, Owl, Shark)!

Animoji uses iPhone X and iOS 11.1 features so no Simulator support yet.

Demo Video

$ pod try Animoji

Requirements

  • iOS 11.1+
  • Xcode 9.1+
  • Swift 5 (Animoji 1.x), Swift 4 (Animoji 0.x)

Usage

You can initialize an Animoji like a UIView. Animoji is a SCNView so if your using a storyboard/xib use a SceneKit View.

import Animoji

let animoji = Animoji(frame: self.view.bounds)
animoji.setPuppet(name: .cat)
view.addSubview(animoji)

Installation

Animoji is available via CocoaPods and Carthage.

CocoaPods

To install with CocoaPods, simply add this in your Podfile:

use_frameworks!
pod "Animoji"

Carthage

To install with Carthage, simply add this in your Cartfile:

github "efremidze/Animoji"

Privacy Settings

You must provide a description for how your app uses the following privacy settings in your app’s Info.plist file.

  • NSPhotoLibraryAddUsageDescription
  • NSMicrophoneUsageDescription
  • NSCameraUsageDescription

Disclaimer

Animoji utilizes Apple’s private API to do its magic. Use caution, submitting this code to the App Store adds the risk of being rejected!

Communication

  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

Apps Using Animoji

Feel free to submit a PR if you’re using this library in your apps.

License

Animoji is available under the MIT license. See the LICENSE file for more info.