YYWebImage is an efficient open-source framework for asynchronous image loading and caching. It provides a seamless way to download and display images in your iOS apps, all while maximizing performance and minimizing memory footprint.

Key Features

  • Asynchronous Image Loading: YYWebImage allows you to load images from URLs asynchronously, so your UI remains responsive during image loading.
  • Caching Support: The framework provides built-in caching mechanisms to store images locally, reducing network requests and improving performance.
  • Progressive Decoding: It supports progressively decoding images, displaying low-resolution images first and gradually improving the quality as more data is downloaded.
  • Animated Image Support: YYWebImage fully supports animated image formats like GIF, APNG, and WebP, enabling you to display animated images effortlessly.
  • Memory Management: The framework efficiently manages image memory usage by automatically purging the cache when the app receives a memory warning.
  • Image Processing: You can modify and process images before displaying them, using features like resizing, cropping, tinting, and applying filters.
  • Integration with SwiftUI: YYWebImage seamlessly integrates with SwiftUI, making it easy to implement image loading and caching in your SwiftUI-based apps.


To integrate YYWebImage into your Xcode project using CocoaPods, simply add the following line to your Podfile:

pod 'YYWebImage'

If you prefer using Carthage, add the following line to your Cartfile:

github "ibireme/YYWebImage"

For manual installation, download the latest YYWebImage source code and add it to your project.


1. Import the necessary headers in your Swift file:

// Swift
import YYWebImage

2. Load an image asynchronously:

// Example: Load image from URL asynchronously
imageView.yy_setImage(with: URL(string: "https://example.com/image.jpg"), options: [.progressiveBlur, .setImageWithFadeAnimation])

3. Customize image loading options:

// Example: Customize image loading options
let options: YYWebImageOptions = [.setImageWithFadeAnimation, .progressiveBlur, .showNetworkActivity]
imageView.yy_setImage(with: URL(string: "https://example.com/image.jpg"), options: options)

4. Progressive loading with placeholder:

// Example: Progressive loading with a placeholder image
let placeholder = UIImage(named: "placeholder_image")
imageView.yy_setImage(with: URL(string: "https://example.com/image.jpg"), placeholder: placeholder)

For more detailed usage instructions, please refer to the YYWebImage GitHub repository.


YYWebImage is an open-source project developed and maintained by a dedicated community of contributors. Some notable contributors include:

  • Contributor 1 (@contributor1)
  • Contributor 2 (@contributor2)
  • Contributor 3 (@contributor3)


With YYWebImage, you can effortlessly handle image loading and caching in your iOS apps, enjoying improved performance, efficient memory usage, and support for animated images. Whether you are building a simple app or a complex application, YYWebImage provides a robust solution for managing your app’s image assets.