Getting Started¶

This guide will help you set up Spotify integration with plistsync from start to finish.

Prerequisites¶

Installation¶

First, install the Spotify optional dependencies:

pip

pip install 'plistsync[spotify]'

uv add plistsync --extra spotify

Spotify Account¶

You’ll need an active Spotify account. If you don’t have one, sign up at spotify.com.

API Credentials¶

To authenticate with Spotify’s API, you need to obtain API credentials:

Visit the Spotify Developer Portal
Log in with your Spotify account
Create a new application
Generate your client_id (and optionally client_secret)

Configuration¶

Enable Tidal in your plistsync configuration file:

# ./config/config.yaml
services:
  spotify:
    enabled: true
    client_id: your_spotify_client_id_here
    client_secret: your_spotify_client_secret_here # Optional but recommended

Authentication¶

Once configured, authenticate plistsync with your Tidal account:

plistsync spotify auth

This will start an interactive authentication flow:

You’ll be prompted to open a browser to Tidal’s authorization page
Log in with your Tidal credentials
Grant plistsync the requested permissions
This will save an authentication token in the config folder

Authentication Preview¶

Verification¶

Test that everything is working by getting your user data:

from plistsync.services.spotify.api import SpotifyApi
print(SpotifyApi().user.me())

This should return your user’s ID and email.