Latest 1.1.3
License MIT
Platforms ios 6.0, requires ARC
Dependencies Shimmer
Frameworks UIKit, QuartzCore, CoreGraphics, Foundation

This is a beauful hud view for iPhone & iPad

CI Status
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.




Wilson-Yuan, [email protected]


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

Latest podspec

    "name": "WSProgressHUD",
    "version": "1.1.3",
    "summary": "WSProgressHUD is a beauful hud view for iPhone & iPad.",
    "description": "WSProgressHUD is a beauful hud view for iPhone & iPad. you can simple to use it.nn* Think: Why did you write this? What is the focus? What does it do?n* CocoaPods will be using this to generate tags, and improve search results.n* Try to keep it short, snappy and to the point.n* Finally, don't worry about the indent, CocoaPods strips it",
    "homepage": "",
    "screenshots": "",
    "license": "MIT",
    "authors": {
        "u8881u4ed5u5d07": "[email protected]"
    "platforms": {
        "ios": "6.0"
    "source": {
        "git": "",
        "tag": "1.1.3"
    "source_files": "WSProgressHUD/*",
    "exclude_files": "Demo/Exclude",
    "resources": "WSProgressHUD/*.bundle",
    "frameworks": [
    "requires_arc": true,
    "dependencies": {
        "Shimmer": []

Pin It on Pinterest

Share This