GitHub - HempsSA/Syncra: a tool to upload m3u playlists, backup playlists and delete playlists.

Syncra - Plex Playlist Manager

🎵 Advanced playlist management for Plex Media Server with streaming service integration

📸 Screenshots

Home

Home

Advanced Playlist Editor

Playlist Editor

Sync Manager

Sync Manager

Tools & Utilities

Tools & Utilities

✨ Features

  • 🎛️ Advanced Playlist Editor with search, filtering, and drag-and-drop reordering
  • 🔄 Auto-Sync from Spotify, Deezer, Tidal, and ListenBrainz playlists
  • 🔀 Playlist Merger with intelligent duplicate detection
  • 🛠️ Tools & Utilities including backup, restore, and library analysis
  • 🧬 File Metadata Fixer (feature-flagged) using MusicBrainz + Cover Art Archive proposals
  • 🍎 Apple Music XML Import with playlist preview and optional rating sync
  • Lightning-fast performance with smart caching system
  • 🎯 Precise track positioning - move any track to any position instantly
  • 🔍 Duplicate track finder across your entire library
  • 📊 Library statistics and playlist analytics

🚀 Download

Get the latest version for your platform from the Releases page:

  • 🪟 Windows: Syncra-Windows.exe
  • 🍎 macOS: Syncra-macOS
  • 🐧 Linux: Syncra-Linux

📋 Installation

  1. Download the appropriate version for your operating system
  2. Run the executable (no installation required!)
  3. Connect to your Plex server using your credentials
  4. Start managing your playlists like a pro!

🎯 Quick Start

  1. Connect to Plex: Enter your server details in the Connection tab
  2. Fetch Playlists: Click "Fetch Playlists" to load your collection
  3. Edit Playlists: Double-click any playlist to open the advanced editor
  4. Sync from Streaming: Paste Spotify/Deezer/Tidal/ListenBrainz URLs to auto-sync
  5. Explore Tools: Check out the Tools & Utilities for advanced features

🔄 Auto-Sync Setup

  1. Go to Sync Manager tab
  2. Select a Plex playlist
  3. Enter a Spotify/Deezer/Tidal URL
  4. Set sync interval (hourly, daily, etc.)
  5. Enable auto-sync and let Syncra keep your playlists updated!

🧬 Metadata Fixer

  • File Metadata Fixer uses MusicBrainz + Cover Art Archive suggestions and writes selected changes to local audio file tags.
  • It never modifies local files unless you explicitly apply reviewed proposals.
  • It is feature-flagged by default. Enable it in app_config.json:
    • features.metadata_fixer = true

📋 System Requirements

  • Windows: Windows 10/11 (64-bit)
  • macOS: macOS 10.14+ (Mojave or later)
  • Linux: Ubuntu 18.04+ or equivalent
  • All platforms: Plex Media Server with music library

📱 Supported Streaming Services

  • 🎵 Spotify (playlists, albums, tracks)
  • 🎶 Deezer (playlists, albums, tracks)
  • 🎧 Tidal (playlists, albums, tracks)
  • 🧠 ListenBrainz (import/export playlists)
  • 🍎 Apple Music XML exports (library/playlists snapshot import)
  • 📁 M3U/M3U8 files (local and remote)

🏗️ Development

Built with:

  • Python 3.11 with PyQt6 for the interface
  • PlexAPI for Plex server communication
  • Spotipy for Spotify integration
  • Advanced fuzzy matching for cross-platform track identification

Telegram Group

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⭐ Show Your Support

If Syncra makes managing your Plex playlists easier, please:

  • Star this repository
  • 🔄 Share with fellow Plex users
  • 💝 Contribute improvements or suggestions

Made with ❤️ for the Plex community