Latest 0.0.6
Homepage https://github.com/xzzz9097/SpotifyKit
License MIT
Platforms ios 11.0, osx 10.12
Authors

A Swift client for Spotify’s Web API.

Build Status
Version
License
Platform

Installation

SpotifyKit is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "SpotifyKit"

Initialization

You can easily create a SpotifyKit helper object by providing your Spotify application data.

let spotifyManager = SpotifyManager(with:
    SpotifyManager.SpotifyDeveloperApplication(
        clientId:     "client_id",
        clientSecret: "client_secret",
        redirectUri:  "redirect_uri"
    )
)

The token data gathered at authentication moment is automatically saved in a secure preference with Keychain.

Authentication

This is arguably the trickiest step. At your app launch, you should call authorization method like this:

spotifyManager.authorize()

It sends a request of authorization for the user’s account, that will result in a HTTP response with the specified URL prefix and the authorization code as parameter.
The method automatically skips the process if a saved token is found.

Then, in order to complete authentication and obtain the token, you must setup a URL scheme (in Info.plist file of your app) and catch the code like this:

iOS

// MARK: in your AppDelegate.swift file

/**
 Catches URLs with specific prefix ("your_spotify_redirect_uri://")
 */
func application(_ application: UIApplication, handleOpen url: URL) -> Bool {
    spotifyManager.saveToken(from: url)

    return true
}

MacOS

/**
 Registers the URL watcher
 */
NSAppleEventManager.shared().setEventHandler(self,
    andSelector: #selector(handleURLEvent),
    forEventClass: AEEventClass(kInternetEventClass),
    andEventID: AEEventID(kAEGetURL))

/**
 Catches URLs with specific prefix ("your_spotify_redirect_uri://")
 */
func handleURLEvent(event: NSAppleEventDescriptor,
                    replyEvent: NSAppleEventDescriptor) {
    if  let descriptor = event.paramDescriptor(forKeyword: keyDirectObject),
        let urlString  = descriptor.stringValue,
        let url        = URL(string: urlString) {
        spotifyManager.saveToken(from: url)
    }
}

Now SpotifyKit is fully authenticated with your user account and you can use all the methods it provides.

Usage

All methods send HTTP request through URLSession API and report the results with simple callbacks

Find

Finds tracks (as in this example), albums or artists in Spotify database:

// Signature
public func find<T>(_ what: T.Type,
                    _ keyword: String,
                    completionHandler: @escaping ([T]) -> Void) where T: SpotifySearchItem

// Example
spotifyManager.find(SpotifyTrack.self, "track_title") { tracks in
    // Tracks is a [SpotifyTrack] array
    for track in tracks {
        print("URI:    (track.uri), "         +
              "Name:   (track.name), "        +
              "Artist: (track.artist.name), " +
              "Album:  (track.album.name)")
    }
}

get() and library() functions are also available for retrieving a specific item or fetching your library’s tracks, albums or playlists.

User library interaction

Save, delete and check saved status for tracks in "Your Music" playlist

// Save the track
spotifyManager.save(trackId: "track_id") { saved in
    print("Saved: (saved)")
}

// Check if the track is saved
spotifyManager.isSaved(trackId: "track_id") { isSaved in
    print("Is saved: (isSaved)")
}

// Delete the track
spotifyManager.delete(trackId: "track_id") { deleted in
    print("Deleted: (deleted)")
}

Supported Spotify items

The items are automatically decoded from JSON, by conforming to Swift 4 "Decodable" protocol.

Generic item

The protocol which is inherited by all items, including common properties

public protocol SpotifyItem: Decodable {

    var id:   String { get }
    var uri:  String { get }
    var name: String { get }
}

public protocol SpotifySearchItem: SpotifyItem {
    // Items conforming to this protocol can be searched
}

public protocol SpotifyLibraryItem: SpotifyItem {
    // Items conforming to this protocol can be contained in user's library
}

User

public struct SpotifyUser: SpotifySearchItem {

    public var email:  String?

    // URI of the user profile picture
    public var artUri: String
}

Track

public struct SpotifyTrack: SpotifySearchItem, SpotifyLibraryItem {

    public var album:  SpotifyAlbum?
    public var artist: SpotifyArtist
}

Album

public struct SpotifyAlbum: SpotifySearchItem, SpotifyLibraryItem, SpotifyTrackCollection {

    // The tracks contained in the album
    public var collectionTracks: [SpotifyTrack]?

    public var artist: SpotifyArtist

    // The album's cover image
    public var artUri: String
}

Playlist

public struct SpotifyPlaylist: SpotifySearchItem, SpotifyLibraryItem, SpotifyTrackCollection {

    // The tracks contained in the playlist
    public var collectionTracks: [SpotifyTrack]?
}

Artist

public struct SpotifyArtist: SpotifySearchItem {
    // Artist has no additional properties
}

Examples

  • iOS and macOS sample projects are available in this repository
  • Muse

Latest podspec

{
    "name": "SpotifyKit",
    "version": "0.0.6",
    "summary": "A iOS and Mac client for Spotify Web API",
    "description": "SpotifyKit allows access to Spotify Web API calls in your iOS or Mac app.",
    "homepage": "https://github.com/xzzz9097/SpotifyKit",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "John Doe": "[email protected]"
    },
    "source": {
        "git": "https://github.com/xzzz9097/SpotifyKit.git",
        "tag": "0.0.6"
    },
    "source_files": "Sources/*.swift",
    "platforms": {
        "ios": "11.0",
        "osx": "10.12"
    }
}

Pin It on Pinterest

Share This