sssync

A scriptable playlist sync tool for Qobuz, Spotify, and Jellyfin.

sssync sync spotify qobuz --all
sssync sync qobuz jellyfin <playlist-id> "My Playlist"
sssync sync qobuz jellyfin --dry-run

Features

• Sync playlists from Spotify or Qobuz into Qobuz or Jellyfin (Spotify is read-only, so it's a source only)
• ISRC-first matching — exact track identification via ISRC, with fuzzy title/artist/duration fallback
• Incremental, append-only syncs — existing playlist contents are never touched; re-running adds only what's missing
• Favorites sync between services that support them
• Dry-run mode — preview matches without writing anything
• Simple TOML config, streamrip-style CLI

Installation

Requires Python 3.11+.

Install as an isolated tool (recommended):

uv tool install sssync
# or
pipx install sssync

Try it without installing anything:

uvx sssync playlists qobuz

Or with pip in a virtualenv:

pip install sssync

Configuration

sssync config

Creates and opens ~/.config/sssync/config.toml:

[qobuz]
# Session token: log into https://play.qobuz.com → DevTools →
# Application → Cookies → qobuz.com → user_auth_token
token = ""

[spotify]
client_id = ""
client_secret = ""
redirect_uri = "http://127.0.0.1:8888/callback"

[jellyfin]
url = "http://your-server/jellyfin"
api_key = ""
# or: api_key_path = "~/jellyfin_api_key.txt"

Only the sections you use need to be filled in — sources are loaded lazily per command.

Usage

List playlists on a source:

sssync playlists qobuz
sssync playlists jellyfin

Sync a playlist (accepts a name, an id, or a URL):

sssync sync spotify qobuz "My Playlist"
sssync sync qobuz jellyfin <playlist-id>
sssync sync qobuz jellyfin <playlist-id> "My Playlist"

Sync everything:

sssync sync spotify qobuz --all

Preview without writing:

sssync sync qobuz jellyfin <playlist-id> --dry-run

Sync favorites:

sssync favorites spotify qobuz

How matching works

1. ISRC — if both services expose the track's ISRC, it's an exact match.
2. Fuzzy — normalized title/artist similarity (rapidfuzz) with a duration tolerance. Thresholds are tunable in the [sync] section of the config:

[sync]
title_threshold = 80
artist_threshold = 75
duration_tolerance_ms = 5000
min_score = 75

Unmatched tracks are reported, never silently dropped. API errors during matching are captured per track and included in the sync report.

Safety

Writes are append-only by design. sssync never removes or reorders tracks in an existing destination playlist, and dry-run makes no changes at all. Destination playlists keep their cover art and metadata.

Development

git clone https://github.com/uprcse/sssync.git
cd sssync
pip install -e ".[dev]"
pytest tests/
ruff check sssync tests

CI runs pytest + ruff on Python 3.11–3.13. Releases are published to PyPI automatically on tag push via Trusted Publishing.

License

MIT — see LICENSE.