SoulSync

Automated music collection management, honestly reviewed. What you actually get when you run Spotify-quality discovery on your own server.

TL;DR

• What it is: Open-source (MIT) music discovery and download automation platform — monitors artists, generates playlists, and downloads new releases to your self-hosted library via six different sources [1].
• Who it’s for: Technical music collectors running Plex, Jellyfin, or Navidrome who are tired of streaming algorithms and want a library they fully own [1].
• Cost: SoulSync itself is free. Running it requires a VPS ($5–10/mo) and optionally subscriptions to Deezer, Tidal, or Qobuz for API-based downloads — though it also pulls from Soulseek and YouTube without paid accounts [1].
• Key strength: The discovery pipeline is unusually sophisticated for a 1,260-star project — 12+ playlist types, 9 metadata enrichment sources, AcoustID fingerprinting for P2P downloads, and Beatport integration for electronic music [1].
• Key weakness: The core download functionality sits in a legal gray area. Deezer integration uses ARL token authentication and Blowfish decryption — methods that violate Deezer’s ToS. Soulseek carries ban risk that the README warns about explicitly [1]. Independent third-party reviews of this tool are essentially nonexistent at this star count.

---

What is SoulSync

SoulSync is a Python-based automation platform that connects streaming service discovery to your self-hosted media server. The concept is straightforward: you tell it which artists you follow, and it handles everything downstream — detecting new releases, downloading the audio, verifying it with AcoustID fingerprinting, enriching the metadata from nine different sources, organizing the files, syncing your media server, and scrobbling your plays [1].

The project’s own pitch is “Spotify-quality music discovery for self-hosted libraries” [1]. That’s a reasonable description of the ambition. What it’s actually doing is reassembling the pieces of a streaming service — the recommendation engine, the download delivery, the metadata layer, the media server sync — from open-source and semi-official components rather than from a single commercial platform.

The project lives entirely on GitHub, has 1,260 stars and 39 forks as of this review, and is maintained by a single developer (Nezreka) with community support via Discord [1]. There’s no company, no SaaS version, no commercial licensing tier. It’s MIT-licensed source code and a Docker Compose file.

That context matters when evaluating it. SoulSync is not Lidarr with a prettier interface. It’s a more opinionated, more automated, and more legally complicated tool than anything in the arr-stack family. Understanding what it’s doing under the hood — and what that means for reliability and legality — is the honest starting point for deciding whether to run it.

---

Why people choose it

No significant independent reviews of SoulSync exist in the public record. The project has 1,260 GitHub stars and a Discord community, but there are no published evaluations from tech outlets, no detailed forum threads analyzing its trade-offs versus alternatives, and no third-party pricing comparisons [1]. The following analysis is based entirely on the project’s own documentation.

That’s worth naming explicitly before proceeding. When a tool has 21,000 GitHub stars (like Activepieces), a critical mass of independent reviews forms naturally. At 1,260 stars, you’re in “enthusiast project with a core following” territory. The people running SoulSync found it through the self-hosted music management community and chose it over alternatives like Lidarr and Beets for specific reasons — but those reasons aren’t well-documented outside the Discord.

From the README, the value proposition clusters around three things:

Multi-source download automation with quality fallback. Most music managers pick one download mechanism. SoulSync supports six — Soulseek, Deezer, Tidal, Qobuz, HiFi, and YouTube — and lets you enable any combination with drag-to-reorder priority. If your top-priority source doesn’t have a track, it falls through to the next one automatically [1]. For collectors who want lossless audio but can’t always find it in one place, this matters.

Discovery that works without a streaming subscription. The Cache-Powered Discovery features — Undiscovered Albums, New In Your Genres, From Your Labels, Deep Cuts — generate playlist suggestions using data already in your library database, without making a single external API call [1]. You can get algorithmic-style recommendations from your own listening history without Spotify touching your data.

Metadata quality. Nine enrichment workers (Spotify, MusicBrainz, iTunes, Deezer, AudioDB, Last.fm, Genius, Tidal, Qobuz) run in parallel, and the Picard-style MusicBrainz release preflight ensures every track on an album gets the same release ID [1]. For anyone who has spent hours manually fixing tags in their library, this is the meaningful differentiator.

---

Features

Discovery engine

• Release Radar — new tracks from your artist watchlist, weighted by listening history [1]
• Discovery Weekly — 50 tracks from artists similar to your favorites, with “serendipity weighting” to prevent repetition [1]
• Seasonal playlists — Halloween, Christmas, Valentine’s, Summer, Spring, Autumn, hemisphere-aware for Southern Hemisphere users [1]
• 12+ personalized playlist types — Recently Added, Top Tracks, Forgotten Favorites, Decade Playlists (1960s-2020s), 15+ Genre Playlists, Because You Listen To, Daily Mixes, Hidden Gems, Popular Picks, Discovery Shuffle, Familiar Favorites, Custom Playlist Builder [1]
• Cache-powered discovery — Undiscovered Albums, New In Your Genres, From Your Labels, Deep Cuts, Genre Explorer with artist-count pills — all zero API calls [1]
• ListenBrainz integration — import community recommendation playlists [1]
• Beatport — full electronic music integration with 39+ genre browser [1]

Download sources

• Deezer — ARL token auth, FLAC lossless / MP3 320 / MP3 128, automatic quality fallback, Blowfish decryption [1]
• Tidal — Device-flow OAuth, AAC 96kbps to FLAC 24-bit/96kHz Hi-Res [1]
• Qobuz — email/password auth, up to Hi-Res Max (FLAC 24-bit/192kHz) [1]
• HiFi — free lossless via public API instances, no account required [1]
• Soulseek — FLAC priority, peer quality scoring, source reuse for album consistency [1]
• YouTube — audio extraction with cookie-based bot detection bypass [1]
• Hybrid mode — enable any combination, drag to reorder priority, automatic fallback chain [1]

Post-download processing

• Lossy copy creation (MP3, Opus, AAC) with configurable bitrate [1]
• Hi-Res FLAC downsampling to 16-bit/44.1kHz CD quality [1]
• “Blasphemy Mode” — delete original FLAC after conversion [1]
• Synchronized lyrics (LRC) via LRClib [1]
• AcoustID fingerprinting verification for P2P sources [1]

Media server and scrobbling

Syncs with Plex, Jellyfin, or Navidrome after downloads. Automatic scrobbling to Last.fm and ListenBrainz from whichever media server you’re running [1].

Stats dashboard

Full listening stats page with Chart.js visualizations: total plays, listening time, unique artists/albums/tracks, timeline bar chart, genre breakdown donut, top artists visual bubbles, library health metrics (format breakdown, enrichment coverage, database storage) [1].

---

Pricing: SaaS vs self-hosted math

SoulSync has no pricing. It’s MIT-licensed software you run yourself [1].

The actual costs depend on which download sources you use:

If you use only free sources (Soulseek, HiFi, YouTube):

• SoulSync: $0
• VPS to run it: $5–10/mo (2GB RAM minimum)
• Total: $5–10/mo

If you add Deezer Individual: approximately $10.99/mo (but using the ARL token method violates Deezer’s ToS, so your account can be terminated — data not available on enforcement frequency)

If you add Tidal: $10.99/mo (HiFi tier) to $19.99/mo (Max tier for 24-bit audio) [data from Tidal’s public pricing, not provided in source material]

If you add Qobuz: approximately $12.99/mo for Studio tier (Hi-Res streaming and downloads)

Compare to what you’re replacing:

Spotify: $10.99/mo. Discovery: excellent. Download to local library: not possible. Audio quality: maximum 320kbps Ogg Vorbis. Library ownership: none — they can remove tracks.

Apple Music: $10.99/mo. Same ownership problem. No download-to-library automation.

The self-hosted math is compelling if you value library ownership and lossless audio. A Qobuz subscription + $8/mo VPS gives you high-res downloads, local library ownership, and Spotify-grade discovery — for less than Spotify alone, and you own the files permanently.

The caveat: the Deezer download method uses unofficial authentication. This is not a gray area — it’s clearly outside Deezer’s terms of service, and your account could be terminated if they detect it.

---

Deployment reality check

SoulSync is a Python application with a Docker Compose deployment path. The repository includes a Dockerfile, docker-compose.yml, and entrypoint.sh [1].

What you need:

• A Linux VPS with 2GB+ RAM
• Docker and docker-compose
• A domain and reverse proxy if you want HTTPS access
• SQLite (bundled) for the database
• slskd running separately if you want Soulseek downloads — SoulSync talks to slskd’s API, it doesn’t replace it [1]
• Plex, Jellyfin, or Navidrome already running and accessible

The slskd dependency is the main setup complication. SoulSync doesn’t ship a Soulseek client — it talks to slskd via API. So if you want the P2P download source (which is the most flexible and doesn’t require a paid music service subscription), you’re maintaining two separate services. The README warns explicitly: “Configure file sharing in slskd to avoid Soulseek bans. Set up shared folders at http://localhost:5030/shares” [1]. Soulseek accounts that download without sharing get banned.

For each download source, you need credentials:

• Deezer: ARL token (extracted from browser cookies — not official API)
• Tidal: Device-flow OAuth (semi-official)
• Qobuz: Email and password
• YouTube: Cookie export for bot-detection bypass

This isn’t a tool you point at a server and forget. Each external service requires manual credential setup, and unofficial methods (particularly Deezer) will break when the services change their authentication.

Realistic time estimate: For a technically competent user who already has Jellyfin running: 2–4 hours to a working SoulSync instance. For someone setting up a media server from scratch simultaneously: plan for a weekend.

---

Pros and cons

Pros

• MIT license, genuinely free. No commercial tier, no gated features, no usage limits [1].
• Broadest download source support in its category. Six download sources with Hybrid mode fallback — Soulseek, Deezer, Tidal, Qobuz, HiFi, YouTube — in a single tool [1].
• Discovery engine is surprisingly sophisticated. 12+ playlist types including Cache-Powered Discovery that requires zero external API calls once your library has listening history [1].
• Metadata quality is a real differentiator. Nine enrichment workers + Picard-style MusicBrainz preflight. For collectors obsessed with tag consistency, this is the reason to choose SoulSync over Lidarr [1].
• Beatport integration. Electronic music is poorly served by most self-hosted tools. 39+ genre browser is unique in this category [1].
• Listening stats dashboard. Built-in Chart.js visualizations with library health metrics — not something you get from arr-stack tools [1].
• Active development. 1,678 commits and 13 releases suggest ongoing maintenance [1].

Cons

• Core functionality is legally questionable. Deezer downloads use ARL token extraction and Blowfish decryption — explicitly against Deezer’s ToS. Soulseek is a P2P network for music sharing, which creates its own legal exposure depending on jurisdiction. This isn’t a hypothetical risk — it’s the tool’s primary use case [1].
• Slskd dependency adds operational complexity. Soulseek support requires running and maintaining a separate service. The ban warning in the README is a real operational concern [1].
• No independent reviews. At 1,260 stars, there’s no critical mass of third-party evaluation. You’re relying entirely on the developer’s own documentation and word of mouth from the Discord community.
• Single maintainer. No company, no team, no commercial backing. The project’s continuity depends on one person’s continued interest.
• Unofficial API methods will break. Deezer ARL authentication and YouTube cookie-based extraction are the kinds of integrations that fail silently when the upstream service makes changes. There’s no SLA.
• Requires pre-existing media server. SoulSync is a layer on top of Plex/Jellyfin/Navidrome, not a standalone player. If you don’t already have a media server running, the setup complexity doubles [1].
• No web UI for configuration management. Configuration lives in files, not in the interface — data not confirmed from README, but implied by the Python/SQLite architecture [1].

---

Who should use this / who shouldn’t

Use SoulSync if:

• You’re already running Jellyfin, Plex, or Navidrome and want automated new-release downloads without manual intervention.
• You have a Qobuz or Tidal subscription and want to automate downloads to your local library.
• You care deeply about metadata quality and tag consistency across your library.
• You’re comfortable maintaining a Python service and troubleshooting API credential failures.
• You collect electronic music and want Beatport integration — there’s genuinely nothing else that does this.
• You’re already running slskd and understand the Soulseek ecosystem.

Skip it (use Lidarr instead) if:

• You want a tool with a large community, documentation, and third-party tutorials.
• You prefer arr-stack conventions and want SoulSync to integrate with Prowlarr and Radarr.
• You want a tool that’s legally unambiguous — Lidarr uses official APIs and indexers.
• You don’t need the discovery and playlist generation features; you just want automated music downloads.

Skip it entirely if:

• You’re not technical enough to manage credentials, debug API failures, and maintain two Docker services.
• Your jurisdiction takes copyright seriously and you’re worried about liability for Soulseek downloads.
• You want a tool with commercial support or an SLA.
• You’re evaluating this as a team — there’s no multi-user management here.

---

Alternatives worth considering

• Lidarr — the standard self-hosted music collection manager. GPL-3.0 licensed, large community, arr-stack integrations, works with indexers rather than direct service APIs. Legally cleaner than SoulSync’s Deezer/Tidal methods. Less sophisticated discovery. [AlternativeTo listing, [5]]
• Beets — command-line music library manager. Excellent MusicBrainz tagging, plugin ecosystem, no download automation. For collectors who want clean metadata without the legal complexity of automated downloads.
• MusicBrainz Picard — the canonical open-source tagger. What SoulSync’s “Picard-style” preflight is modeled after. Use this for manual tagging; use SoulSync if you want automation on top.
• Headphones — older Python-based music downloader, now largely unmaintained. SoulSync is the spiritual successor for this use case.
• Navidrome — not a downloader, but if you’re evaluating the full self-hosted music stack, Navidrome is the lightest-weight media server option that SoulSync integrates with. Pairs well with SoulSync’s scrobbling support.
• Spotify + Spotipy — if you want algorithmic discovery without the download automation complexity, staying on Spotify and using its API for playlist management is simpler and legal.

---

Bottom line

SoulSync is the most feature-complete self-hosted music discovery and download automation tool available for the format-obsessed collector who already has a media server running. The discovery engine — 12+ playlist types, 9 metadata sources, Beatport integration, cache-powered recommendations — is genuinely impressive for a 1,260-star project maintained by a single developer.

The honest caveat is that the tool’s most powerful feature, multi-source downloading from Deezer and Tidal via unofficial authentication methods, sits in legally gray territory. If you’re running this to automate downloads from a Qobuz subscription you’re paying for, the legal exposure is minimal. If you’re using Soulseek or extracted Deezer credentials, you’re knowingly outside the terms of service of those platforms. The README itself acknowledges the ban risk for Soulseek. Know what you’re running before you run it.

For a non-technical founder who just wants to stop paying for Spotify, this isn’t the tool — the setup and maintenance complexity is real. For a technically comfortable music collector who wants Spotify-quality discovery feeding a lossless library they fully own, SoulSync is the most complete answer in the self-hosted category.

---

Sources

1. Nezreka/SoulSync — GitHub README — “SoulSync - Intelligent Music Discovery & Automation Platform” — https://github.com/Nezreka/SoulSync (1,260 stars, MIT license)
2. SoulSync GitHub Repository (website scrape, March 2026) — https://github.com/Nezreka/SoulSync — project description, feature list, structure
3. AlternativeTo — Apps with Plex feature (Lidarr listing) — https://alternativeto.net/browse/all/?tag=plex