SoulSync

Automated Music & Video Discovery and Collection Manager

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

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
Video

Movies, TV & YouTube

A whole video side, isolated from music, with its own library, calendar, and download pipeline. The self-hosted Radarr and Sonarr alternative, built in.

Isolated Video Library

Its own database, dashboard, search, and TV calendar for movies, TV, and YouTube. Works with Plex and Jellyfin, with per-server isolation, and never touches your music side.

Movie & TV Enrichment

TMDB, TVDB, and OMDb matching plus 10 background workers — fanart.tv, OpenSubtitles, Trakt, TVmaze, AniList, and more. Ratings, artwork, cast, and episode data filled automatically, gap-fill only.

Follow → Wishlist → Download

Follow shows, actors, directors, studios (Disney = Pixar + Marvel + Lucasfilm), and YouTube channels. Anything you don't own is wishlisted and grabbed automatically, forward-looking up to a year out.

Radarr / Sonarr-Class Matching

Quality-profile ladders with cutoff, upgrade-until-cutoff, and reject rules. Release title and TMDB-alias gating so you never grab the wrong film. Soulseek, Prowlarr indexers, and yt-dlp.

TV Calendar

A real week grid with air times and a billboard. Wishlist an airing episode straight from the modal, or auto-grab today's airings Sonarr-style. Nightly schedule refresh keeps it current.

Overlay Studio

A Kometa-style visual overlay editor that paints resolution, rating, and provider badges onto your Plex and Jellyfin posters. Nightly re-apply, and it skips anything unchanged.

Collection Manager

Build Plex Collections and Jellyfin BoxSets from smart filters and ranked lists — IMDb, TMDB, Trakt, and MDBList — rendered in true rank order, not by year. Franchise auto-backfill included.

YouTube Channels

Follow channels and playlists as shows (yt-dlp, no API key). Long-form only, per-channel keep windows, and true downloaded-state tracking so nothing re-downloads.

Server Activity

A Tautulli-style live now-playing drawer for Plex and Jellyfin: streams pushed over websocket, watch history, statistics, and terminate-a-stream. Click any stream to open it inside SoulSync.

Library Maintenance

Repair jobs for broken files, duplicates, metadata gaps, and missing episodes. Plus bulk metadata editing with per-field locking, re-identify, a download history archive, and an issues system.

Video Automations

A visual automation engine for the video side: scheduled scans, the whole watchlist → wishlist → download pipeline, nightly overlay and collection sync, and event triggers on its own shared engine.

Discover

Progressive, Netflix-feel search across movies, shows, people, studios, and YouTube. Plus trending, similar titles, and complete-your-collection gap-finding for your franchises.

Download Sources

Soulseek
Prowlarr
YouTube
YouTube

Media Servers

Plex
Plex
Jellyfin
Jellyfin