/MusicPlayerViewController

An iPhone view controller to visualize and control music playback

Primary LanguageObjective-COtherNOASSERTION

MusicPlayerViewController Build Status Cocoa Pod

SCreenshot

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, 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
  2. Add all files from Source/ to your project's target
  3. Add the frameworks MessageUI and MediaPlayer to your target

Alternatively, you can use the fabulous CocoaPods:

  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 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 )