Getting Started

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

Prerequisites

Installation

First, install the Tidal optional dependencies:

pip

pip install 'plistsync[tidal]'

uv

uv add plistsync --extra tidal

Tidal Account

You’ll need an active Tidal account. If you don’t have one, sign up at tidal.com. For tidal, free accounts are sufficient to use the API and plistsync.

API Credentials

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

1. Visit the Tidal Developer Portal

2. Log in with your Tidal account

3. Create a new application

4. Generate your client_id (and optionally client_secret)

Configuration

Enable Tidal in your plistsync configuration file:

# ./config/config.yaml
services:
  tidal:
    enabled: true
    client_id: your_tidal_client_id_here
    client_secret: your_tidal_client_secret_here # Optional but recommended

Authentication

Once configured, authenticate plistsync with your Tidal account:

plistsync auth tidal

This will start an interactive authentication flow:

1. You’ll be prompted to open a browser to Tidal’s authorization page

2. Log in with your Tidal credentials

3. Grant plistsync the requested permissions

4. 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.tidal.api import TidalApi
print(TidalApi().user.me())

This should return your user’s ID and email.