Platformsios 8.0, tvos 9.0
FrameworksUIKit, QuartzCore


Build Status
Cocoapods Compatible
Carthage Compatible


NVActivityIndicatorView is a collection of awesome loading animations.

This is original a fork from DGActivityIndicatorView, inspired by Loaders.css, written in Swift with full implementation of animations, plus more.

You can also find Objective-C version of this here.


alt tag

For first-hand experience, just open the project and run it.

Animation types

1. ballPulse2. ballGridPulse3. ballClipRotate4. squareSpin
5. ballClipRotatePulse6. ballClipRotateMultiple7. ballPulseRise8. ballRotate
9. cubeTransition10. ballZigZag11. ballZigZagDeflect12. ballTrianglePath
13. ballScale14. lineScale15. lineScaleParty16. ballScaleMultiple
17. ballPulseSync18. ballBeat19. lineScalePulseOut20. lineScalePulseOutRapid
21. ballScaleRipple22. ballScaleRippleMultiple23. ballSpinFadeLoader24. lineSpinFadeLoader
25. triangleSkewSpin26. pacman27. ballGridBeat28. semiCircleSpin
29. ballRotateChase30. orbit31. audioEqualizer32. circleStrokeSpin



Install Cocoapods if need be.

$ gem install cocoapods

Add NVActivityIndicatorView in your Podfile.


pod 'NVActivityIndicatorView'

Then, run the following command.

$ pod install


Install Carthage if need be.

$ brew update
$ brew install carthage

Add NVActivityIndicatorView in your Cartfile.

github "ninjaprox/NVActivityIndicatorView"

Run carthage to build the framework and drag the built NVActivityIndicatorView.framework into your Xcode project.

Note: You might encounter compile issue, if so please use carthage branch instead. Check issue #101 for more information.


Copy NVActivityIndicatorView folder to your project. That’s it.

Note: Make sure that all files in NVActivityIndicatorView included in Compile Sources in Build Phases.

Note: If you encounter issues while uploading the app to iTunes Connect, remove the Info.plist file in NVActivityIndicatorView. Check issue #129 for more information.


Version 4.0.0

This version requires Xcode 9.0 and Swift 4.

Version 3.7.0

This version splits NVActivityIndicatorView pod to 2 subpods NVActivityIndicatorView/Presenter and NVActivityIndicatorView/AppExtension. There is no need to change pod NVActivityIndicatorView to pod NVActivityIndicatorView/Presenter since it will be installed by default if you use the main pod name.

However, if you want to use NVActivityIndicatorView in app extension, use pod NVActivityIndicatorView/AppExtension instead.

Note: Related issue #119.

Version 3.6.0

This version requires Xcode 8.3 and Swift 3.1.

Version 3.0

This version requires Xcode 8.0 and Swift 3.

  • NVActivityIndicatorView.startAnimation() and NVActivityIndicatorView.stopAnimation() are deleted. Use NVActivityIndicatorView.startAnimating() and NVActivityIndicatorView.stopAnimating() instead.
  • UIViewController.startActivityAnimating() and UIViewController.stopActivityAnimating() are deleted. Use UIViewController.startAnimating() and UIViewController.stopAnimating() instead.

Version 2.0

This version continues to spport Xcode 7.0 and Swift 2.2 and earlier.
For Swift 2.3 support, use swift2.3 branch instead.

pod 'NVActivityIndicatorView', :git => '', :branch => 'swift2.3'


Firstly, import NVActivityIndicatorView.

import NVActivityIndicatorView


Then, there are two ways you can create NVActivityIndicatorView:

  • By storyboard, changing class of any UIView to NVActivityIndicatorView.

Note: Set Module to NVActivityIndicatorView.

  • By code, using initializer. All parameters other than frame are optional and NVActivityIndicatorView.DEFAULT_* are used as default values.
NVActivityIndicatorView(frame: frame, type: type, color: color, padding: padding)


Start animating.


Stop animating.


Determine if it is animating.

animating = activityIndicatorView.isAnimating

Change properties

In storyboard, you can change all properties in Attributes inspector tab of Utilities panel.

Note: Use one of values (case-insensitive) in Animation types for Type Name.

All properties are public so you can change them after initializing.

Note: All changes must be made before calling startAnimating().

UI blocker

By conforming NVActivityIndicatorViewable protocol, you can use NVActivityIndicatorView as UI blocker for UIViewController.

class ViewController: UIViewController, NVActivityIndicatorViewable { }

Start animating.

startAnimating(size, message) // plus other parameters as in initializer.

Stop animating.


Check if it is animating.

animating = isAnimating

Or you can use NVActivityIndicatorPresenter to display UI blocker anywhere.

Start animating.

let activityData = ActivityData()


Note: Check documentation for detail of ActivityData.

Stop animating.


Change message.


Check if it is animating.

animating = NVActivityIndicatorPresenter.sharedInstance.isAnimating


Thanks Connor Atherton for great loaders and Danil Gontovnik for kick-start.


The MIT License (MIT)

Copyright (c) 2016 Vinh Nguyen @ninjaprox

Latest podspec

    "name": "NVActivityIndicatorViewWithoutPulse",
    "version": "5.0.2",
    "summary": "A collection of awesome loading animations",
    "homepage": "",
    "screenshots": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Jose Antonio": "[email protected]"
    "platforms": {
        "ios": "8.0",
        "tvos": "9.0"
    "source": {
        "git": "",
        "tag": "5.0.2"
    "default_subspecs": "Presenter",
    "frameworks": [
    "subspecs": [
            "name": "Presenter",
            "source_files": "NVActivityIndicatorView/NVActivityIndicatorView/**/*.swift"
            "name": "AppExtension",
            "source_files": "NVActivityIndicatorView/NVActivityIndicatorView/**/*.swift",
            "exclude_files": "NVActivityIndicatorView/NVActivityIndicatorView/Presenter/*.swift"

Pin It on Pinterest

Share This