# SoulSync

SoulSync is an automated music and video discovery and collection manager for Plex and Jellyfin that syncs playlists, then finds, downloads, tags, verifies, and organizes media from sources including Soulseek, Tidal,. It is open source and self-hosted, installable on Docker Hub, Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/1075/soulsync

## Description

SoulSync is an automated music and video discovery and collection manager for Plex and Jellyfin that syncs playlists, then finds, downloads, tags, verifies, and organizes media from sources including Soulseek, Tidal, Qobuz, and YouTube, replacing separate *arr, tagging, and script tools.

## Platform availability

Available on 2 of 9 platforms: Unraid, Proxmox.

## Health score

77/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 67 (2,272 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/boulderbadgedad/soulsync
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=soulsync
- Unraid: https://ca.unraid.net/apps/soulsync-00qpelu1i2z986?q=SoulSync
- GitHub: https://github.com/Nezreka/SoulSync
- Official website: https://ssync.net/

## Common questions

### Why does the SoulSync interface fail to display in a non-Docker install?

Manual Python installs need the web build, so run npm ci and npm run build inside the webui folder before starting gunicorn. Without the built web files, the browser may not show the SoulSync interface.

### Why can't the SoulSync container read my music or save settings?

Match the container's PUID and PGID to your host account's UID and GID shown by the id command. If they are wrong, the container may not have permission to read your music or save settings.

### Why do library maintenance jobs miss files that are already in my own libraries?

The path resolver does not include own-library folders, so Orphan File Detector and other folder-walking jobs may not find them. Adding those folders under Additional Music Libraries makes own-library files discoverable.

## Alternatives

- Soundiiz: Transferring playlists and favorites between various music platforms.
- Tune My Music: Transfer Playlists From Any Music Platform To Any Other Music Platform!

---
Source: Our Local Host (https://ourlocalhost.com/app/1075/soulsync), the self-hosted and open-source app directory.