-
+
-
Settings
- Configure services, downloads, and preferences
-
+
@@ -3923,7 +3922,7 @@
-
+
@@ -3937,6 +3936,7 @@
-
API Configuration
+Metadata Source
@@ -3950,9 +3950,9 @@ -
-
Where artist, album, and track metadata comes from:
+ +
@@ -4571,81 +4573,17 @@
+ +
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.
@@ -3999,13 +3999,15 @@ Disconnect
• 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.
@@ -3999,13 +3999,15 @@ Disconnect
-
-
-
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.
+
+
+
+ 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.
-
-
Download Settings
-
- These are container-internal paths. Only modify them if you know what you're doing — incorrect values will break downloads.
-
+
+
+ ▼
+
+ Source Settings
+ Source, stream & concurrency +
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 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.
@@ -4675,7 +4615,9 @@
-
+
+
+
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.
@@ -4693,17 +4635,23 @@
-
+
+
+
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.
+
+ Checks every selected source & configured connection.
+
+
+
▼
- Quality Profile
Format priorities, bitrate, bit depth
+
-
+
+
+
+
+
@@ -5079,7 +5029,7 @@
-
-
+
+
+ onclick="toggleSettingHelp(this)" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();toggleSettingHelp(this);}">i
How it works: Each download source is checked against this list
@@ -5154,7 +5104,7 @@
+ onclick="toggleSettingHelp(this)" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();toggleSettingHelp(this);}">i
A single source often returns several copies of the same track.
@@ -5203,7 +5153,7 @@ Accept off-list quality when nothing in the list is available + onclick="toggleSettingHelp(this)" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();toggleSettingHelp(this);}">i
@@ -5203,7 +5153,7 @@ Accept off-list quality when nothing in the list is available + onclick="toggleSettingHelp(this)" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();toggleSettingHelp(this);}">i
This does not mean "walk down my list" — the list already
@@ -5216,17 +5166,137 @@
+ ▼
+
+ Quality on Import
+ Apply the profile to manually imported files +
+
+
+
+
+
+
+
-
+
+ On by default. SoulSync always probes each downloaded file's real audio quality; this
+ toggle decides what to do with the result. On — files that don't meet your
+ quality profile are quarantined instead of imported (the same gate the download pipeline
+ uses; fallback/downsample settings still apply). Off — everything is
+ imported regardless of quality. Either way, the library Quality Upgrade Scanner
+ still flags below-profile tracks so you can act on them later.
+
+
+
+
+
+
+
+
+ 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.
+
+
+ ▼
+
+ Post-Download Conversion
+ Downsample hi-res, make lossy copies +
+
+
+
+
+
+
+
+
+
+
+
+ When a 24-bit or high sample-rate FLAC is downloaded, it is 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 is created in the same folder. Requires ffmpeg.
+
+ ▼
+
+ Audio Verification
+ AcoustID identity match + truncated/silent detection +
+
-
-
-
+
+
-
+
-
-
+
+ onclick="toggleSettingHelp(this)" onkeydown="if(event.key==='Enter'||event.key===' '){event.preventDefault();toggleSettingHelp(this);}">i
-
+
-
When on, a track that AcoustID runs but cannot confirm
(no fingerprint match / cross-script metadata — the ⚠ "unverified" case) is
quarantined instead of imported. Downloads then try the next
@@ -5244,96 +5314,51 @@
outage) always import, so an AcoustID outage never stalls you. Requires AcoustID enabled.
- ▼
-
- 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.
-
-
-
+
+
+ Indexers & Downloaders
-
- 1 Indexers find releases
- →
- 2 Downloader fetches them
- →
- 3 SoulSync imports to library
-
-
- 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
./downloadsmount you already have for slskd — point qBit and SAB at/downloadsinside their containers too. Or use the commented placeholders indocker-compose.ymlif you want separate folders.
- - Remote client (NAS / different host): mount the remote folder locally (SMB / NFS / rclone) before SoulSync can see it. -
+
+
+ Decodes every downloaded file with ffmpeg to catch fake 30s previews padded to full length and mostly-silent files — the kind whose header lies about the length so mutagen can't catch them. Off by default: this fully decodes each file, the most CPU-heavy post-processing step. Most sources (HiFi, Qobuz) already catch previews on their own, so only turn this on if you see padded/silent files slip through. Applies to all download sources.
+
+
+
+
- 💡 Filesystem access — easiest setup ▾
+
+
▼
-
- 🔎 Indexers
+Indexers
Prowlarr — search aggregator
-
+
+
-
⬢ Prowlarr
-
+
-
-
+
+ ⬢ 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
Don't have it? Grab Prowlarr from
prowlarr.com (or your *arr stack). You point Prowlarr at your indexers, then point SoulSync at Prowlarr.
@@ -5381,18 +5406,23 @@
+
+
+
▼
-
- 🧲 Torrent Client
+Torrent Client
qBittorrent · Transmission · Deluge
-
+
+
-
⬢ Torrent Downloader
-
+
-
-
+
+ ⬢ 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.
@@ -5473,18 +5503,25 @@
+
+
+
+
+
▼
-
- 📰 Usenet Client
+Usenet Client
SABnzbd · NZBGet
-
+
-
+
+
+
+
+
-
+ ⬢ Usenet Downloader
-
+
+
+ ⬢ 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.
@@ -5542,18 +5579,164 @@
+ ▼
+
+ Retry Logic
+ What happens when a download is rejected +
+
+
+
+
+
+
+
+
+ Controls what happens when a downloaded file is rejected (AcoustID mismatch, wrong version, or duration/integrity failure) — independent of post-processing. When on, SoulSync automatically tries 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.
+
+
+
+
+
+
+
+ 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.
+
▼
Paths & Organization
- File templates, music library paths + Folders, file templates & library paths
+
+
-
-
-
+
+
Folder Paths
+
+ Container-internal paths. Only change them if you know what you're doing — wrong values 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).
+
-
-
+
📁 File Organization
+File Organization
- Variables: $albumartist, $artist, $artistletter, $title, $track (01), $album, $albumtype, $year, $quality (filename only). Use ${var} to append text: ${albumtype}s → Singles
+
+ Variables:
$albumartist, $artist, $artistletter, $title, $track (01), $album, $albumtype, $year, $quality (filename only). Use ${var} to append text: ${albumtype}s → Singles
-
-
- 📂 Music Library Paths
+Music Library Paths
Tell SoulSync where your music files live. Required for tag writing, streaming, and file detection
@@ -5699,7 +5887,6 @@
-
@@ -5983,99 +6169,42 @@
🎵 Post-Processing
- Master toggle — disabling this skips all metadata, artwork, and lyrics processing
+
+ Master toggle — disabling this skips all metadata, artwork, and lyrics processing.
@@ -5731,11 +5919,13 @@
Use MusicBrainz Cover Art Archive for album art
- 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.
+
+ 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.
+
+ 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.
@@ -5743,7 +5933,8 @@
Match singles to their parent album
- When a track matches a single release, look up the album that contains it and tag it as that album — so every song in an album gets the same (album) cover instead of some getting the single's art. Off by default: adds an extra metadata lookup per single-matched track.
+
+ When a track matches a single release, look up the album that contains it and tag it as that album — so every song in an album gets the same (album) cover instead of some getting the single's art. Off by default: adds an extra metadata lookup per single-matched track.
- Analyzes loudness and writes ReplayGain track gain/peak tags. Requires ffmpeg. Adds a few seconds per track.
+
+ 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.
-
-
-
- Decodes every downloaded file with ffmpeg to catch fake 30s previews padded to full length and mostly-silent files — the kind whose header lies about the length so mutagen can't catch them. Off by default: this fully decodes each file, the most CPU-heavy post-processing step. Most sources (HiFi, Qobuz) already catch previews on their own, so only turn this on if you see padded/silent files slip through. Applies to all download sources.
+
+ 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.
-
-
📀 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.
-
-
-
-
-
-
-
-
▼
-
Library Preferences
- Import, content filter, playlists, stats +Listening Stats
+ Play history from your media server
-
-
-
-
-
+ 📊 Listening Stats
+
+
+
+ Polls your active media server (Plex, Jellyfin, or Navidrome) for play history
+ and displays stats on the Stats page.
- Polls your active media server (Plex, Jellyfin, or Navidrome) for play history
- and displays stats on the Stats page.
-
-
+ 🔒 Security & Access
+ +
+ ▼
+
+ Security & Access
+ PIN · user accounts · reverse proxy +
+
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.
@@ -6192,10 +6321,18 @@
-
🔍 Discovery Pool Settings
+ +
+ ▼
+
+ Discovery Pool Settings
+ Lookback & hemisphere +
+
+
-
@@ -6206,7 +6343,9 @@
-
@@ -6291,8 +6433,15 @@
+
+
Controls how far back to scan when adding new artists or refreshing discovery
pool.
Once scanned, artists are kept updated with new releases only.
@@ -6219,13 +6358,16 @@
-
+
+
+
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.
+
+
+ ▼
+ Database Settings
+ Concurrency +
+
-
+
+
@@ -6306,15 +6455,23 @@
+
- Number of parallel threads for database updates. Higher values =
- faster updates but more server load.
+ Number of parallel threads for database updates. Higher values = faster updates but more server load.
+
+
+
+ 
`
: ``
}
- ${src.name}
+ ${src.name}
${sourceLevelBadge}
${priorityNum}
+
+ ${enabled ? `` : ''}
+ ▼
+ Database Maintenance
+ Size, vacuum & cleanup +
+
-
+
+
+
+
@@ -6339,39 +6496,87 @@
+ ▼
+
+ Import
+ Folder-artist override, permanent library +
-
+ 🔞 Content Filter
+
+
+
+
+
+
+
+ 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.
+
+
+
+
+
+
+
+ Off by default. Turn this on if your Transfer folder is your
+ real, permanent library (served by Navidrome/Plex/etc.) rather than a scratch
+ drop area. A Deep Scan then never relocates files it doesn't recognize out to
+ Staging — it leaves them in place and just reports them. Even with this off, a
+ Deep Scan now refuses to move files when the database looks badly out of sync
+ with disk, as a safety guard against wiping a library (issue #904).
+
+
+ ▼
+
+ Filtering
+ Explicit content & genre whitelist +
+
diff --git a/webui/static/settings.js b/webui/static/settings.js
index f0b324e8..5902210c 100644
--- a/webui/static/settings.js
+++ b/webui/static/settings.js
@@ -40,15 +40,31 @@ async function copyAddress(address, cryptoName) {
let settingsAutoSaveTimer = null;
-// The "Only import AcoustID-verified tracks" toggle (under Quality Profile) is
-// meaningless when AcoustID itself is off — only show it when verification is on.
+// The "Only import AcoustID-verified tracks" toggle lives in Audio Verification
+// and is always shown (its help notes it needs AcoustID enabled), so users can
+// always find it. Kept as a no-op for any existing callers.
function syncAcoustidRequireVerifiedVisibility() {
const group = document.getElementById('acoustid-require-verified-group');
- const enabled = document.getElementById('acoustid-enabled');
- if (group) group.style.display = (enabled && enabled.checked) ? '' : 'none';
+ if (group) group.style.display = '';
}
window.syncAcoustidRequireVerifiedVisibility = syncAcoustidRequireVerifiedVisibility;
+// Retry Logic: the two numeric rows are only meaningful when their parent toggle
+// is on — hide them otherwise. "Retries per query" needs Exhaustive retry;
+// "Minimum matching mismatches" needs the version-mismatch fallback.
+function syncRetryConditionalRows() {
+ const pairs = [
+ ['retry-exhaustive', 'retries-per-query-row'],
+ ['accept-version-mismatch-fallback', 'version-mismatch-min-count-row'],
+ ];
+ for (const [toggleId, rowId] of pairs) {
+ const toggle = document.getElementById(toggleId);
+ const row = document.getElementById(rowId);
+ if (row) row.style.display = (toggle && toggle.checked) ? '' : 'none';
+ }
+}
+window.syncRetryConditionalRows = syncRetryConditionalRows;
+
function debouncedAutoSaveSettings() {
// Ignore changes made while the page is programmatically populating its
// fields on load — those aren't user edits and must not trigger a full
@@ -417,6 +433,11 @@ function switchSettingsTab(tab) {
if (tab === 'advanced' && typeof loadDbMaintenanceInfo === 'function') {
try { loadDbMaintenanceInfo(); } catch (e) { }
}
+ // First time the Downloads tab is shown, auto-probe source status so the
+ // dots reflect real connection state without a manual "Test all sources".
+ if (tab === 'downloads' && typeof autoTestSourcesOnce === 'function') {
+ autoTestSourcesOnce();
+ }
// Initialize live log viewer when switching to Logs tab
if (tab === 'logs') {
_logViewerInit();
@@ -659,6 +680,126 @@ const ALBUM_LEVEL_HYBRID_SOURCES = new Set(['soulseek', 'torrent', 'usenet']);
let _hybridSourceOrder = ['soulseek', 'youtube'];
let _hybridSourceEnabled = { soulseek: true, youtube: true, tidal: false, qobuz: false, hifi: false, deezer_dl: false, amazon: false, lidarr: false, soundcloud: false, torrent: false, usenet: false };
let _hybridVisualOrder = null; // Full visual order including disabled sources
+// In hybrid mode, only one source's config panel is shown at a time (clicked
+// open from its row), so the long per-source config blocks don't all stack up.
+let _expandedHybridSource = null;
+
+function toggleHybridSourceConfig(srcId) {
+ _expandedHybridSource = (_expandedHybridSource === srcId) ? null : srcId;
+ buildHybridSourceList();
+ updateDownloadSourceUI();
+ // Bring the freshly opened config panel into view.
+ if (_expandedHybridSource) {
+ const map = {
+ soulseek: 'soulseek-settings-container', youtube: 'youtube-settings-container',
+ tidal: 'tidal-download-settings-container', qobuz: 'qobuz-settings-container',
+ hifi: 'hifi-download-settings-container', deezer_dl: 'deezer-download-settings-container',
+ amazon: 'amazon-download-settings-container', lidarr: 'lidarr-download-settings-container',
+ soundcloud: 'soundcloud-download-settings-container', torrent: 'prowlarr-source-redirect',
+ usenet: 'prowlarr-source-redirect',
+ };
+ const el = document.getElementById(map[_expandedHybridSource]);
+ if (el) setTimeout(() => el.scrollIntoView({ behavior: 'smooth', block: 'nearest' }), 60);
+ }
+}
+
+// ── Per-source live connection status (shown as a dot in the hybrid list and
+// driven by the "Test all sources" button). srcId -> 'unknown'|'testing'|'ok'|'fail'|'na'
+let _hybridSourceStatus = {};
+
+async function _ssJson(url, opts) {
+ const r = await fetch(url, opts);
+ return await r.json();
+}
+function _ssTestConn(service) {
+ return _ssJson(API.testConnection || '/api/test-connection', {
+ method: 'POST', headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ service })
+ }).then(j => !!j.success);
+}
+// Each probe returns a boolean (connected/ok). Endpoints mirror the per-source
+// "Test Connection" buttons so the results match what those buttons would show.
+const HYBRID_SOURCE_PROBE = {
+ soulseek: () => _ssTestConn('soulseek'),
+ tidal: () => _ssTestConn('tidal'),
+ qobuz: () => _ssJson('/api/qobuz/auth/status').then(j => j.authenticated === true),
+ hifi: () => _ssJson('/api/hifi/status').then(j => j.available === true),
+ deezer_dl: () => _ssJson('/api/deezer-download/test').then(j => j.success === true),
+ amazon: () => _ssJson('/api/amazon/test-connection').then(j => j.connected === true),
+ lidarr: () => _ssTestConn('lidarr'),
+ soundcloud: () => _ssJson('/api/soundcloud/status').then(j => j.available === true && j.reachable === true),
+ torrent: () => _ssTestConn('torrent_client'),
+ usenet: () => _ssTestConn('usenet_client'),
+ youtube: () => Promise.resolve(true), // no auth required
+};
+// Configured metadata / server connections that support a generic test.
+const CONNECTION_TEST_SERVICES = ['spotify', 'server', 'tidal', 'qobuz', 'lastfm', 'genius', 'listenbrainz', 'acoustid', 'discogs'];
+
+async function testAllSources(opts = {}) {
+ const silent = opts.silent === true; // no toast / no connection sweep (used for auto-run on load)
+ const btn = document.getElementById('test-all-sources-btn');
+ if (btn && !silent) { btn.disabled = true; btn.dataset._label = btn.textContent; btn.textContent = 'Testing…'; }
+
+ // Which download sources to test: the enabled hybrid sources, or the single
+ // selected source in non-hybrid mode.
+ const mode = document.getElementById('download-source-mode')?.value;
+ const sources = new Set();
+ if (mode === 'hybrid') {
+ (typeof getHybridOrder === 'function' ? getHybridOrder() : []).forEach(s => sources.add(s));
+ } else if (mode) {
+ sources.add(mode);
+ }
+ if (sources.size === 0) sources.add('soulseek');
+
+ // Torrent/Usenet downloads go through Prowlarr — its connection must be
+ // established first or those source tests fail. Probe Prowlarr up front.
+ if (sources.has('torrent') || sources.has('usenet')) {
+ try { await _ssTestConn('prowlarr'); } catch (e) { /* surfaced via the per-source test below */ }
+ }
+
+ for (const id of sources) _hybridSourceStatus[id] = 'testing';
+ buildHybridSourceList();
+
+ let ok = 0, fail = 0;
+ for (const id of sources) {
+ const probe = HYBRID_SOURCE_PROBE[id];
+ if (!probe) { _hybridSourceStatus[id] = 'na'; continue; }
+ try { const good = await probe(); _hybridSourceStatus[id] = good ? 'ok' : 'fail'; good ? ok++ : fail++; }
+ catch (e) { _hybridSourceStatus[id] = 'fail'; fail++; }
+ buildHybridSourceList();
+ }
+
+ // Also test the metadata / server connections the user has configured
+ // (skipped on the silent auto-run to keep page load light).
+ let connOk = 0, connFail = 0;
+ if (!silent) {
+ try {
+ const cfg = await _ssJson('/api/settings/config-status');
+ for (const svc of CONNECTION_TEST_SERVICES) {
+ const configured = svc === 'server' ? true : (cfg && cfg[svc] && cfg[svc].configured);
+ if (!configured) continue;
+ try { const good = await _ssTestConn(svc); good ? connOk++ : connFail++; } catch (e) { connFail++; }
+ }
+ } catch (e) { /* config-status unavailable — skip connection sweep */ }
+ }
+
+ if (btn && !silent) { btn.disabled = false; btn.textContent = btn.dataset._label || 'Test all sources'; }
+ if (!silent) {
+ const parts = [`sources ${ok}✓${fail ? ' / ' + fail + '✗' : ''}`];
+ if (connOk || connFail) parts.push(`connections ${connOk}✓${connFail ? ' / ' + connFail + '✗' : ''}`);
+ showToast('Tested ' + parts.join(', '), (fail || connFail) ? 'error' : 'success');
+ }
+}
+window.testAllSources = testAllSources;
+
+// Auto-populate the source status dots once after the page settles, so they
+// reflect real state after a restart without the user having to click Test.
+let _sourcesAutoTested = false;
+function autoTestSourcesOnce() {
+ if (_sourcesAutoTested) return;
+ _sourcesAutoTested = true;
+ setTimeout(() => { try { testAllSources({ silent: true }); } catch (e) { } }, 1200);
+}
function buildHybridSourceList() {
const container = document.getElementById('hybrid-source-list');
@@ -689,11 +830,16 @@ function buildHybridSourceList() {
const sourceLevelBadge = `${sourceLevel}`;
const item = document.createElement('div');
- item.className = `hybrid-source-item${enabled ? '' : ' disabled'}`;
+ const isExpanded = enabled && _expandedHybridSource === srcId;
+ item.className = `hybrid-source-item${enabled ? '' : ' disabled'}${isExpanded ? ' config-open' : ''}`;
item.draggable = true;
item.dataset.sourceId = srcId;
+ // The name + a config chevron open this source's settings panel inline
+ // (only one at a time), so the long config blocks don't all stack up.
+ const clickConfig = enabled ? `onclick="toggleHybridSourceConfig('${srcId}')"` : '';
item.innerHTML = `
+ ⠿
@@ -702,9 +848,11 @@ function buildHybridSourceList() {
? `
+
-
+
-
-
-
-
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
- Quality filter, replace rules, folder-artist +Playlists
+ M3U export & server playlist sync
-
-
-
-
-
-
-
- 📥 Import Settings
- -
-
-
-
- On by default. SoulSync always probes each downloaded file's real audio quality; this
- toggle decides what to do with the result. On — files that don't meet your
- quality profile are quarantined instead of imported (the same gate the download pipeline
- uses; fallback/downsample settings still apply). Off — everything is
- imported regardless of quality. Either way, the library Quality Upgrade Scanner
- still flags below-profile tracks so you can act on them later.
-
-
-
-
-
-
- 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.
-
-
-
-
- Off by default. Turn this on if your Transfer folder is your
- real, permanent library (served by Navidrome/Plex/etc.) rather than a scratch
- drop area. A Deep Scan then never relocates files it doesn't recognize out to
- Staging — it leaves them in place and just reports them. Even with this off, a
- Deep Scan now refuses to move files when the database looks badly out of sync
- with disk, as a safety guard against wiping a library (issue #904).
-
-
-
- 📋 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
@@ -6483,7 +6616,8 @@
-
+
+
@@ -6495,10 +6629,18 @@
"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
+ Log level & path +
+
-
-
+
-
@@ -6508,7 +6650,8 @@
-
+
+
+
Controls the level of detail in application logs. DEBUG shows all details, INFO
shows general operations, WARNING and ERROR show only issues.
@@ -6519,10 +6662,18 @@
logs/app.log
+
+
+ ▼
+ SoulSync API
+ REST keys & inbound endpoint +
+
-
+
+ REST API Keys
@@ -6575,10 +6726,18 @@
-
@@ -6630,10 +6790,6 @@
🔧 Developer Mode
+ +
+ ▼
+
+ Developer Mode
+ Advanced log viewer +
+
+
+
@@ -6588,6 +6747,7 @@
Inactive
-
-