plistsync

Toolbox for transferring, converting and matching music collections and playlists across services.

Overview

plistsync is a Python toolbox designed to solve the common problem of fragmented music libraries across different platforms. Whether you're a DJ moving playlists between Traktor and streaming services, a music enthusiast syncing collections between Plex and Spotify, or simply organizing your music across multiple platforms, plistsync provides a unified interface to transfer, convert, and match your music data.

The core of plistsync is its abstraction layer that normalizes tracks, collections, and playlists from various services into a common format, enabling seamless synchronization while handling the complexities of different APIs, authentication methods, and metadata formats.

Features

• Unified Abstraction Layer: Normalizes tracks, collections, and playlists from various services into a common format, enabling seamless synchronization across platforms
• Extensible Service Architecture: The abstraction layer is designed to support arbitrary music services with consistent APIs
  • Currently supports Spotify, Tidal, Plex, Traktor and local files
• Collection Management: Sync entire music libraries or specific playlists between services
• Developer-Friendly: Built with type hints, comprehensive error handling, and pytest for testing
• Flexible Configuration: Manage service credentials and preferences through config files

Getting started

For detailed usage guides, API reference, and examples, see the full documentation.

Is this for you?

plistsync is intended for users who are comfortable with Python and scripting. It is not a point-and-click app, it’s a developer-oriented toolbox for automating music library and playlist workflows.

License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

In short, this license allows broad use for personal, educational, research, and non-profit purposes, but forbids commercial use. We chose it to defend our work in an industry that often exploits artists, where commercial interests seem more important than an inclusive community.

See the LICENSE file for the full terms.

Support the project

If you enjoy this project, there are a few ways you can support us:

• To add Apple Music support, we are currently looking for someone to support us with an Apple Developer Account. (Apple only allows access to its MusicKit API via a paid Developer Account. If you are a Dev and willing to help us out, please get in touch 🫶)
• Contribute code: Pull requests, bug reports, and feature suggestions are always welcome!
• Spread the word: Share the project with friends or on social media.
• Donate: Every contribution helps fuel more coffee-powered coding sessions!
  • Donate ETH: 0x81927e76f2f0fAA9e7fD92176a473955DB20Ce55
  • Donate BTC: bc1qw5e0deust6uq94e5s58au82wrakcjmlemw3cy4

Keep your music in sync, everywhere.