Latest 1.2.0
License BSD
Platforms ios 10.0
Dependencies Kingfisher


CI Status


GMSimplePLayer is a customizable view player.
You can customize It styling via code or via Interface Builder.
To use It you can create an instance with It’s initializer or just add a GMPlayer view to your .xib file.
If you do not want to customize the Player don’t worry! The GMPlayer has a basic styling.
You can play a single track or multiples tracks.

You can customize:

  • Player tint color (Background).
  • Player Bars tint color.
  • Player Controls tint colors (Buttons).
  • Player controls bar height.
  • Player top bar height (Navigation bar).
  • Player bar hidden time.
  • Player bar hidden animation time.
  • Player seek time (fowward and back).
  • Player images (play, pause, seek forward, seek back, previous, next and slider).
  • Player slider image size (If base dot image selected, dot size can be configured).
  • Player title font size.


To run the example project, follow these steps:

  • 1 – clone the repo: git clone
  • 2 – Change to Example folder: cd GMSimplePlayer/Example/.
  • 3 – Install pods: pod install.
  • 4 – Open Workspace: open GMSimplePlayer.xcworkspace.


GMSimplePlayer Version Minimum iOS Target Minimum OS X Target Notes
1.0.0 iOS 9.0 OS X 10.10.4 Xcode 8 required.


1) Download CocoaPods

CocoaPods is a dependency manager for iOS, which automates and simplifies the process of using 3rd-party libraries in your projects.

CocoaPods is distributed as a ruby gem, and is installed by running the following commands in

$ sudo gem install cocoapods
$ pod setup

2) Create Podfile

In the project root folder, run the following command to create a Podfile:

$ pod init

If an YOURXCODEPROJECTFILE project file is specified or if there is only a single project file in the current directory, targets will be automatically generated based on targets defined in the project.

3) Add dependencies:

An empty Podfile was created, so we are going to add dependencies to the Podfile specifying pods versions:

To use the latest version of a Pod, ommit the version specification:

pod 'GMSimplePlayer'

Freezing to a specific Pod version:

pod 'GMSimplePlayer', '1.0.0'

Using logical operators:

  • '> 0.1', Any version higher than 0.1.
  • '>= 0.1', Any version higher or equal to 0.1.
  • '< 0.1', Any version lower than 0.1.
  • '<= 0.1', Any version lower or equal to 0.1.

Using optimistic operators:

  • '~> 0.1.0', Version 0.1.0 or higher up to 0.2, not including 0.2.
  • '~> 0.1', Version 0.1 or higher up to 1.0, not including 1.0.

4) Install dependencies

Install Pods dependencies in your project. Run the following commands:

$ pod install

From now on, be sure to always open the generated Xcode workspace (.xcworkspace) instead of the project file when building your project.


  • If you need help, use Stack Overflow. (Tag ‘GMSimplePlayer’)
  • If you’d like to ask a general question, use Stack Overflow.
  • If you found a bug, and can provide steps to reliably reproduce it, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.
  • If you want to contact the owner of the project, write an email to CocoaPods. To install
    it, simply add the following line to your Podfile:

    pod 'GMSimplePlayer'


    Gaston Montes, [email protected]


    GMSimplePlayer is available under the BSD license. See the LICENSE file for more info.

    Latest podspec

        "name": "GMSimplePlayer",
        "version": "1.2.0",
        "summary": "GMSimplePlayer is a simple and customizable player.",
        "description": "GMSimplePlayer is a simple and customizable player. You can customize via code or interface builder Its icons, colors, labels, fonts, etc.",
        "homepage": "",
        "license": {
            "type": "BSD",
            "file": "LICENSE"
        "authors": {
            "Gaston Montes": "[email protected]"
        "source": {
            "git": "",
            "tag": "1.2.0"
        "social_media_url": "",
        "platforms": {
            "ios": "10.0"
        "source_files": "GMSimplePlayer/Classes/**/*",
        "resources": "GMSimplePlayer/Assets/Assets.xcassets",
        "dependencies": {
            "Kingfisher": [
                "~> 4.1.1"

Pin It on Pinterest

Share This