Spotify expands from soundtrack to sweat session: Peloton partnership puts 1,400 classes inside the app

Introduction

In this tutorial, you'll learn how to create a simple fitness tracking application using Spotify's API and Python. This project will help you understand how to integrate music streaming services with fitness applications, similar to how Spotify partnered with Peloton to bring 1,400 classes into their app. We'll build a basic system that can display fitness class information and play music tracks from Spotify.

This beginner-friendly tutorial will teach you fundamental concepts of API integration, data handling, and basic Python programming. You'll gain experience working with real-world applications that combine entertainment and fitness technologies.

Prerequisites

• A basic understanding of Python programming concepts
• Python 3.6 or higher installed on your computer
• Spotify account (free or premium)
• Spotify Developer account (free to create)
• Basic knowledge of command line operations

Step-by-step Instructions

1. Set Up Your Development Environment

First, we need to create a project directory and install the required Python packages. Open your terminal or command prompt and run these commands:

mkdir spotify_fitness_app
 cd spotify_fitness_app
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate
 pip install spotipy

Why this step? We're creating a separate environment to keep our project dependencies isolated from other Python projects on your computer. The spotipy library is Spotify's official Python client that makes it easy to access their API.

2. Create a Spotify Developer Account

Visit Spotify Developer Dashboard and sign in with your Spotify account. Click "Create an App" and give it a name like "Fitness Tracker" and description "My fitness tracking app using Spotify".

After creating your app, note down the Client ID and Client Secret - you'll need these to authenticate with Spotify's API.

Why this step? Spotify requires authentication to access their API. The Developer Dashboard gives you the credentials needed to securely connect your application to Spotify's services.

3. Create Your Main Python File

Create a new file called fitness_app.py in your project directory:

import spotipy
from spotipy.oauth2 import SpotifyClientCredentials
import json

# Your Spotify credentials
CLIENT_ID = 'your_client_id_here'
CLIENT_SECRET = 'your_client_secret_here'

# Authenticate with Spotify
auth_manager = SpotifyClientCredentials(client_id=CLIENT_ID, client_secret=CLIENT_SECRET)
sp = spotipy.Spotify(auth_manager=auth_manager)

print("Spotify Fitness App Initialized!")

Why this step? This sets up the basic structure of our application and authenticates with Spotify's API using the credentials you obtained in step 2.

4. Add Function to Search for Fitness Playlists

Now add this function to your fitness_app.py file:

def search_fitness_playlist(query):
    """Search for fitness-related playlists"""
    results = sp.search(q=query, type='playlist', limit=5)
    playlists = []
    
    for item in results['playlists']['items']:
        playlist_info = {
            'name': item['name'],
            'id': item['id'],
            'description': item['description'],
            'tracks': item['tracks']['total']
        }
        playlists.append(playlist_info)
    
    return playlists

# Test the function
if __name__ == "__main__":
    playlists = search_fitness_playlist('fitness workout')
    for playlist in playlists:
        print(f"Playlist: {playlist['name']}")
        print(f"Tracks: {playlist['tracks']}")
        print(f"Description: {playlist['description']}")
        print("---")

Why this step? This function demonstrates how to search for playlists related to fitness using Spotify's search API. It's similar to how Spotify might categorize and display Peloton's 1,400 classes in their fitness section.

5. Create a Function to Get Playlist Tracks

Add this function to display the tracks in a playlist:

def get_playlist_tracks(playlist_id):
    """Get all tracks from a specific playlist"""
    results = sp.playlist_tracks(playlist_id)
    tracks = []
    
    for item in results['items']:
        track = item['track']
        track_info = {
            'name': track['name'],
            'artist': track['artists'][0]['name'],
            'album': track['album']['name'],
            'duration': track['duration_ms']
        }
        tracks.append(track_info)
    
    return tracks

Why this step? This function shows how to retrieve detailed information about tracks in a playlist, which is essential for creating a complete fitness application that can suggest music for different types of workouts.

6. Test Your Application

Update your main execution block to test all functions:

if __name__ == "__main__":
    print("Searching for fitness playlists...")
    playlists = search_fitness_playlist('fitness workout')
    
    if playlists:
        print("\nFound playlists:")
        for i, playlist in enumerate(playlists):
            print(f"{i+1}. {playlist['name']} - {playlist['tracks']} tracks")
            
        # Get tracks from first playlist
        first_playlist_id = playlists[0]['id']
        print(f"\nTracks in '{playlists[0]['name']}':")
        tracks = get_playlist_tracks(first_playlist_id)
        
        for i, track in enumerate(tracks[:5]):  # Show first 5 tracks
            print(f"{i+1}. {track['name']} by {track['artist']}")
    else:
        print("No playlists found.")

Why this step? This completes our basic fitness application by testing all the functionality we've built, showing how the application can search for playlists and display track information - similar to how Peloton classes would be organized within Spotify.

7. Run Your Application

Save your file and run it in the terminal:

python fitness_app.py

Why this step? Running the application will show you how it interacts with Spotify's API and demonstrates the basic functionality of searching for fitness playlists and retrieving track information.

Summary

In this tutorial, you've learned how to create a basic fitness tracking application that integrates with Spotify's API. You've gained experience with:

• Setting up a Python development environment
• Creating a Spotify Developer account and obtaining API credentials
• Authenticating with Spotify's API using the spotipy library
• Searching for playlists and retrieving track information

This foundation demonstrates how Spotify's partnership with Peloton works at a technical level - by integrating fitness content with music streaming capabilities. While this is a simplified example, it shows the core concepts behind building applications that combine entertainment and fitness technologies, similar to how Spotify now offers 1,400 Peloton classes within their app.

From here, you could expand this application by adding features like creating workout schedules, tracking progress, or even integrating with fitness devices - just like Spotify has done with their fitness category.