https://github.com/indragiek/SNRMusicKit

All-in-one framework for browsing and playing music from various sources on iOS and OS X
https://github.com/indragiek/SNRMusicKit

Last synced: 2 months ago
JSON representation

All-in-one framework for browsing and playing music from various sources on iOS and OS X

• Host: GitHub
• URL: https://github.com/indragiek/SNRMusicKit
• Owner: indragiek
• Created: 2012-08-21T16:38:18.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-10-23T02:45:45.000Z (about 9 years ago)
• Last Synced: 2024-10-27T12:06:56.735Z (3 months ago)
• Language: Objective-C
• Homepage:
• Size: 4.27 MB
• Stars: 149
• Watchers: 14
• Forks: 19
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome - SNRMusicKit - All-in-one framework for browsing and playing music from various sources on iOS and OS X (etc)
• awesome - SNRMusicKit - All-in-one framework for browsing and playing music from various sources on iOS and OS X (etc)

README

        
## SNRMusicKit

SNRMusicKit is an open source project that will become the backbone for [Sonora](http://getsonora.com) and other music applications that we may build for the Mac and iOS platforms. This framework will consist of the following components that will create an all-in-one solution for building content rich music applications:

* **Content Sources**: Services and applications that will provide content.

* **Players**: Different audio players sharing a common interface to handle a wide variety of content formats. 

* **Other Services**: Objective-C interfaces to other commonly used services like Last.fm.

All local databases will be **Core Data** SQL databases, in addition to other persistent caching of artwork, etc. All networking code will be built on top of [AFNetworking](https://github.com/AFNetworking/AFNetworking), specifically subclasses of **AFHTTPClient**.

The code and API will be as modern as possible, making use of blocks, GCD, and new Objective-C syntax.  The current goal is to target **OS X 10.7+ and iOS 5.0+** but that may change.

### Contributing

Once the project is under way, I'd love contributions via pull requests. If you intend on making large additions or changes to the code, you may want to consult with me before beginning to ensure that we both agree that it is suitable for this library. 

### Compiling

* Clone the git repository, and download the submodules using the following commands:

```

cd 

git submodule init

git submodule update

```

#### Additional Instructions for Mac Framework only

* **SFBAudioEngine** requires some additional frameworks and libraries to compile that are not included in the repository. Download [this](https://github.com/downloads/sbooth/SFBAudioEngine/Frameworks.tar.bz2) archive, extract it, and put the Frameworks folder inside the SFBAudioEngine folder.

* **[mogenerator](https://github.com/rentzsch/mogenerator)** needs to be installed to successfully compile.

### Progress

#### Content Sources

  

    NameiOSMacImplemented

  

  

    iTunes✘✔✔

  

  

    MPMediaLibrary✔✘✔

  

  

    Spotify✔✔✔

  

#### Players

  

    NameiOSMacImplemented

  

  

    AVQueuePlayer✔✔✔

  

  

    MPMusicPlayerController✔✘✔

  

  

    SFBAudioEngine✔✔✔

  

  

    Spotify SDK✔✔✔

  

### Roadmap

#### Short term

* ~~iOS MPMediaLibrary content source implementation~~

* Queue controller for playing a queue of songs

* ~~Cross platform artwork cache~~

* Search protocols & implementation for MPMediaLibrary and Spotify

* ~~Last.fm engine for scrobbling (basically a polished version of SNRLastFMEngine built on AFNetworking)~~

#### Long term

* 8tracks content source implementation

### License

This library is licensed under the [BSD License](http://opensource.org/licenses/bsd-license.php). All third party libraries used in the project must be licensed under BSD or a similarly unrestrictive license (ie. MIT is acceptable, GPL or any of its variants are not). By making contributions to this project, you are **licensing your own additions under the BSD license as well**. Any contributions licensed under anything else will not be accepted into the master repository (but feel free to keep them in your own fork).