SoulSync

Automated Music Discovery and Collection Manager

$ git clone https://github.com/Nezreka/SoulSync.git
$ docker pull nezreka/soulsync:latest

What SoulSync Does

Everything you need to manage a self-hosted music library.

6 Download Sources

Download from Soulseek, YouTube, Tidal, Qobuz, HiFi, and Deezer. Hybrid mode tries each source in priority order with automatic fallback. Every download is tagged, organized, and verified.

Watchlist & Auto-Downloads

Follow artists and automatically scan for new releases. New albums and singles are detected, matched, and downloaded without manual effort. Configurable per artist — albums only, singles, EPs, or everything.

Playlist Sync

Import playlists from Spotify, Tidal, Deezer, YouTube, and Beatport. Tracks are matched to official metadata and synced to your Plex, Jellyfin, or Navidrome server. Playlists stay mirrored and can be refreshed.

Artist Discovery

Interactive artist maps, genre deep-dives, similar artist networks, and decade browsing. Personalized playlists like Release Radar and Discovery Weekly generated from your library and listening data.

10 Metadata Sources

Enrichment workers pull from Spotify, Apple Music, Deezer, Discogs, MusicBrainz, AudioDB, Last.fm, Genius, Tidal, and Qobuz. Every artist, album, and track gets the richest possible metadata automatically.

Download Verification

AcoustID audio fingerprinting verifies every download matches the expected track. Wrong files are quarantined automatically. Streaming source matching uses artist gating to reject incorrect results before download.

Library Management

Enhanced library manager with inline editing, bulk tag writing, and 16 automated repair jobs. Smart delete, track redownload, orphan detection, fake lossless detection, and metadata gap filling.

Automation Engine

Visual WHEN/DO/THEN workflow builder. Schedule scans, chain downloads to notifications, fire signals between automations. Discord, Telegram, and Pushbullet alerts built in.

Listening Stats

Library analytics with genre distribution, top artists and albums, listening timeline. Last.fm and ListenBrainz scrobbling. Full download history with source provenance tracking.

Audio Processing

Automatic metadata tagging, cover art embedding, and file organization with customizable path templates. Lossy copy creation, synchronized lyrics via LRClib, and multi-disc album handling.

Multi-Profile

Netflix-style profiles with separate watchlists, wishlists, and discovery pools. PIN protection, per-profile page access controls, and individual home page preferences. Shared library, separate personalization.

80+ API Endpoints

Full REST API powering every feature. Search, download, manage artists, trigger automations, query stats, and control playback programmatically. Build your own integrations or automate with scripts.

Metadata Enrichment

10 enrichment workers pulling from every major music database.

Spotify
Spotify
Apple Music
Apple Music
Deezer
Deezer
Last.fm
Last.fm
Genius
Genius
MusicBrainz
MusicBrainz
AudioDB
Tidal
Tidal
Qobuz
Discogs
Discogs

Servers & Sources

Downloads flow in. Music flows out to your servers.

Download Sources

Soulseek
Tidal
Tidal
Qobuz
Deezer
Deezer
HiFi
HiFi
YouTube
YouTube

Media Servers

Plex
Plex
Jellyfin
Jellyfin
Navidrome
Emby
Emby unofficial