/vinylogue

A simple Last.fm client for iOS

Primary LanguageObjective-CBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

vinylogue for Last.fm

Vinylogue is a simple Last.fm client for iOS that shows you and your friends' charts from previous years.

Getting started

Apologies, this is a little cumbersome.

  1. Clone the repo. $ git clone git://github.com/twocentstudios/vinylogue.git

  2. Install the pods. $ pod install

  3. Open vinylogue.xcworkspace.

  4. Create a new header file called TCSVinylogueSecret.h

  5. Copy and paste this code into TCSVinylogueSecret.h.

     #define kFlurryAPIKey @""  
     #define kCrashlyticsAPIKey @""  
     #define kTestFlightAPIKey @""  
     #define kTCSLastFMAPIKeyString @"YOUR_API_KEY"  
    
  6. Add your API keys to the above code (Only the Last.fm one is required).

  7. Remove Crashlytics.framework from the Targets->Build Phases->Link Binary With Libraries menu.

  8. Delete the "Run Script" build phase from the same menu.

  9. Build!

Learn

This project was both an app I wanted to exist, and a learning experience for me regarding ReactiveCocoa. I hope other iOS devs can learn from it. I haven't done much open source in the past, and have learned by studying the source great projects such as Cheddar and news:yc (amongst many others), so it felt like it was time to give back.

I wrote a pretty extensive blog post covering several parts of the design and development of this app. If you're looking for a guided tour through the source, check that out first.

License

License for source is Modified BSD. If there's enough interest, I can modularize particular parts of the source into their own MIT Licensed components.

All rights are reserved for image assets.

This is very much an experiment for me that I'm hoping doesn't backfire. If you'd like to improve the app, please fork and submit pull requests and we'll keep one version on the App Store for everyone to enjoy. Don't charge for other versions (I'm pretty sure it violates Last.fm's TOS anyway).

About

Vinylogue was created by Christopher Trott. My development shop is called twocentstudios.