{"id":2246,"url":"https://github.com/relatedcode/ProgressHUD","last_synced_at":"2025-08-02T23:32:24.320Z","repository":{"id":11093754,"uuid":"13444403","full_name":"relatedcode/ProgressHUD","owner":"relatedcode","description":"ProgressHUD is a lightweight and easy-to-use HUD for iOS. Over 5000+ animations. ‼️","archived":false,"fork":false,"pushed_at":"2024-09-30T08:25:32.000Z","size":4949,"stargazers_count":2827,"open_issues_count":11,"forks_count":464,"subscribers_count":55,"default_branch":"master","last_synced_at":"2024-12-03T07:04:49.369Z","etag":null,"topics":["activity-indicator","apple","hud","ios-swift","progress","progress-bar","progress-circle","progress-hud","progress-indicator","progress-indicators","progress-ring","progress-tracker","progress-view","progressbar","progresshud","swift-library","swift5"],"latest_commit_sha":null,"homepage":"https://relatedcode.com","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/relatedcode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-10-09T14:25:30.000Z","updated_at":"2024-11-28T06:06:18.000Z","dependencies_parsed_at":"2024-06-18T10:52:00.775Z","dependency_job_id":"e19fc364-1ba4-44aa-b630-1bf3f1265457","html_url":"https://github.com/relatedcode/ProgressHUD","commit_stats":{"total_commits":70,"total_committers":6,"mean_commits":"11.666666666666666","dds":0.08571428571428574,"last_synced_commit":"9364904a42cb25f58d026451140c4080a868e72e"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relatedcode%2FProgressHUD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relatedcode%2FProgressHUD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relatedcode%2FProgressHUD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relatedcode%2FProgressHUD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/relatedcode","download_url":"https://codeload.github.com/relatedcode/ProgressHUD/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228503145,"owners_count":17930520,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activity-indicator","apple","hud","ios-swift","progress","progress-bar","progress-circle","progress-hud","progress-indicator","progress-indicators","progress-ring","progress-tracker","progress-view","progressbar","progresshud","swift-library","swift5"],"created_at":"2024-01-05T20:16:08.745Z","updated_at":"2025-08-02T23:32:24.307Z","avatar_url":"https://github.com/relatedcode.png","language":"Swift","readme":"\u003cimg src=\"https://rel.codes/hud/101.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/001.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/002.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/003.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/004.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/005.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/006.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/007.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/008.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/009.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/010.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/011.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/012.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/013.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/014.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/015.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/016.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/017.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/018.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/019.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/020.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/021.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/102.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/103.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/104.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/202.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/203.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/204.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/205.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/206.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/207.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/208.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/209.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/210.gif\" width=\"80\"\u003e \u003cimg src=\"https://rel.codes/hud/211.gif\" width=\"80\"\u003e \n\n## WHAT'S NEW\n\nFor detailed changes, please refer to the [Change log](CHANGELOG.md).\n\n## OVERVIEW\n\n**ProgressHUD** is a convenient and intuitive HUD tool designed specifically for iOS. It enables the seamless presentation of concise alerts or notifications to your app users in a simple and non-disruptive way.\n\n## INSTALLATION\n\n### Swift Package Manager\n\n[Swift Package Manager](https://www.swift.org/documentation/package-manager) is a tool for managing Swift code distribution.\n\nTo add **ProgressHUD** as a dependency to your project, follow these steps:\n\n1. Open your Swift project in Xcode.\n2. Navigate to `File` -\u003e `Add Package Dependencies...`.\n3. Paste `https://github.com/relatedcode/ProgressHUD.git` into the search bar.\n4. Choose the version you want to use and click `Add Package`.\n\n### Manually\n\nIf you prefer not to use the dependency manager above, you can integrate **ProgressHUD** into your project manually. Simply copy all the `*.swift` files from the `ProgressHUD/Sources` folder into your Xcode project.\n\n## QUICK START\n\n```swift\nProgressHUD.banner(\"Banner title\", \"Banner message to display.\")\n```\n\n```swift\nProgressHUD.banner(\"Banner title\", \"Message to display.\", delay: 2.0)\n```\n\n```swift\nProgressHUD.bannerHide()\n```\n\n```swift\nProgressHUD.animate(\"Some text...\")\n```\n\n```swift\nProgressHUD.animate(\"Some text...\", interaction: false)\n```\n\n```swift\nProgressHUD.animate(\"Please wait...\", .ballVerticalBounce)\n```\n\n```swift\nProgressHUD.succeed()\n```\n\n```swift\nProgressHUD.succeed(\"Some text...\", delay: 1.5)\n```\n\n```swift\nProgressHUD.failed()\n```\n\n```swift\nProgressHUD.failed(\"Some text...\")\n```\n\n```swift\nProgressHUD.progress(0.15)\n```\n\n```swift\nProgressHUD.progress(\"Loading...\", 0.42)\n```\n\n```swift\nProgressHUD.symbol(name: \"box.truck\")\n```\n\n```swift\nProgressHUD.symbol(\"Some text...\", name: \"sun.max\")\n```\n\n```swift\nProgressHUD.dismiss()\n```\n\n```swift\nProgressHUD.remove()\n```\n\n## REQUIREMENTS\n\n- iOS 13.0+\n- Xcode 15.0+\n\n## CUSTOMIZATION\n\nYou can customize attributes like color, font, image, animation type, size, and more by using these methods:\n\n```swift\nProgressHUD.animationType = .circleStrokeSpin\n```\n\n```swift\nProgressHUD.colorHUD = .systemGray\n```\n\n```swift\nProgressHUD.colorBackground = .lightGray\n```\n\n```swift\nProgressHUD.colorAnimation = .systemBlue\n```\n\n```swift\nProgressHUD.colorProgress = .systemBlue\n```\n\n```swift\nProgressHUD.colorStatus = .label\n```\n\n```swift\nProgressHUD.mediaSize = 100\nProgressHUD.marginSize = 50\n```\n\n```swift\nProgressHUD.fontStatus = .boldSystemFont(ofSize: 24)\n```\n\n```swift\nProgressHUD.imageSuccess = UIImage(named: \"success.png\")\nProgressHUD.imageError = UIImage(named: \"error.png\")\n```\n\nA comprehensive list of the predefined enums:\n\n```swift\npublic enum AnimationType: CaseIterable {\n\tcase none\n\tcase activityIndicator\n\tcase ballVerticalBounce\n\tcase barSweepToggle\n\tcase circleArcDotSpin\n\tcase circleBarSpinFade\n\tcase circleDotSpinFade\n\tcase circlePulseMultiple\n\tcase circlePulseSingle\n\tcase circleRippleMultiple\n\tcase circleRippleSingle\n\tcase circleRotateChase\n\tcase circleStrokeSpin\n\tcase dualDotSidestep\n\tcase horizontalBarScaling\n\tcase horizontalDotScaling\n\tcase pacmanProgress\n\tcase quintupleDotDance\n\tcase semiRingRotation\n\tcase sfSymbolBounce\n\tcase squareCircuitSnake\n\tcase triangleDotShift\n}\n```\n\n```swift\npublic enum LiveIcon {\n\tcase succeed\n\tcase failed\n\tcase added\n}\n```\n\n## LICENSE\n\nMIT License\n\nCopyright (c) 2025 Related Code\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","funding_links":[],"categories":["UI","Swift"],"sub_categories":["Activity Indicator","Other free courses"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelatedcode%2FProgressHUD","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frelatedcode%2FProgressHUD","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelatedcode%2FProgressHUD/lists"}