Skip to content
This is a beauful hud view for iPhone & iPad
Branch: master
Clone or download
Latest commit b636a72 Jun 8, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
Demo update share schemes Jun 7, 2017
.travis.yml Fix name issue Feb 13, 2017
LICENSE update LICENSE Jun 8, 2017 Update README Jun 8, 2017


This is a beauful hud view for iPhone & iPad

CI Status Version License Platform Carthage compatible



To Download the project. Run the WSProgressHUD.xcodeproj in the demo directory.

    [WSProgressHUD show];
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{

        dispatch_async(dispatch_get_main_queue(), ^{
        [WSProgressHUD dismiss];

//Show on the self.view

@implementation ViewController
    WSProgressHUD *hud;
- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.

    //Add HUD to view
    hud = [[WSProgressHUD alloc] initWithView:self.navigationController.view];
    [self.view addSubview:hud];

    [hud showWithString:@"Wating..." maskType:WSProgressHUDMaskTypeBlack];

    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
        [hud dismiss];


//Show on the window
    [WSProgressHUD show];

    //Show with mask
    [WSProgressHUD showWithMaskType:WSProgressHUDMaskTypeBlack];
    //Show with mask without tabbar
    [WSProgressHUD showWithStatus:@"Loading..." maskType:WSProgressHUDMaskTypeBlack maskWithout:WSProgressHUDMaskWithoutTabbar];
    //Show with string
    [WSProgressHUD showWithStatus:@"Loading..."];

    //Show with facebook shimmering
    [WSProgressHUD showShimmeringString:@"WSProgressHUD Loading..."];

    //Show with Progress
    [WSProgressHUD showProgress:progress status:@"Updating..."];

    //Show with image
    [WSProgressHUD showSuccessWithStatus:@"Thanks.."];
    //Show with string
    [WSProgressHUD showImage:nil status:@"WSProgressHUD"]

    [WSProgressHUD dismiss];
    //And There have 3 indicator style for your choice
    [WSProgressHUD setProgressHUDIndicatorStyle:WSProgressHUDIndicatorSmall] //small custom spinner


From CocoaPods

WSProgressHUD is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'WSProgressHUD'


Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate WSProgressHUD into your Xcode project using Carthage, specify it in your Cartfile:

github "devSC/WSProgressHUD"

Run carthage update to build the framework and drag the built WSProgressHUD.framework (in Carthage/Build/iOS folder) into your Xcode project (Linked Frameworks and Libraries in Targets).


Drag the WSProgressHUD/Demo/WSProgressHUD folder into your project. Then take care that WSProgressHUD.bundle is added to Targets->Build Phases->Copy Bundle Resources. Add the QuartzCore framework to your project.


Even though WSProgressHUD is written in Objective-C, it can be used in Swift with no hassle. If you use CocoaPods add the following line to your Podfile:


If you added WSProgressHUD manually, just add a bridging header file to your project with the WSProgressHUD header included.


@Shimmering @SVProgressHUD @MMMaterialDesignSpinner




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

You can’t perform that action at this time.