{"id":2263,"url":"https://github.com/MatiBot/MBCircularProgressBar","last_synced_at":"2025-08-02T23:32:47.068Z","repository":{"id":56920159,"uuid":"39333020","full_name":"MatiBot/MBCircularProgressBar","owner":"MatiBot","description":"A circular, animatable \u0026 highly customizable progress bar from the Interface Builder (Objective-C)","archived":false,"fork":false,"pushed_at":"2024-05-07T16:14:39.000Z","size":1366,"stargazers_count":994,"open_issues_count":54,"forks_count":180,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-10-30T08:32:21.089Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.cocoacontrols.com/controls/mbcircularprogressbar","language":"Objective-C","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/MatiBot.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2015-07-19T12:29:19.000Z","updated_at":"2024-09-18T03:10:59.000Z","dependencies_parsed_at":"2023-02-10T15:00:15.971Z","dependency_job_id":"d3bfdd00-8a93-4fb6-b7c5-0d05815dfd4b","html_url":"https://github.com/MatiBot/MBCircularProgressBar","commit_stats":{"total_commits":98,"total_committers":10,"mean_commits":9.8,"dds":0.326530612244898,"last_synced_commit":"9637b1a7bbde72b8fe3e6321f09a2bbecd8962cf"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatiBot%2FMBCircularProgressBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatiBot%2FMBCircularProgressBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatiBot%2FMBCircularProgressBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MatiBot%2FMBCircularProgressBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MatiBot","download_url":"https://codeload.github.com/MatiBot/MBCircularProgressBar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228503167,"owners_count":17930527,"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":[],"created_at":"2024-01-05T20:16:09.240Z","updated_at":"2024-12-06T17:30:57.018Z","avatar_url":"https://github.com/MatiBot.png","language":"Objective-C","funding_links":[],"categories":["UI","Progress","Objective-C"],"sub_categories":["Activity Indicator","Other free courses"],"readme":"[![Version](https://img.shields.io/cocoapods/v/MBCircularProgressBar.svg?style=flat)](http://cocoapods.org/pods/MBCircularProgressBar)\n[![License](https://img.shields.io/cocoapods/l/MBCircularProgressBar.svg?style=flat)](http://cocoapods.org/pods/MBCircularProgressBar)\n[![Platform](https://img.shields.io/cocoapods/p/MBCircularProgressBar.svg?style=flat)](http://cocoapods.org/pods/MBCircularProgressBar)\n[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![Analytics](https://ga-beacon.appspot.com/UA-66922648-1/matibot/MBCircularProgressBar?pixel)](https://github.com/matibot/MBCircularProgressBar)\n\nIf you use MBCircularProgressBar, please tell me and I will add your app here.\n\n\n![](https://raw.github.com/matibot/MBCircularProgressBar/0.2/Readme/example.png)\n![](https://raw.github.com/matibot/MBCircularProgressBar/0.2/Readme/MBCircularProgressBar.gif)\n\n## Usage\n\nTo run the example project, clone the repo, and run `pod update` from the Example directory first.\n\n## Installation\n\n### Cocoapods\n\nMBCircularProgressBar is available through [CocoaPods](http://cocoapods.org).\n\nTo install it, simply add the following lines to your Podfile:\n\n* Add this line to the begining of your Podfile in order to support @IBDesignable. More info [here](http://blog.cocoapods.org/CocoaPods-0.36/) (Thanks to: [@StevenMasini](https://github.com/StevenMasini))\n\n```ruby\nuse_frameworks!\n```\n\n* Add this line so with every Pod install/update cocoapods would download the library intro your project:\n\n```ruby\npod \"MBCircularProgressBar\"\n```\n\n### Installation with Carthage\n\n[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.\n\nYou can install Carthage with [Homebrew](http://brew.sh/) using the following command:\n\n```bash\n$ brew update\n$ brew install carthage\n```\n\nTo integrate MBCircularProgressBar into your Xcode project using Carthage, specify it in your `Cartfile`:\n\n```ogdl\ngithub \"MatiBot/MBCircularProgressBar\"\n```\n\nRun `carthage update` to build the framework and drag the built `MBCircularProgressBar.framework` into your Xcode project.\n\n\n### Directly\n\nYou can also download the MBCircularProgressBar{View,Layer}.{m,h} files into your project directly\n\n\n## Properties\n\nProperty name | Property type | Description | Range\n------------ | ------------- | ------------- | -------------\nvalue | CGFloat | The value to be displayed in the center | [0,maxValue]\nmaxValue | CGFloat | The maximum possible value, used to calculate the progress (value/maxValue)  | [0,∞)\nshowValueString | BOOL | Should show value string |\nshowUnitString | BOOL | Should show unit string |\nvalueFontName | NSString | The name of the font of the value string | Any valid font name\nvalueFontSize | CGFloat | The font size of the value text  | [0,∞)\nvalueFontName | NSString | The name of the font of the unit string | Any valid font name\nunitFontSize | CGFloat | The font size of the unit text | [0,∞)\nunitString | NSString | The string that represents the units, usually % |\nfontColor | UIColor | The color of the value and unit text |\ndecimalPlaces | NSInteger | Number of decimal places of the value | [0,∞)\nprogressRotationAngle | CGFloat | Progress bar rotation (Clockewise)| [0,100]\nprogressAngle | CGFloat | Set a partial angle for the progress bar | [0,100]\nprogressLineWidth | CGFloat | The width of the progress bar (user space units)  | [0,∞)\nprogressColor | UIColor | The color of the progress bar |\nprogressStrokeColor | UIColor | The color of the progress bar frame  |\nprogressCapType | NSInteger | The shape of the progress bar cap | {kCGLineCapButt=0, kCGLineCapRound=1, kCGLineCapSquare=2}\nemptyLineWidth | CGFloat | The width of the background bar (user space units) | [0,∞)\nemptyLineColor | UIColor | The color of the background bar |\nemptyCapType | CGFloat | The shape of the background bar cap | {kCGLineCapButt=0, kCGLineCapRound=1, kCGLineCapSquare=2}\ntextOffset | CGPoint | The offset to apply to the unit / value text | (0,0) = center of the circle\n\n## Animation\n\nIn order to animate a change in the progress bar you should nest the value property manipulation in a `[UIView animateWithDuration:]` method\n\n```objc\n    [UIView animateWithDuration:1.f animations:^{\n        self.progressBar.value = 55.f;\n    }];\n```\n![](https://raw.github.com/matibot/MBCircularProgressBar/master/Readme/animation.gif)\n\n## References\n\n[[iOS][Swift] MBCircularProgressBar で円形のプログレスバーを実現](http://dev.classmethod.jp/smartphone/mbcircularprogressbar/)  by [@cocominap](https://twitter.com/cocominap) (in Japanese)\n\n## Author\n\nMati Bot, os@mati.bot, [@b0tnik](https://twitter.com/b0tnik)\n\n## Apps that use it:\n\n[20 Hours](https://itunes.apple.com/us/app/id1141979499)\n\n## License\n\nMBCircularProgressBar is available under the MIT license. See the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMatiBot%2FMBCircularProgressBar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMatiBot%2FMBCircularProgressBar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMatiBot%2FMBCircularProgressBar/lists"}