Syncra - Plex Playlist Manager

August 9, 2026 · View on GitHub

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

✨ Features

🖼️ Cover-art playlist wall — browse your playlists as posters with track counts and playing time, with a filter box and a compact list view when you want one. Rename any playlist with F2 or the right-click menu
🔄 Sync Manager with cover art, per-service badges, and an at-a-glance summary of what is configured and when it last ran
🎛️ Advanced Playlist Editor with search, filtering, and drag-and-drop reordering
🔄 Auto-Sync from Spotify, Deezer, Tidal, and ListenBrainz playlists
🎧 Sonic Discovery — build playlists from Plex's own audio analysis: "More Like This" from any track, or a Sonic Adventure that plots the gradual path between two tracks. Entirely local, no external service
🎯 Missing Tracks workspace - a running, deduplicated list of everything your imports couldn't find, with re-check and CSV export
🧠 Match Memory - Syncra learns from your manual match corrections and stops asking twice
👁️ Sync Preview & Revert - see exactly what a sync will change before it runs, and undo it afterwards
🔀 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

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

🎯 Quick Start

Connect to Plex: Enter your server details in the Connection tab
Fetch Playlists: Click "Fetch Playlists" to load your collection as a wall of cover art
Edit Playlists: Double-click any cover to open the advanced editor; tick the box on a cover to include it in delete, export and sync actions
Sync from Streaming: Paste Spotify/Deezer/Tidal/ListenBrainz URLs to auto-sync
Explore Tools: Check out the Tools & Utilities for advanced features

⌨️ Headless Sync (CLI)

Run syncs without opening the app — for Task Scheduler, cron, systemd, or a container alongside Plex. Configure your playlists once in the Sync Manager, then:

syncra --list                    # show configs and last run
syncra --sync-all                # sync everything
syncra --sync "Baila Reggaeton"  # sync one playlist (repeatable)
syncra --sync-all --dry-run      # preview changes, write nothing
syncra --sync-all --json         # machine-readable output
syncra --sync-all --log-file sync.log   # append output to a file

Running from source, use python main.py --sync-all.

Headless runs are recorded in the same history the app reads, so they show up in Sync History and can be reverted from the UI. Exit codes: 0 success, 1 failure, 2 partial (some playlists synced, some failed).

Windows Task Scheduler example — sync every night at 3am:

Program:   C:\Path\To\Syncra-Windows.exe
Arguments: --sync-all --log-file "%LOCALAPPDATA%\Syncra\sync.log"

Use --log-file for scheduled runs. Syncra ships as a windowed executable, so when it is launched without a terminal there is nowhere for it to print. The sync still runs correctly, but you would have no record of it. Run from a terminal and output appears normally — the CLI attaches to the calling console.

🔄 Auto-Sync Setup

Go to Sync Manager tab
Select a Plex playlist
Enter a Spotify/Deezer/Tidal URL
Set sync interval (hourly, daily, etc.)
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