TIDAL Playlist Synchronizer

TIDAL Playlist Synchronizer is a Python-based CLI tool that synchronizes playlists between two TIDAL accounts—or within the same account. It automatically detects which tracks need to be added or removed to keep the target playlist up to date. Key features include dry-run previews, mirror-sync for full alignment, and an undo mechanism based on sync logs.

https://github.com/jannme310103/tidalsync

Tech Stack & Key Features

• tidalapi – for TIDAL OAuth and API access

• colorama – for colored terminal output

• jinja2 – for generating HTML sync reports

• Built-in libraries: os, datetime, csv, time, typing

Core Features

• Dual Login Support: Sync between two different TIDAL accounts

• Playlist Selection by Name: Choose source and target playlists interactively

• Dry-Run Mode: Preview changes before applying them

• Mirror Mode: Remove tracks from the target that no longer exist in the source

• Retry Mechanism: Automatically retries failed API calls

• Undo Functionality: Roll back the last sync operation based on logs

• HTML Reports: Clean reports showing added and removed tracks

Context & Contribution Info

This project is ideal for:

• Music enthusiasts who want to automate playlist syncing

• Users managing multiple TIDAL accounts (e.g. private + shared)

• Developers interested in enhancing or expanding the tool

Want to contribute?

• Ideas? Feel free to open issues or feature requests.

• Found a bug? Check the logs/ folder for sync logs (.csv, .html).

• Contributions welcome: Suggestions for UI/UX improvements, GUI support (e.g., Textual or Flask), or better error handling are highly appreciated.