HamzaGhazouani/HGCircularSlider
HamzaGhazouani/HGCircularSlider has 2,618 GitHub stars and 274 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-06 20:54 UTC. Last push 2024-08-13.
A custom reusable circular / progress slider control for iOS application.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.md
OriginalHGCircularSlider
Example

To run the example project, clone the repo, and run pod install from the Example directory first.
You also may like
- HGPlaceholders - Nice library to show placeholders for any UITableView in your project
- HGRippleRadarView - A beautiful radar view to show nearby users with ripple animation, fully customizable
Requirements
- iOS 9.0+
- Xcode 11.4
Installation
HGCircularSlider is also available through Swift Package Manager
Follow this doc.
HGCircularSlider is also available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'HGCircularSlider', '~> 2.2.1'
HGCircularSlider is also available through Carthage. To install it, simply add the following line to your Cartfile:
github "HamzaGhazouani/HGCircularSlider"
Usage
- Change the class of a view from UIView to CircularSlider, RangeCircularSlider or MidPointCircularSlider
- Programmatically:
let circularSlider = CircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 1.0
circularSlider.endPointValue = 0.2
OR
let circularSlider = RangeCircularSlider(frame: myFrame)
circularSlider.startThumbImage = UIImage(named: "Bedtime")
circularSlider.endThumbImage = UIImage(named: "Wake")
let dayInSeconds = 24 * 60 * 60
circularSlider.maximumValue = CGFloat(dayInSeconds)
circularSlider.startPointValue = 1 * 60 * 60
circularSlider.endPointValue = 8 * 60 * 60
circularSlider.numberOfRounds = 2 // Two rotations for full 24h range
OR
let circularSlider = MidPointCircularSlider(frame: myFrame)
circularSlider.minimumValue = 0.0
circularSlider.maximumValue = 10.0
circularSlider.distance = 1.0
circularSlider.midPointValue = 5.0
If you would like to use it like a progress view
let progressView = CircularSlider(frame: myFrame)
progressView.minimumValue = 0.0
progressView.maximumValue = 1.0
progressView.endPointValue = 0.2 // the progress
progressView.userInteractionEnabled = false
// to remove padding, for more details see issue #25
progressView.thumbLineWidth = 0.0
progressView.thumbRadius = 0.0
Documentation
Full documentation is available on CocoaDocs.
You can also install documentation locally using jazzy.
References
The UI examples of the demo project inspired from Dribbble.
The project is Inspired by UICircularSlider
Author
Hamza Ghazouani, [email protected]
License
HGCircularSlider is available under the MIT license. See the LICENSE file for more info.
Explore related projects
codecrafters-io/build-your-own-x
Master programming by recreating your favorite technologies from scratch.
560,555 starspublic-apis/public-apis
A collective list of free APIs
496,835 starsmorluto/rea
Reverse engineer anything with agents, from app behavior down to native binaries.
439,090 starsopenclaw/openclaw
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
394,097 stars