https://github.com/sdwebimage/libavif-xcode
A wrapper for libavif + Xcode project. Support Carthage && CocoaPods && SwiftPM.
https://github.com/sdwebimage/libavif-xcode
aomdec aomenc av1 avif carthage cocoapods ios swiftpm
Last synced: 3 months ago
JSON representation
A wrapper for libavif + Xcode project. Support Carthage && CocoaPods && SwiftPM.
- Host: GitHub
- URL: https://github.com/sdwebimage/libavif-xcode
- Owner: SDWebImage
- Created: 2019-04-14T15:20:10.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-22T15:50:19.000Z (about 2 years ago)
- Last Synced: 2025-07-18T08:23:11.614Z (3 months ago)
- Topics: aomdec, aomenc, av1, avif, carthage, cocoapods, ios, swiftpm
- Language: Ruby
- Homepage:
- Size: 62.5 KB
- Stars: 18
- Watchers: 8
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# libavif + Xcode
[](https://travis-ci.org/SDWebImage/libavif-Xcode)
[](http://cocoapods.org/pods/libavif)
[](http://cocoapods.org/pods/libavif)
[](http://cocoapods.org/pods/libavif)
[](https://github.com/SDWebImage/libavif-Xcode)
A wrapper for [libavif](https://github.com/AOMediaCodec/libavif) + Xcode project.
This enables Carthage && SwiftPM support.
This repo also including the CocoaPods's spec file to use libavif.
## Requirements
+ iOS 9
+ macOS 10.10
+ tvOS 9.0 (rav1e unavailable)
+ watchOS 2.0 (rav1e unavailable)
## AV1 Codec
### aom
By default, libavif is built with [aom](https://aomedia.googlesource.com/aom/) codec support. aom is the first AV1 codec during the standard draft implementation.
However, there are also other AV1 codec implementation available. libavif supports most of them. You can choose to integarte the one you'd like. By default we use aom for both decoding and encoding.
### dav1d (Decoding)
[dav1d](https://github.com/videolan/dav1d) is the new and next generation AV1 codec, focused on speed and correctness.
See more about [explanation for why starting a new project but not improving aom](https://github.com/videolan/dav1d#why-do-you-not-improve-libaom-rather-than-starting-a-new-project)
From v0.3.0, libavif can built with dav1d. For CocoaPods user, you can simply use the subspec for this. Carthage for optional dav1d codec is not supported currently.
### libgav1 (Decoding)
[libgav1](https://chromium.googlesource.com/codecs/libgav1/) libgav1 is a Main profile (0) & High profile (1) compliant AV1 decoder. More information on the AV1 video format can be found at aomedia.org.
From v0.8.3, libavif can built with libgav1. For For CocoaPods user, you can simply use the subspec for this.
### rav1e (Encoding)
[rav1e](https://github.com/xiph/rav1e) is the fastest and safest AV1 encoder. Which use [Rust programming](https://www.rust-lang.org/) to provide fast and safe codec compared to aom. Its current form it is most suitable for cases where libaom (the reference encoder) is too slow.
See more about [performance](https://github.com/xiph/rav1e/issues/1248)
From v0.4.3, libavif can built with rav1e. For CocoaPods user, you can simply use the subspec for this. Carthage for optional rav1c codec is not supported currently.
Note rav1e currently only support iOS && macOS. watchOS and tvOS supports need Rust community upstream support.
### SVT-AV1 (Encoding)
[SVT-AV1](https://gitlab.com/AOMediaCodec/SVT-AV1) is the Scalable Video Technology for AV1 (SVT-AV1 Encoder and Decoder) is an AV1-compliant encoder/decoder library core.
From v0.8.3, libavif can built with STV-AV1. For For CocoaPods user, you can simply use the subspec for this.
## Installation
### Carthage
libavif is (via this repo) available through [Carthage](https://github.com/Carthage/Carthage).
```
github "SDWebImage/libavif-Xcode"
```
Note Carthage does not support dav1d/rav1e/SVT-AV1 optional codec, use only aom.
### CocoaPods
libavif is available through [CocoaPods](https://github.com/CocoaPods/CocoaPods).
By default, libavif is built with aom decoding/encoding codec, which is stable, but slow.
```
pod 'libavif'
```
If you need the dav1d decoding codec, use the subspec:
```
pod 'libavif/libdav1d'
```
If you need the libgav1 decoding codec, use the subspec:
```
pod 'libavif/libgav1'
```
If you need the rav1e encoding codec, use the subspec:
```
pod 'libavif/librav1e'
```
If you need the SVT-AV1 encoding codec, use the subspec:
```
pod 'libavif/SVT-AV1'
```
If you need the sharpyuv RGB to YUV420 conversion, use the subspec:
```
pod 'libavif/sharpyuv'
```
### SwiftPM
libavif is available through [Swift Package Manager](https://img.shields.io/badge/SwiftPM-compatible-brightgreen.svg).
```swift
let package = Package(
dependencies: [
.package(url: "https://github.com/SDWebImage/libavif-Xcode", from: "0.4.5")
],
// ...
)
```
Note SwiftPM does not support dav1d/rav1e/SVT-AV1 optional codec, use only aom.
## Usage
Use libavif as you would normally, this is just a repo that adds an Xcode proj.
For Swift Package Manager user, it's recommended to use the modular import instead of C headers.
+ Objective-C
```objective-c
@import libavif;
// or if you don't use module
#import
```
+ Swift
```swift
import libavif
```
## License
libavif is available under the [BSD License](https://github.com/AOMediaCodec/libavif/blob/master/LICENSE).