Your watched artists and their similar connections
Genres
Artists clustered by genre across your library and cache
Explorer
Pick any artist and explore outward through their connections
Artist Map
Genres
Recommended For You
Artists similar to ones across your library — not yet on your watchlist
Your Artists
Artists you follow across your music services
Your Albums
Albums you've saved across your music services
Loading your albums...
Recent Releases
New music from artists you follow
Loading recent releases...
Seasonal
Seasonal music
Seasonal Mix
Curated seasonal
playlist
⟳Syncing to media server...
✓ 0⏳ 0✗ 0(0%)
🎵 Daily Mixes
Personalized mixes based on your taste
Fresh Tape
New drops from recent releases
⟳Syncing to media server...
♪ 0/✓ 0/✗ 0(0%)
Loading fresh tape...
The Archives
Curated from your collection
⟳Syncing to media server...
♪ 0/✓ 0/✗ 0(0%)
Loading the archives...
🔥 Popular Picks
Trending tracks from new discoveries
⟳Syncing to media server...
✓ 0⏳ 0✗ 0(0%)
🌟 Hidden Gems
Underground discoveries waiting for you
⟳Syncing to media server...
✓ 0⏳ 0✗ 0(0%)
🔀 Discovery Shuffle
Random tracks from your discovery pool - different
every time
⟳Syncing to media server...
✓ 0⏳ 0✗ 0(0%)
Build a Playlist
?
Create a custom playlist from your favorite artists
How it works:
Search and select 1-5 seed artists you like
Hit Generate — the app finds similar artists, pulls their albums, and picks tracks at random
You get a fresh 50-track playlist mixing your picks with new discoveries
Tip: The more seed artists you add, the more varied the playlist will be.
Seed Artists
0 / 5
Search above to add seed artists
Finding similar artists and building your playlist...
Generated Playlist
⟳Syncing to media server...
✓ 0⏳ 0✗ 0(0%)
📻 Last.fm Radio
Search a track to generate a similar-tracks playlist
🧠 ListenBrainz Playlists
Playlists from ListenBrainz
Loading playlists...
⏰ Time Machine
Explore music from different decades
Loading decades...
🎵 Browse by Genre
Discover music by your favorite genres
Loading genres...
Playlist Explorer
Select a playlist above, then explore
0 albums selected
Scroll to zoom · Right-drag to pan · Double-click album for tracks
Select a playlist to explore
Choose a mirrored playlist and mode above, then click Explore to build the discovery tree
Building tree...
Settings
Configure services, downloads, and preferences
API Configuration
Metadata Source
Where artist, album, and track metadata comes from:
• Spotify — official Spotify; connect your account in the Spotify section below.
• Spotify (no auth) — the same Spotify catalog with no account needed. It's unofficial and best-effort (may break if Spotify changes its site) and can't read your personal library or playlists.
• Deezer / iTunes — free, no account.
• MusicBrainz — free, but limited to 1 request/sec.
• Discogs — needs a personal access token.
Tip: if you pick Spotify (no auth) and later connect a real Spotify account, it uses the official account normally and only falls back to no-auth while Spotify is rate-limited — then switches back automatically.
Spotify
›
Current Redirect URI:
http://127.0.0.1:8888/callback
Add this URL to your Spotify app's 'Redirect URIs' in
the Spotify Developer Dashboard
Runs the background metadata enrichment worker on the no-auth Spotify source instead of this connected account — keeping bulk enrichment off your official API quota (and dodging rate-limit bans), so your account is reserved for interactive search and playlist sync. On by default. Turn off to enrich through your connected account instead. Works even with no account connected. Note: the no-auth source can't supply artist genres.
iTunes / Apple Music
›
Sets the primary Apple Music storefront. Region-specific albums are auto-searched across other storefronts as fallback.
Deezer (Favorites & Playlists)
›
Current Redirect URI:
http://127.0.0.1:8008/deezer/callback
Add this URL to your Deezer app at developers.deezer.com
Or use an ARL token for playlist access and downloads (no OAuth app needed):
Log into deezer.com
→ DevTools (F12) → Application → Cookies → copy the arl value. Provides playlist access + downloads.
Click "Generate new token" — no app registration needed. Provides 60 req/min and cover art in search results.
Tidal (Playlists & Metadata)
›
Current Redirect URI:
http://127.0.0.1:8889/tidal/callback
Add this URL to your Tidal app configuration
Qobuz (Metadata & Enrichment)
›
Connects Qobuz for metadata enrichment (ISRC, labels, copyright). Also used for downloads if Qobuz is your download source.
Alternative: Auth Token — If email/password login fails (CAPTCHA), paste your token directly:
To get your token: log into play.qobuz.com
→ DevTools (F12) → Network tab → find any request to www.qobuz.com/api.json
→ look in the request headers for X-User-Auth-Token → copy that value.
Self-hosted? Enter your server URL (e.g. http://localhost:8093)
Hydrabase
›
P2P metadata network. When enabled and connected, replaces Spotify/iTunes as the primary metadata source for searches.
Server Connections
Select which music library to use (doesn't affect config file)
Go to https://plex.tv/link and enter the code shown above.
Timeout for
bulk API requests during database sync (15-300s). Increase if your
Jellyfin server is slow to respond.
Select which user's music library to scan
Select which music library to use (doesn't affect config file)
Navidrome users should enable Real Path in the Navidrome player/settings so SoulSync can resolve imported and synced files correctly.
Select which music library to import from
Standalone Mode
SoulSync manages your library directly without an external media server. Import your existing music first: move files into the import folder, then use a separate music/output folder for the processed library SoulSync creates.
Download Settings
These are container-internal paths. Only modify them if you know what you're doing — incorrect values will break downloads.
Where Organize by playlist builds playlist folders — as shortcuts into your library, so songs are never stored twice. Keep this outside your music library folder so your media server doesn't scan the same tracks twice.
Symlinks use almost no space. Copies are self-contained. Symlinks fall back to copies automatically where the filesystem can't link (Windows without privileges, some network shares, FAT/exFAT drives).
Optional prefix added to every track path in exported M3U files. Use this when your media server needs absolute paths (e.g. /mnt/music).
Choose where to download music from. Hybrid mode tries primary source first,
then falls back to secondary if it fails.
Where to stream audio when previewing tracks. YouTube is instant and requires no setup.
"Active Download Source" uses your configured source (Tidal, Qobuz, etc.) — if that's Soulseek, YouTube is used automatically.
Maximum simultaneous downloads per batch. Soulseek album downloads always use 1 worker
due to per-user upload limits. Higher values speed up large playlists and wishlists.
Drag to reorder source priority. Enable sources you want to use. Downloads try each enabled source in order.
The first source can use album-level downloads when supported; later sources stay track-level fallback.
How long to search
for tracks (15-300 seconds)
Extra time to wait
for late results (5-60 seconds)
Forces a gap between
consecutive searches. Smooths burst patterns
that trip ISP anti-abuse (e.g. Bell Canada
cuts the WAN after rapid peer-connection
spikes). 0 disables.
Ignore search results from peers with upload speed below this threshold
Skip peers with a queue longer than this (prefers peers with shorter queues regardless)
Abandon stuck downloads after this many minutes
Automatically cleans old searches from slskd when over 200 entries.
Disable if you want to keep manual searches in slskd's queue.
Audio quality for Tidal downloads. HiRes requires a Tidal HiFi Plus subscription.
When disabled, only downloads at the exact quality selected. If unavailable, skips to the next source.
Audio quality for Qobuz downloads. Hi-Res requires a Qobuz Studio or Sublime subscription.
When disabled, only downloads at the exact quality selected. If unavailable, skips to the next source.
Requires a paid Qobuz subscription. Streams are DRM-free.
Alternative: Auth Token — If email/password login fails (CAPTCHA), paste your token directly:
To get your token: log into play.qobuz.com
→ DevTools (F12) → Network tab → find any request to www.qobuz.com/api.json
→ look for X-User-Auth-Token in the request headers → copy that value.
Audio quality for HiFi downloads. Uses public API instances — no account required.
When disabled, only downloads at the exact quality selected. If unavailable, skips to the next source.
Free lossless downloads via community-run hifi-api instances. No authentication or subscription needed.
Audio quality for Deezer downloads. FLAC requires a Deezer HiFi subscription.
MP3 320 requires Premium or higher.
When disabled, only downloads at the exact quality selected. If unavailable, skips to the next source.
Your ARL token authenticates with Deezer. To get it:
log into deezer.com
→ open browser DevTools (F12) → Application tab → Cookies → copy the arl value.
Preferred codec tier. FLAC is 24-bit/48kHz Hi-Res — no subscription required.
Downloads via T2Tunes proxy.
Fall back to the next codec tier if the preferred one is unavailable.
No account required — T2Tunes is a public Amazon Music proxy.
SoundCloud downloads run anonymously — no account required. Use this for DJ mixes,
remixes, and tracks that aren't on Spotify/Tidal/Deezer.
Quality: 128 kbps MP3 / AAC depending on the upload (anonymous tier).
SoundCloud doesn't expose lossless audio to anyone.
Full URL to your Lidarr instance (e.g. http://192.168.1.100:8686)
Found in Lidarr → Settings → General → Security → API Key
Uses Lidarr's indexers and download clients (Usenet/torrent) for album downloads.
Best for full-album grabs. Lidarr is album-first by design — track-name searches usually return nothing useful, so in hybrid mode Lidarr is mostly a no-op for playlists and falls through to your other sources. Use Lidarr Only when you specifically want to grab whole albums via your indexers.
📡 Torrent and Usenet downloads run through your Prowlarr indexers and your configured downloader. Set up Prowlarr + the torrent / usenet client on the Indexers & Downloaders tab. Once Test Connection is green on both, this source is ready to use.
If YouTube shows "Sign in to confirm you're not a bot", select your browser here.
SoulSync will use your browser's YouTube cookies to authenticate.
Seconds between YouTube downloads to avoid bot detection. Default: 3
▼
Quality Profile
Format priorities, bitrate, bit depth
🎵 Quality Profile
Priority: 1
500 kbps-10000 kbps
When enabled, accepts any FLAC rather than rejecting on bit depth mismatch
Priority: 2
280 kbps-500 kbps
Priority: 3
200 kbps-400 kbps
Priority: 4
150 kbps-300 kbps
How it works: Downloads try each enabled quality in priority order
(1 = highest).
MIN bitrate catches fake/transcoded files (e.g., FLAC below 500 kbps is likely a
re-encoded MP3). MAX bitrate limits hi-res files if you want to save space.
When track duration is unavailable, a generous file-size safety net is used instead.
▼
Retry Logic
Next-best candidate, exhaustive per-source retry
🔁 Retry Logic
Controls what happens when a downloaded file is rejected (AcoustID mismatch, wrong version, or duration/integrity failure). Independent of post-processing.
When a download is quarantined (AcoustID mismatch or duration/integrity failure), automatically try the next-best candidate instead of failing the track. Off = quarantine and fail immediately.
Give every source (Soulseek, then HiFi/Tidal/…) its own retry budget. Each source spends queries × retries-per-query attempts before the track moves on. Worst case across two sources can mean many downloads — use for hard-to-match tracks (e.g. CJK artist names). Requires the option above.
In exhaustive mode, how many candidates to try per search query per source. The per-source budget is number of search queries × this value. Only used when Exhaustive retry is on.
When retries are fully exhausted and every candidate for a track failed the same version mismatch (e.g. only an instrumental exists), accept the best (first-tried) one instead of leaving the track missing. Only AcoustID is bypassed — integrity/duration/bit-depth checks still run, so truncated or genuinely wrong files are never let through. Off = leave such tracks failed.
How many quarantined candidates must have failed the same version mismatch before the last-resort acceptance kicks in. Higher = more confirmation that no correct version exists. Only used when the option above is on.
Configure your Prowlarr instance to feed search results, and pick a torrent client and/or usenet client to handle the actual downloads. You only need to set up the protocols you actually use.
💡 Filesystem access — easiest setup
Torrent and usenet clients write files to their own download folders, not Soulseek's. SoulSync needs read access to those folders to import the files. Simplest fix: point all your downloaders (Soulseek, qBittorrent, SABnzbd / NZBGet) at the same download folder. One folder, one path to worry about, everything just works.
Bare-metal: just set every client's download path to the same folder (e.g. your existing slskd folder). Done.
Docker: easiest is to reuse the ./downloads mount you already have for slskd — point qBit and SAB at /downloads inside their containers too. Or use the commented placeholders in docker-compose.yml if you want separate folders.
Remote client (NAS / different host): mount the remote folder locally (SMB / NFS / rclone) before SoulSync can see it.
▼
🔎 Indexers
Prowlarr — search aggregator
⬢ Prowlarr
Prowlarr manages your Usenet and torrent indexers and exposes them through one API. SoulSync uses Prowlarr to search across every indexer at once for the Torrent and Usenet download sources.
Don't have it? Grab Prowlarr from prowlarr.com (or your *arr stack). You point Prowlarr at your indexers, then point SoulSync at Prowlarr.
Full URL to your Prowlarr instance (e.g. http://192.168.1.100:9696).
Found in Prowlarr → Settings → General → Security → API Key.
Comma-separated Prowlarr indexer IDs. Leave blank to search every enabled indexer. Restrict when you have a private tracker you want to prioritise or a noisy public one to exclude.
Connect to Prowlarr and click Refresh Indexer List to see the indexers SoulSync can search.
▼
🧲 Torrent Client
qBittorrent · Transmission · Deluge
⬢ Torrent Downloader
Where SoulSync sends torrents once Prowlarr finds them. Pick the client you already use — only one can be active at a time. Add the URL of the client's WebUI, log in if it asks for credentials, and hit Test Connection.
qBittorrent: WebUI port (default 8080). Transmission: RPC port (default 9091). Deluge: WebUI port (default 8112). Aria2: RPC port (default 6800) — leave Username blank and put your --rpc-secret in the Password field.
qBittorrent and Transmission use username + password. Deluge uses password only — paste it in the password field below.
SoulSync tags every torrent it adds with this label so it's easy to spot in your client. Deluge needs the Label plugin installed for this to stick.
Override where the torrent client writes downloads. This path is on the torrent client's machine, not SoulSync's.
Give up on a torrent that makes zero download progress for this long — a dead magnet stuck on "downloading metadata", or a swarm with no seeders. Without this, a dud torrent ties up a download slot for the full 6-hour limit. 0 disables (wait the full limit).
Abandon frees the slot so the next source can try. Pause keeps the torrent in your client so you can inspect or resume it manually.
▼
📰 Usenet Client
SABnzbd · NZBGet
⬢ Usenet Downloader
Where SoulSync sends NZBs once Prowlarr finds them. Pick one usenet downloader. SABnzbd uses an API key for auth; NZBGet uses a username + password.
SABnzbd: default WebUI port 8080. NZBGet: default WebUI port 6789.
SABnzbd → Config → General → API Key. Used by SABnzbd only.
SoulSync tags every NZB with this category so it ends up in a predictable post-processing folder.
▼
Paths & Organization
File templates, music library paths
📁 File Organization
Variables: $albumartist, $artist, $artistletter, $album, $albumtype,
$title, $track, $disc (01), $discnum (1), $cdnum (CD01 on multi-disc, empty on single), $year, $quality (filename only). Use ${var} to append text: ${albumtype}s → Albums
Variables: $playlist, $albumartist, $artist, $artistletter, $title, $year, $quality (filename only). Use ${var} to append text
Variables: $artist, $artistletter, $title, $year. Use ${var} to append text. Default: $artist/$title-video
Label used for auto-created disc subfolders on multi-disc albums.
How $albumartist resolves for albums with multiple artists.
"First Listed" uses only the primary artist for folder names (e.g., "Larry June" instead of "Larry June, Curren$y & The Alchemist").
Full artist list is always preserved in file metadata tags.
Separator between multiple artists in the ARTIST tag (e.g. & matches MusicBrainz/Picard style)
Write each artist as a separate tag value for Navidrome/Jellyfin multi-artist support
Keep only primary artist in ARTIST tag, append others as (feat. ...) in title
When enabled, the same song can be added to the wishlist from
different albums (e.g., completing a discography where albums share tracks).
When disabled, tracks with the same name and artist are skipped.
Restores original path structure. Your downloads will be organized like before.
📂 Music Library Paths
Tell SoulSync where your music files live. Required for tag writing, streaming, and file detection
when your media server stores files at a different path than SoulSync can see.
Docker users: mount your music folder(s) into the SoulSync container with read-write access,
then add the container-side path here (e.g. /music).
▼
Post-Processing
Metadata, tags, conversion, lyrics
🎵 Post-Processing
Master toggle — disabling this skips all metadata, artwork, and lyrics processing
Core Features
Higher resolution but quality may vary. When off, uses Spotify/iTunes/Deezer art (consistent 640x640). Ignored when a preferred album art source list is set below — add Cover Art Archive to that list instead.
Order the sources to choose whose cover art is used. The first source that has a cover wins; misses fall through to the next, and if none match, your download's own art is kept. Only sources you're connected to are shown — leave all off to keep current behavior.
Analyzes loudness and writes ReplayGain track gain/peak tags. Requires ffmpeg. Adds a few seconds per track.
Maximum drift between the file's actual length and the metadata source's expected length before the file is quarantined. 0 = auto (3s normal, 5s for tracks >10min). Raise this if tracks routinely quarantine for being a few seconds off (live recordings, alternate masterings, etc). Capped at 60s.
Tag Embedding
Toggle a service to enable/disable all its tags, or expand to control individual tags.
▶3 tags
▶3 tags
▶18 tags
▶4 tags
▶4 tags
▶5 tags
▶5 tags
▶2 tags
▶2 tags
▶5 tags
▶2 tags
MP3, FLAC, MP4/M4A, OGG
📀 Post-Download Conversion
When a 24-bit or high sample rate FLAC is downloaded, it will be
automatically converted to 16-bit/44.1kHz. The hi-res original is
replaced — not kept alongside. Requires ffmpeg.
After downloading a FLAC, a lossy copy at the selected codec and bitrate
will be created in the same folder. Requires ffmpeg.
Warning: The original high-quality file will be permanently deleted.
Only the lossy copy will remain.
▼
Library Preferences
Import, content filter, playlists, stats
📊 Listening Stats
Polls your active media server (Plex, Jellyfin, or Navidrome) for play history
and displays stats on the Stats page.
🔒 Security & Access
By default, anyone who can reach SoulSync on your network can use it. Protect access below with a simple shared PIN, or full user accounts with passwords — you only need one. The last group is just for exposing SoulSync over the internet.
🔑 Lock with a PIN simple · one shared PIN
Set a PIN before you can turn on the lock screen.
A lock screen appears on every page load, verified against the admin PIN. Closing the tab requires re-entry.
👤 User accounts (login) per-person · best for public access
Everyone signs in with their account name + password. Turning this on replaces the PIN and the profile picker. Set passwords for other people in Manage Profiles.
✓ A login password is set
So you can reset a forgotten password by answering it on the sign-in screen.
Replaces the profile picker + PIN with a sign-in screen. Best for instances exposed to the internet.
🌐 Reverse proxy & remote access
Only needed if you expose SoulSync to the internet behind nginx / Caddy / Traefik. See Support/REVERSE-PROXY.md.
Trusts the proxy's X-Forwarded-* headers, marks the session cookie HTTPS-only, and adds security headers. Leave OFF for direct / LAN access over http:// — it would otherwise break plain-HTTP login. Takes effect after a restart.
If an auth proxy (Authelia / Authentik / oauth2-proxy) logs users in in front of SoulSync, enter the header it sets and SoulSync trusts it. Only set this behind a proxy that strips any client-supplied copy of the header. Blank = off.
Origins (full URL, no trailing slash) allowed to open WebSocket connections — one per line or comma-separated. Empty = same-origin only (the secure default; fine for direct access and most reverse-proxy setups). Add your public domain if live updates fail behind a proxy. * on its own line allows any origin (insecure).
🔍 Discovery Pool Settings
Controls how far back to scan when adding new artists or refreshing discovery
pool.
Once scanned, artists are kept updated with new releases only.
Adjusts seasonal playlists on the Discover page to match your region.
Southern hemisphere flips seasons (e.g. December = Summer, June = Winter).
Holidays like Christmas and Halloween stay calendar-fixed.
UI Appearance
Changes the accent color across the entire UI
Audio-reactive visualizer on the sidebar edge when music is playing
Animated particle effects behind each page. Disable to reduce GPU usage.
Dashboard header buttons animate as floating orbs. Hover the header to expand. Desktop only.
Disables backdrop blur, animations, transitions, and shadows. Significantly reduces GPU/CPU usage on low-end devices.
Database Settings
Number of parallel threads for database updates. Higher values =
faster updates but more server load.
Database Maintenance
Loading...
Loading...
Loading...
Compact Database rewrites the entire DB to reclaim unused space. Locks the database briefly — may take a minute on large databases. Incremental Vacuum enables automatic page reclamation. Requires a one-time full compact to activate. After that, freed pages are reclaimed in small batches automatically.
🔞 Content Filter
When disabled, tracks marked as explicit on Spotify will be skipped
during matched downloads. Does not affect manual Soulseek searches.
🎵 Genre Whitelist
When enabled, only genres on the whitelist below are kept during enrichment. Junk tags (artist names, radio shows, playlist names) are silently dropped. When disabled, all genres pass through unchanged.
📥 Import Settings
When importing from Staging, if a track already exists in your library at a lower quality
(e.g. MP3), it will be replaced with the higher quality version (e.g. FLAC).
If disabled, existing tracks are always kept and the import file is skipped.
On by default (legacy behaviour). When enabled, files staged as
Artist/Album/… (or Artist/Albums/Album/…) take the top
folder as the album artist — handy for mixtapes/compilations whose embedded tags
carry DJ names. Turn this off if you drop a mixed pile of songs
under one container folder: otherwise every file's artist gets overwritten with
that folder's name (the cause of the "soulsync" mass-mislabel). With it off, the
metadata-identified artist is always kept.
📋 M3U Playlist Export
Saves an M3U playlist file alongside your music. Albums are skipped — they're already grouped by your media server.
Playlist Sync Settings
"Replace" deletes and recreates the server playlist every sync, which wipes its custom image/description. "Reconcile" updates the same playlist in place (adds new tracks, removes ones no longer in the source) so your custom image and description survive. "Append" only ever adds.
Logging
Controls the level of detail in application logs. DEBUG shows all details, INFO
shows general operations, WARNING and ERROR show only issues.
logs/app.log
SoulSync API
REST API Keys
Generate API keys to access SoulSync remotely via the /api/v1/ endpoints.
Keys are shown once at creation — store them securely.
Loading...
Copy this key now — it won't be shown again!
Inbound Request Endpoint
Trigger music downloads from external tools (Discord bots, Home Assistant, curl, etc.)
using any API key above.
Returns a request_id for status polling. Add "notify_url" to POST results to a webhook on completion.
Also triggers any Webhook Received automations in the Automation Hub.
🔧 Developer Mode
Inactive
Initializing log viewer...
0 lines● Live
Hydrabase
Disconnected
API Calls
Tracks
Albums
Artists
Discography
Album Tracks
Response
API responses will appear here
Network
Peers: --
Source Comparisons
When Hydrabase is the active metadata source, searches are compared against Spotify and iTunes in the background.
No comparisons yet. Search with Hydrabase active to generate comparisons.
Automated scanning, detection, and repair of library issues
Loading jobs...
Loading findings...
Loading history...
Database & Scanning
Database Updater
Last Full Refresh: Never
Artists:0
Albums:0
Tracks:0
Size:0.0 MB
Idle
0 / 0 artists (0.0%)
Quality Scanner
Scan library for tracks below quality preferences
Processed:0
Quality Met:0
Low Quality:0
Matched:0
Ready to scan
0 / 0 tracks scanned
(0.0%)
Import IDs from File Tags
Read provider IDs (Spotify, MusicBrainz, iTunes, Deezer…) already embedded in your files and fill them into the database — lets enrichment workers skip redundant API lookups. Only fills blanks; never overwrites an existing match.
IDs Filled:0
Rows Updated:0
Conflicts:0
Unreadable:0
Ready to scan
0 / 0 files scanned (0.0%)
Duplicate Cleaner
Detect and remove duplicate tracks in output folder
Files Scanned:0
Duplicates Found:0
Deleted:0
Space Freed:0 MB
Ready to scan
0 files scanned
(0.0%)
Media Server Scan
Manually trigger Plex media library scan for music
Last Scan:Never
Status:Idle
Ready to scan
Waiting for scan request
Metadata & Cache
Metadata Updater
Updates artist photos, genres,
and album art from Spotify.
Current Artist: Not
running
0 / 0 artists (0.0%)
Discovery Pool
View and fix matched/failed discovery results across all mirrored playlists
Matched:—
Failed:—
Manual Library Match
Map wishlist and playlist source tracks to library tracks you already own
Source:Wishlist / Sync
Result:Found
Management
Backup Manager
Create, download, restore and manage database backups
Last Backup:Never
Backups:0
Latest Size:—
DB Size:—
Metadata Cache
Cached API responses from Spotify & iTunes
Artists:0
Albums:0
Tracks:0
Hits:0
Download Blacklist
Blocked sources that won't be used for future downloads
Blocked:0
Watchlist
0 artistsNext Auto: --
Scanning
0found
0added
Waiting…
starting…
—
—
Added to wishlist this run
⚠️Global override is active — per-artist settings are being ignored during scans.
Last scan: --
Your watchlist is empty
Use Search to find an artist, then add them to your watchlist from the artist page.
⭐
Wishlist
0 tracksNext Auto: --
0Album Tracks
0Singles
Albums/EPsNext Cycle
0 selected
Loading tracks...
Your wishlist is empty
Failed downloads and tracks from watchlist scans will appear here automatically.
Choose the album that best matches your download for
Top Suggestions
Or, Search Manually
SoulSync
I built this app because I wanted it, not to make money. SoulSync is and always will be free.
If it's saved you time or you just want to show some love, any support is genuinely appreciated.
Version {{ soulsync_base_version }} — Latest Changes
×
Tracks to Add to Wishlist
All tracks from this release will be added to your
wishlist
×
Download Preferences
Select which types of releases to monitor for this artist
Content Filters
Check to INCLUDE, leave unchecked to EXCLUDE (default: all
excluded)
Scan Lookback
How far back to look for releases on first scan of this artist
Scan Source
Override which metadata provider is used when scanning this artist for new releases
Linked Artist
The metadata provider artist linked to this watchlist entry
Global Watchlist Settings
Override per-artist settings for all watchlist scans.
Release Types
Select which release types to download for all artists
Content Filters
Check to INCLUDE, leave unchecked to EXCLUDE (default: all
excluded)
Custom Exclusion Terms
Comma-separated terms — tracks or albums matching any term will be skipped during scans
Applied globally to all watchlist scans regardless of override setting. Case-insensitive substring matching.
🎵 Browse by Genre
🔍
🔍 Discovering current Beatport genres...
Tool Information
Library History
Sync History
Metadata Cache Browser
Spotify0
iTunes0
Deezer0
Beatport0
MusicBrainz0
Discogs0
Total Hits0
Searches0
Entity Detail
🎵Downloads0
Confirm
Spotify Rate Limited
Spotify has temporarily blocked API access. All Spotify features (search, enrichment, playlists) are paused until the ban expires.
Ban Duration—
Triggered By—
Time Remaining—
While rate limiting is active, Spotify-specific features are unavailable. You can wait for the ban to expire or disconnect Spotify to clear it immediately.
