AGCircularPicker is helpful component for creating a controller aimed to manage any calculated parameter
Clone or download
Latest commit 3529593 Sep 12, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
AGCircularPicker Fixed issue when minValue is not 0 Sep 12, 2017
Example Updated AGCircularPickerView to correctly handle initial value Jul 24, 2017
.gitignore Initial commit Jun 23, 2017
.travis.yml Update .travis.yml Sep 12, 2017
AGCircularPicker.podspec Updated podspec Sep 12, 2017
LICENSE Initial commit Jun 23, 2017 Update Jul 19, 2017
_Pods.xcodeproj Initial commit Jun 23, 2017


Made by Agilie CI Status Version License Platform

We are pleased to offer you our new free lightweight plugin named AGCircularPicker.

AGCircularPicker is helpful for creating a controller aimed to manage any calculated parameter. For example, it can be used as a countdown timer or for keeping the score in the game interface.

AGCircularPicker can be customized to meet your individual requirements. The developer can set the number of the controllers and their design by selecting a color, gradient and other similar parameters. In addition, it’s possible to specify the transition type for showing controllers on the screen.

Link to Android repo

Check out our Android CircularPicker


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

pod "AGCircularPicker"


Volume Picker Sreenshot Volume Picker Demo Time Picker Demo


To run the example project, clone the repo, and run pod install from the Example directory first.


import AGCircularPicker

AGCircularPickerView could be used either from Interface Builder by linking outlet or from the code.

The main requirement to let it work is to setup AGCircularPickerOption. Once it is set picker will automatically setup all required data.

public struct AGCircularPickerOption {

    var titleOption: AGCircularPickerTitleOption? = nil
    var valueOption: AGCircularPickerValueOption!
    var colorOption: AGCircularPickerColorOption = AGCircularPickerColorOption()


It consists of three option groups: AGCircularPickerTitleOption (defines title, it's color and font), AGCircularPickerValueOption (defines min and max values and number of rounds) and AGCircularPickerColorOption (defines gradient colors, gradient locations and angle)

AGCircularPickerValueOption is required whereas two others are optionals.

If AGCircularPickerTitleOption is empty control will have no title.

If AGCircularPickerColorOption is not set control will use default colors.

AGCircularPickerView has a delegate to notify about any changes

public protocol AGCircularPickerViewDelegate {

    func circularPickerViewDidChangeValue(_ value: Int, color: UIColor, index: Int)
    func circularPickerViewDidEndSetupWith(_ value: Int, color: UIColor, index: Int)
    func didBeginTracking(timePickerView: AGCircularPickerView)
    func didEndTracking(timePickerView: AGCircularPickerView)


Let's see how we can use it in practice. First we should link it in the Interface Builder

@IBOutlet weak var circularPickerView: AGCircularPickerView!

Then we should define required options and setup control with it and delegate if needed

override func viewDidLoad() {
    let valueOption = AGCircularPickerValueOption(minValue: 0, maxValue: 100)
    let titleOption = AGCircularPickerTitleOption(title: "volume")
    let option = AGCircularPickerOption(valueOption: valueOption, titleOption: titleOption)
    pickerView.setupPicker(delegate: self, option: option)

For more details please see our example


Problems? Check the Issues block to find the solution or create an new issue that we will fix asap. Feel free to contribute.


This iOS visual component is open-sourced by Agilie Team


Contact us

If you have any questions, suggestions or just need a help with web or mobile development, please email us at You can ask us anything from basic to complex questions.


AGCircularPicker is available under The MIT License (MIT) Copyright © 2017 Agilie Team