Skip to content
UI control to play a music and indicate its progress for iOS
Objective-C Ruby
Find file
Pull request Compare This branch is 2 commits ahead, 35 commits behind yoichitgy:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
EECircularMusicPlayer.xcodeproj
EECircularMusicPlayerControl
EECircularMusicPlayerExample
Images
.gitattributes
.gitignore
EECircularMusicPlayerControl.podspec
LICENSE.txt
README.md

README.md

EECircularMusicPlayerControl

EECircularMusicPlayerControl is a UI control to play a music and indicate its progress. It's easy to use in your project, and supports customization of the colors applied to the component parts.

Screenshot

Installation

Copy the files in "EECircularMusicPlayerControl" directory to your project.

Usage

First, create a class that conforms to EECircularMusicPlayerControlDelegate protocol, which has currentTime method. Usually it can be a UIViewController where an EECircularMusicPlayerControl is placed.

Then, set delegate property of the EECircularMusicPlayerControl.

self.yourCircularMusicPlayerControl.delegate = self; // Or any delegate.

At last, set duration property of the control.

self.yourCircularMusicPlayerControl.duration = self.yourAudioPlayer.duration;

That's all you have to do! The example app in "EECircularMusicPlayerExample" directory shows a practical example to use the control with AVAudioPlayer. There is another way to use EECircularMusicPlayerControl without the delegate. Refet to example #2 in the example app to see how to use it without the delegate.

Customization

The following properties can be customized to make your own appearance:

  • progressTrackRatio
  • trackTintColor
  • highlightedTrackTintColor
  • progressTintColor
  • highlightedProgressTintColor
  • buttonTopTintColor
  • highlightedButtonTopTintColor
  • buttonBottomTintColor
  • highlightedButtonBottomTintColor
  • iconColor
  • highlightedIconColor

Roadmap

The following features shall be implemented in the next update. If you implement one of the features, please feel free to send a pull request.

  • Add paused state. Current version has only playing and stopped states.
  • Add shadow or gradient effects to draw the control. Currently it's filled with solid colors.

LEGAL

DACircularProgress

EECircularMusicPlayerControl contains DACircularProgress by Daniel Amitay available under MIT license. Refer to "LICENSE.md" and "README.md" files in "DACircularProgress" directory for more information.

XTC of Gold (Sample Audio)

The example project contains the music "XTC of Gold" by Beatnabob, also known as Jimdubtrix, available under a Creative Commons Attribution-NoDerivs license.

License

EECircularMusicPlayerControl is available under MIT license. Refer to "LICENSE.txt" file for details.

Credits

If you are going to use EECircularMusicPlayerControl in your project, proper attribution would be nice.

Something went wrong with that request. Please try again.