UIView subclass to easily add a cool animated photo carrusel to your iOS app
Objective-C Ruby
Latest commit 38870ab Nov 9, 2015 @JaviSoto Merge pull request #8 from fkuehne/featurebranch
Add tvOS support and fix compilation warning
Failed to load latest commit information.
AnimatedImagesViewSampleApp Using MSWeakTimer so that the clients don't need to stop the animatio… Jul 12, 2013
Dependencies Added the actual MSWeakTimer submodule Jul 12, 2013
.gitignore Adding gitignore Feb 15, 2012
JSAnimatedImagesView.m Fix implicit integer precision loss Nov 7, 2015
JSAnimatedImagesView.podspec Enable tvOS Nov 7, 2015
LICENSE Change license to MIT Jul 12, 2013
README.markdown Added link to documentation Jul 12, 2013



Easy to use UIView subclass to quickly add a cool animated carrousel of pictures to your app.

Documentation: http://cocoadocs.org/docsets/JSAnimatedImagesView/





  • Using CocoaPods:
  • Add pod 'JSAnimatedImagesView', '~> 1.0.' to your Podfile.
  • You're done!

-- or --

  • Clone the repository:
$ git clone git@github.com:JaviSoto/JSAnimatedImagesView.git
  • Update the submodules:
$ git submodule update --init
  • Check out the sample project.
  • Drag the two files JSAnimatedImagesView.(h/m) onto your project.
  • Drag Dependencies/MSWeakTimer/MSWeakTimer.(h/m) onto your project.
  • Include the header file JSAnimatedImagesView.h into the controller where you want to use it.
  • Create a JSAnimatedImagesView instance either via code, or in interface builder (by creating a UIView and changing its class to JSAnimatedImagesView).
  • Set the data source property on the view (probably on the viewDidLoad method):
self.animatedImagesView.dataSource = self;
  • Implement the data source methods:
@interface MyViewController () <JSAnimatedImagesViewDataSource> // Conform to the protocol

@implementation MyViewController

- (NSUInteger)animatedImagesNumberOfImages:(JSAnimatedImagesView *)animatedImagesView
    return self.myImageNames.count;

- (UIImage *)animatedImagesView:(JSAnimatedImagesView *)animatedImagesView imageAtIndex:(NSUInteger)index
    return [UIImage imageNamed:[self.myImageNames objectAtIndex:index]];



@property (nonatomic, assign) NSTimeInterval timePerImage;

Specifies the time each image is viewed until the next image is faded in.

@property (nonatomic, assign) NSTimeInterval transitionDuration;

Specifies the duration of the transition (fade-out/fade-in) animation.


  • JSAnimatedImagesView is compatible with iOS5.0+
  • JSAnimatedImagesView requires ARC.

Attributions (Creative Commons Images)


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