Spotify Apps API Tutorial

This is a Spotify App that explains shows useful code snippets that can help you make a Spotify Apps. It uses version 0.x of the Spotify Apps API. If you want to have a look at the tutorial that uses a preliminary version 1.x of the Spotify Apps API, check the 1.0 branch.

Installation

1. Sign up for a developer account on Spotify
2. Open Terminal, mkdir ~/Spotify
3. cd ~/Spotify
4. git clone git://github.com/spotify/apps-tutorial.git
5. Download the latest version of Spotify
6. Open Spotify and type "spotify:app:api-tutorial" in the search bar (restart Spotify completely in case it doesn't find the App at first)

More information

• API Reference
• Integration Guidelines
• Spotify-tagged questions on StackOverflow
• @SpotifyPlatform on Twitter

Your feedback is welcome! Please email mager@spotify.com.

Topics covered

Getting started

• Creating your manifest file
• Handling arguments and creating navigational tabs
• Dragging and dropping content into an app
• Show "Share" popup

UI

• Using standard components for buttons
• Showing a list of tracks

Playing music

• Play a single song
• Play a list of songs
• Get the currently playing track
• Create a play/pause button with an HTML element
• Skip to the next or previous track
• Star and unstar a track
• Get a user's top tracks

Searching

• Returning all tracks with a given search query
• Search albums for an artist

Playlists

• Add a song to a playlist
• Get songs from a playlist URL
• Subscribe to a playlist
• Showing a playlist mosaic image

Interacting with Facebook

• Authenticate a user with Facebook
• Get a user's listening history from Facebook

Experimental & Unsupported

• Talking to Twitter
• Create an EchoNest radio station
• Display a Polymaps object