https://github.com/BeamApp/MusicPlayerViewController

An iPhone view controller to visualize and control music playback
https://github.com/BeamApp/MusicPlayerViewController

Last synced: 3 months ago
JSON representation

An iPhone view controller to visualize and control music playback

• Host: GitHub
• URL: https://github.com/BeamApp/MusicPlayerViewController
• Owner: BeamApp
• License: other
• Created: 2012-05-30T08:01:19.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2014-03-18T11:46:00.000Z (almost 11 years ago)
• Last Synced: 2024-04-27T00:00:57.331Z (9 months ago)
• Language: Objective-C
• Size: 2.37 MB
• Stars: 347
• Watchers: 35
• Forks: 71
• Open Issues: 16
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - MusicPlayerViewController - An iPhone view controller to visualize and control music playback (etc)
• awesome - MusicPlayerViewController - An iPhone view controller to visualize and control music playback (etc)

README

        
MusicPlayerViewController [![Build Status](https://travis-ci.org/BeamApp/MusicPlayerViewController.png?branch=master)](https://travis-ci.org/BeamApp/MusicPlayerViewController) [![Cocoa Pod](http://cocoapod-badges.herokuapp.com/v/BeamMusicPlayerViewController/badge.png)](http://cocoadocs.org/docsets/BeamMusicPlayerViewController/)

=========================

![SCreenshot](https://github.com/BeamApp/MusicPlayerViewController/raw/master/Documentation/images/screen.png)

MusicPlayerViewController aimes to be a drop-in component that serves as an UI for a Music Player on iPhone and iPad by replicating the Music.app's user interface.

MusicPlayerViewController has the following features

* UI for iPhone and iPad

* Support for variable-speed scrobbling

* Support for resolution/device-dependent cover art

* Controllable using a data source and an optional delegate

* Three Repeat Modes and Shuffle mode

Usage

-------

You can read the full [API Reference at CocoaDocs](http://cocoadocs.org/docsets/BeamMusicPlayerViewController/), but using the component itself is simple.

Since it is derived from a standard UIViewController, you can just instantiate it, set a delegate and datasource and are good to go.

    BeamMusicPlayerViewController* controller = [BeamMusicPlayerViewController new];

    controller.delegate = self;

    controller.dataSource = self;

    // Push the controller or something else

The Project contains an example that uses the MediaLibrary to provide data for the UI. You can use this as an starting point.

Installation

------------

To use MusicPlayerViewController in your Project, just 

1. Clone this repository or add it as submodule to your repository

1. Add all files from **Source/** to your project's target

2. Add the frameworks **MessageUI** and **MediaPlayer** to your target

Alternatively, you can use the fabulous [CocoaPods](http://cocoapods.org/):

1. add the dependency `pod 'BeamMusicPlayerViewController'` in your podfile

2. run `pod install`

and you are done.

Development

-------

You are more than welcome to contribute code to this project! Since this project relies on [CocoaPods](http://cocoapods.org/) while describing a Pod itself, make sure to open `BeamMusicPlayerExample.xcworkspace` instead of the project file.

License

-------

The Project is licensed under the new BSD License (see file LICENSE).

© 2013 Beam App UG ( haftungsbeschränkt )