SoundCloud client written on Swift to integrate it easily with your apps.

Features

• Fluent interface based on Models
• Reactive API with ReactiveCocoa 4.0
• User session management (Oauth handling and session persistence)
• Music player
• Swift 2.0 features (generics, enums, ...)
• 100% tested
• Command Line tool

Dependencies

• Alamofire: Alamofire is an HTTP networking library written in Swift.
• ReactiveCocoa: ReactiveCocoa (RAC) is a Cocoa framework inspired by Functional Reactive Programming. It provides APIs for composing and transforming streams of values over time.
• Genome: A simple, type safe, failure driven mapping library for serializing JSON to models in Swift 2.0 (Supports Linux)
• Keychain-Swift: Helper functions for storing text in Keychain for iOS, OS X, tvOS and WatchOS
• Quick & Nimble: The Swift (and Objective-C) testing and matching frameworks.
• Mockingjay: An elegant library for stubbing HTTP requests in Swift, allowing you to stub any HTTP/HTTPS using NSURLConnection or NSURLSession. That includes any request made from libraries such as Alamofire and AFNetworking.

Communication

• If you need help, use Stack Overflow
• If you'd like to ask a general question, use Stack Overflow.
• If you found a bug, open an issue.
• If you have a feature request, open an issue.
• If you want to contribute, submit a pull request.

Installation

Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate SoundCloudSwift into your Xcode project using Carthage, specify it in your Cartfile:

github "soundcloud/SoundCloudSwift"

Cocoapods

You can also integrate SoundCloudSwift using CocoaPods. Just add the following line to your Podfile:

pod "SoundCloudSwift", :git => "https://github.com/soundcloud/SoundCloudSwift.git"

And execute pod install. Remember to open the project using the file .xcworkspace

Wiki

• Authentication

Documentation

• SoundCloud API: Link
• SoundCloudAPI (Objective-C client): Link

Security Disclosure

If you believe you have identified a security vulnerability with SoundCloudSwift, you should report it as soon as possible via email to pepi@soundcloud.com. Please do not post it to a public issue tracker.

License

SoundCloudSwift is released under the MIT license. See LICENSE for details.