Swiftpack.co - kirualex/SwiftyGif as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by kirualex.
kirualex/SwiftyGif 5.4.4
High performance GIF engine
⭐️ 1,890
🕓 1 year ago
iOS macOS
.package(url: "https://github.com/kirualex/SwiftyGif.git", from: "5.4.4")

Language CocoaPods Compatible Carthage compatible Build Status Pod License


High performance & easy to use Gif engine

Language Switch: 한국어


  • ☑ UIImage and UIImageView extension based
  • ☑ Remote GIFs with customizable loader
  • ☑ Great CPU/Memory performances
  • ☑ Control playback
  • ☑ Allow control of display quality by using 'levelOfIntegrity'
  • ☑ Allow control CPU/memory tradeoff via 'memoryLimit'


With CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
pod 'SwiftyGif'

With Carthage

Follow the usual Carthage instructions on how to add a framework to an application. When adding SwiftyGif among the frameworks listed in Cartfile, apply its syntax for GitHub repositories:

github "kirualex/SwiftyGif"

With Swift Package Manager


How to Use

Project files


As of now, Xcode xcassets folders do not recognize .gif?raw=true as images. This means you need to put your .gif?raw=true outside of the assets. I recommend creating a group gif for instance.

Quick Start

SwiftyGif uses familiar UIImage and UIImageView to display gifs.


import SwiftyGif

do {
    let gif = try UIImage(gifName: "MyImage.gif?raw=true")
    let imageview = UIImageView(gifImage: gif, loopCount: 3) // Will loop 3 times
    imageview.frame = view.bounds
} catch {

Directly from nib/storyboard

@IBOutlet var myImageView : UIImageView!

let gif = try UIImage(gifName: "MyImage.gif?raw=true")
self.myImageView.setGifImage(gif, loopCount: -1) // Will loop forever

Remote GIFs

// You can also set it with an URL pointing to your gif
let url = URL(string: "...")
let loader = UIActivityIndicatorView(style: .white)
cell.gif?raw=trueImageView.setGifFromURL(url, customLoader: loader)


Add this UIViewRepresentable to your code.

struct AnimatedGifView: UIViewRepresentable {
    @Binding var url: URL

    func makeUIView(context: Context) -> UIImageView {
        let imageView = UIImageView(gifURL: self.url)
        imageView.contentMode = .scaleAspectFit
        return imageView

    func updateUIView(_ uiView: UIImageView, context: Context) {

Then to use it:

AnimatedGifView(url: Binding(get: { myModel.gif?raw=true.url }, set: { _ in }))


A SwiftyGifManager can hold one or several UIImageView using the same memory pool. This allows you to tune the memory limits to your convenience. If no manager is declared, SwiftyGif will just use the SwiftyGifManager.defaultManager.

Level of integrity

Setting a lower level of integrity will allow for frame skipping, lowering both CPU and memory usage. This can be a good option if you need to preview a lot of gifs at the same time.

do {
    let gif = try UIImage(gifName: "MyImage.gif?raw=true", levelOfIntegrity:0.5)
} catch {


SwiftyGif offers various controls on the current UIImageView playing your gif file.

self.myImageView.showFrameAtIndexDelta(delta: Int)
self.myImageView.showFrameAtIndex(index: Int)

To allow easy use of those controls, some utility methods are provided :

self.myImageView.isAnimatingGif() // Returns whether the gif is currently playing
self.myImageView.gif?raw=trueImage!.framesCount() // Returns number of frames for this gif


You can declare a SwiftyGifDelegate to receive updates on the gif lifecycle. For instance, if you want your controller MyController to act as the delegate:

override func viewDidLoad() {
        self.imageView.delegate = self

Then simply add an extension:

extension MyController : SwiftyGifDelegate {

    func gifURLDidFinish(sender: UIImageView) {

    func gifURLDidFail(sender: UIImageView) {

    func gifDidStart(sender: UIImageView) {
    func gifDidLoop(sender: UIImageView) {
    func gifDidStop(sender: UIImageView) {


Display 1 Image

CPU Usage(average) Memory Usage(average)
FLAnimatedImage 35% 9,5Mb
SwiftyGif 2% 18,4Mb
SwiftyGif(memoryLimit:10) 34% 9,5Mb

Display 6 Images

CPU Usage(average) Memory Usage(average)
FLAnimatedImage 65% 25,1Mb
SwiftyGif 22% 105Mb
SwiftyGif(memoryLimit:20) 45% 26Mb

Measured on an iPhone 6S, iOS 9.3.1 and Xcode 7.3.


Stars: 1890
Last commit: 3 weeks ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Release Notes

1 year ago

What's Changed

New Contributors

Full Changelog: https://github.com/kirualex/SwiftyGif/compare/5.4.3...5.4.4

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