How do I integrate AXPhotoViewer with Kingfisher for image loading?

Install the Kingfisher subspec by adding 'pod AXPhotoViewer/Kingfisher' to your Podfile, then use the default network integration in PhotosViewController, which automatically leverages Kingfisher for async image downloads and caching.

Is AXPhotoViewer better than NYTPhotoViewer for iOS photo galleries?

AXPhotoViewer offers deeper customization and more third-party network integrations, but NYTPhotoViewer is more actively maintained. Choose AXPhotoViewer if you need extensive UI control and are okay with an unmaintained library.

Can AXPhotoViewer handle GIFs on tvOS?

Yes, it supports GIFs on tvOS, but you need to configure your network integration appropriately—for example, enabling animated image data in Nuke as per the README's notes on GIF support.

How to add a custom caption view in AXPhotoViewer?

Set the captionView property on the overlayView of PhotosViewController to your custom view that conforms to AXCaptionViewProtocol, ensuring it's self-sizing as described in the customization section of the README.

What are the risks of using an unmaintained library like AXPhotoViewer in 2024?

You may face compatibility issues with newer iOS versions, lack bug fixes, and have no support for modern features like SwiftUI or Dark Mode. It's best for legacy projects or where customization outweighs maintenance needs.

How to implement force touch with AXPhotoViewer in Objective-C?

Use the PreviewingPhotosViewController as shown in the README's Swift example, but adapt it for Objective-C by importing the library and following the same previewing context methods, ensuring your data source is set up correctly.

Open-Awesome

AXPhotoViewer

MITSwiftv1.7.1

An iOS/tvOS photo gallery viewer with contextual presentation, interactive dismissal, and async image loading support.

Visit Website GitHub

656 stars122 forks0 contributors

What is AXPhotoViewer?

AXPhotoViewer is an open-source iOS/tvOS library for displaying photo galleries with smooth animations and interactive gestures. It solves the need for a customizable, native-feeling image viewer that integrates easily with async image downloading and caching libraries. Developers can present large or small sets of photos and GIFs with contextual transitions and flick-to-dismiss behavior.

Target Audience

iOS and tvOS developers building apps that need to display photo galleries, such as social media apps, photo management tools, or media-rich applications. It's suitable for both Swift and Objective-C codebases.

Value Proposition

Developers choose AXPhotoViewer for its deep customization options, support for major third-party image libraries, and native interactive gestures like contextual presentation and flick-to-dismiss. Its modular design allows extensive UI customization without sacrificing performance.

Overview

An iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.

Use Cases

Best For

Adding a photo gallery to social media or photo-sharing iOS apps
Building media-rich applications that display user-generated content
Implementing force touch previews for images in table or collection views
Creating customizable image viewers with branded UI components
Integrating with async image libraries like SDWebImage or Kingfisher
Developing tvOS apps that require smooth photo browsing experiences

Not Ideal For

Projects targeting iOS 14+ or SwiftUI that need modern API compatibility and active updates
Teams requiring long-term maintenance, bug fixes, or community support for production apps
Apps where simplicity and out-of-the-box functionality are prioritized over deep customization

Pros & Cons

Pros

Extensive UI Customization

Allows replacing core components like loading views, caption views, and title views with custom self-sizing views, as detailed in the README's customization section.

Broad Network Library Support

Integrates with popular async image libraries like SDWebImage, Kingfisher, and Nuke via Cocoapods subspecs, reducing implementation effort for common use cases.

Interactive Native Gestures

Provides smooth contextual presentation from a source image view and intuitive flick-to-dismiss behavior, enhancing the user experience with native-feeling animations.

Force Touch Implementation

Includes a dedicated PreviewingPhotosViewController for 3D Touch previews, with example code in the README for easy integration into table or collection views.

Cons

Unmaintained Since 2019

The project is no longer updated, as stated in the README, posing risks for compatibility with newer iOS versions, security patches, and bug fixes.

Manual Framework Setup

If not using Cocoapods, developers must manually add MobileCoreServices.framework and other required frameworks, adding complexity to integration.

Dependent on External Pods

Network integrations rely on third-party libraries that may have their own maintenance issues or breaking changes, increasing dependency management overhead.

Frequently Asked Questions

Related Projects

Kingfisher

A lightweight, pure-Swift library for downloading and caching images from the web.

Stars24,332

Forks2,759

Last commit19 days ago

GPU Image

An open source iOS framework for GPU-based image and video processing

Stars20,303

Forks4,565

Last commit2 years ago

Nuke

Image loading system

Stars8,588

Forks560

Last commit16 days ago

FastImageCache

iOS library for quickly displaying images while scrolling

Stars8,071

Forks924