Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Aufree/ESTMusicIndicator
Cool Animated music indicator view written in Swift
https://github.com/Aufree/ESTMusicIndicator
Last synced: 3 months ago
JSON representation
Cool Animated music indicator view written in Swift
- Host: GitHub
- URL: https://github.com/Aufree/ESTMusicIndicator
- Owner: Aufree
- License: mit
- Created: 2015-12-30T12:16:18.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2020-12-07T10:48:54.000Z (almost 4 years ago)
- Last Synced: 2024-07-30T18:43:11.895Z (3 months ago)
- Language: Swift
- Homepage:
- Size: 49.8 KB
- Stars: 467
- Watchers: 15
- Forks: 68
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - ESTMusicIndicator - Cool Animated music indicator view written in Swift. (Media / Audio)
- awesome-swift - EstMusicIndicator - Music play indicator like iTunes. (Libs / UI)
- awesome-swift - EstMusicIndicator - Music play indicator like iTunes. (Libs / UI)
- awesome-ios-star - ESTMusicIndicator - Cool Animated music indicator view written in Swift. (Media / Audio)
- fucking-awesome-swift - EstMusicIndicator - Music play indicator like iTunes. (Libs / UI)
- awesome-swift-cn - EstMusicIndicator - Music play indicator like iTunes (Libs / UI)
- awesome-swift - EstMusicIndicator - Cool Animated music indicator view written in Swift ` 📝 3 years ago ` (UI [🔝](#readme))
README
Cool Animated music indicator view written in Swift.
ESTMusicIndicator is an implementation of [NAKPlaybackIndicatorView](https://github.com/yujinakayama/NAKPlaybackIndicatorView) in Swift for iOS 8.
> - 本人著作的书籍[《Laravel 入门教程》](https://laravel-china.org/laravel-tutorial/5.1)已正式发布，有兴趣的朋友可点击 [此处](https://laravel-china.org/topics/3383) 作进一步了解。
## You may interested in my other project
* [PHPHub-iOS](https://github.com/aufree/phphub-ios) PHPHub for iOS is the universal iPhone and iPad application for PHPHub.
* [ESTMusicPlayer](https://github.com/Aufree/ESTMusicPlayer) An elegant and simple iOS music player.
* [ESTCollectionViewDropDownList](https://github.com/Aufree/ESTCollectionViewDropDownList) A demo implementation of a drop down tag list view for iOS.
* [Hodor](https://github.com/Aufree/Hodor) A simple solution to localize your iOS App quickly.
## Requirements
* An iPhone/iPad running iOS 8.0+
* Xcode 7.0 or above
## Screenshots
## Run the Demo
```bash
$ open Example/ESTMusicIndicator.xcodeproj
```
## Installation
### CocoaPods
CocoaPods is a dependency manager for Cocoa projects.
CocoaPods 0.36 adds supports for Swift and embedded frameworks. You can install it with the following command:
```bash
$ gem install cocoapods
```
To integrate ESTMusicIndicatorView into your Xcode project using CocoaPods, specify it in your Podfile:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
pod 'ESTMusicIndicator'
```
Then, run the following command:
```bash
$ pod install
```
You can check out [this link](http://www.raywenderlich.com/97014) for more information about how to use CocoaPods.
### Manually
1. Clone this project or download it.
2. Drag and drop Classes folder to your workspace
## Usage
Simple Example:
```swift
let indicator = ESTMusicIndicatorView.init(frame: CGRect.zero)
indicator.tintColor = .red
indicator.sizeToFit()
view.addSubview(indicator)
```
Initially the `state` property is ESTMusicIndicatorViewStateStopped and the `hidesWhenStopped` property is YES.
Thus, the view is hidden at this time.
The view appears and the bars start animation.
```swift
indicator.state = .playing;
```
The bars stop animation and become idle.
```swift
indicator.state = .paused;
```
The view becomes hidden.
```swift
indicator.state = .stopped;
```
You can use ESTMusicIndicatorView in both code and Storyboard, and it works well with both Auto Layout and frame-based layout.
### Code with Auto Layout
```swift
let indicator = ESTMusicIndicatorView.init(frame: CGRect.zero)
indicator.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(indicator)
```
Then, add some positioning layout constraints.
Note that normally you don't need to add sizing constraints since ESTMusicIndicatorView has an intrinsic content size.
It will be automatically resized to fit its content.
### Code with Frame-Based Layout
```swift
let indicator = ESTMusicIndicatorView.init(frame: CGRect.zero)
view.addSubview(indicator)
indicator.sizeToFit() // Resize itself to fit its content.
```
## Customization
### Color
The color of the bars can be changed by setting `tintColor` property (`UIView`) of the view or its ancestor view.
### Size
Normally the view can be automatically resized to fit its content by:
* Omitting sizing constraints in Auto Layout, since it has an intrinsic content size.
* Calling `sizeToFit` in frame-based layout.
Or if you explicitly specify size, the bars will be placed in the center of the view.
## Contact
You can ping me on [Twitter](https://twitter.com/_Paul_King_) or follow me on [Weibo](http://weibo.com/jinfali) If you find an issue.
## Contributing
Thank you for your interest in contributing to Hodor! Your ideas for improving this app are greatly appreciated. The best way to contribute is by submitting a pull request. I'll do my best to respond to you as soon as possible. You can also [submit a new GitHub issue](https://github.com/Aufree/ESTMusicIndicator/issues/new) if you find bugs or have questions.
## Thanks for
* [NAKPlaybackIndicatorView](https://github.com/yujinakayama/NAKPlaybackIndicatorView)
## License
Copyright (c) 2017-2018 Paul King
---
Released under the [MIT license](https://github.com/Aufree/ESTMusicIndicator/blob/master/LICENSE)