iOS App Remote SDK Beta

Important: The iOS App Remote SDK is currently in Beta. The content and functionality is likely to change significantly without warning in future versions.

By using Spotify developer tools, you accept our Developer Terms of Service.

About the SDK

The Spotify App Remote SDK allows your application to interact with the Spotify app running in the background on a user’s device. Capabilities include getting metadata for the currently playing track and context as well as issuing playback commands.

The Spotify App Remote is a set of lightweight objects that connect with the Spotify app and let you control it while all the heavy lifting of playback is offloaded to the Spotify app itself. The Spotify app takes care of playback, networking, offline caching and OS music integration, leaving you to focus on your user experience. Also, with the App Remote API, moving from your app to the Spotify app and vice versa is a streamlined experience where playback and metadata always stay in sync.

Key Features

  • Playback is always in sync with Spotify app
  • Playback, networking, and caching is all accounted for by the Spotify app
  • Works offline and online and does not require Web API calls to get metadata for player state
  • Automatically handles track relinking for different regions

Requirements

The Spotify App Remote SDK requires a deployment target of iOS 8 or higher and does not currently support bitcode. The following architectures are supported: armv7, armv7s and arm64 for devices, i386 and x86_64 for the iOS Simulator. Simulator architectures are included so you can continue to run your app on the simulator but you will not be able to install Spotify in the simulator. You must use a physical device to test App Remote, for more information about building to devices see Apple’s documentation.

Tutorial and Examples

We provide a Quick Start guide to help you set up your build environment and get started with the Spotify App Remote SDK (iOS). It leads you through the creation of a simple app that connects to the Spotify app, plays a playlist and subscribes to PlayerState. Within the download package you will also find a demo app with full source code to help get you started.

API Documentation

The download packages includes comprehensive documentation of all API classes in the /docs folder. You can also read the documentation online.

Issues

Please report problems with this SDK through the public issue tracker on GitHub.

Authentication and Authorization

To use Spotify App Remote, your application will need to get a user’s permission to control playback remotely first. This can be done in two ways:

  1. By using Single Sign-On library. To do that you’ll need to include the Spotify iOS SDK in your project and request app-remote-control scope. This approach is useful if you need to request more scopes or an access token for other purposes, for example to communicate with Spotify Web API. Our iOS SDK Tutorial provides instructions and examples.
  2. Use built-in authorization mechanism in the App Remote SDK. To do that you’ll need to request authorization view when connecting to Spotify. The library will automatically request the app-remote-control scope and show the auth view if user hasn’t agreed to it yet. It’s currently not possible to request additional scopes using this method. The Beginner’s Tutorial contains an example on how to use this method.

Terms of Service

Note that by using Spotify developer tools, you accept our Developer Terms of Use.