soulsync 3.2.2: dev → main

five features and twenty-one fixes, most of them from reports. seven community PRs merged in as well.

reassign an album to a different artist

TheHomeGuy asked for this: he had albums filed under the wrong artist, usually because a featured artist got picked up as the album artist. there was no way to move them.

⇄ Reassign now sits in the album action row next to Reorganize and Redownload (artist detail → enhanced view → expand an album). you search for the artist it should belong to, pick one of their releases, and see how your tracks line up before anything happens.

you never type an artist name, you pick a real one and then a real release of theirs. that way the identity handed to the import pipeline is one the source can actually resolve.

it doesn't retag or move anything itself. each track is staged with a hint naming the release you picked and the import pipeline re-files it, same as a single-track re-identify. tags, folder and database rows all come from the code that handles a fresh download, so there's no second version to drift.

the review screen matters because an album is many files. it shows every track, what it maps to and why (track number or title), plus anything it couldn't place. if some tracks don't line up it won't proceed without you saying so, because moving half an album leaves the rest under the old artist which is the exact thing you were trying to fix.

collapsible sidebar (#1155)

wishx runs soulsync in a narrow wavebox tab where a fixed 240px sidebar eats most of the width. one toggle in the sidebar header now shrinks it to 68px of icons, with the tab name on hover. persisted, off by default, desktop only.

collapsed, the section headers become divider lines and everything under them is shown. a chevron you can't read is a dead control — you'd click a nameless arrow, items would vanish, and nothing would tell you what you hid. your saved per-section collapse state is untouched and comes back when you expand.

prefer a specific version of a track

eN1gma: spotify often carries only the radio edit, but the extended mix is on soulseek and nothing went looking for it. Settings → Soulseek → "Prefer a version when one exists". off by default.

nothing is ever skipped. if that version isn't out there the normal one downloads exactly as before. picking live, remix, acoustic or instrumental lifts a protection that normally throws those out on sight, and the help text says so.

youtube premium quality (#1154)

lucasssvaz's PR, the biggest community one this release. youtube used to be the source that lied: flat video search has no artist/album and no formats, missing formats got invented as MP3 320, and opus bitrates showed as a dash.

• search can use the Music catalog with cookies.txt auth, so hits carry structured artist/album metadata and matching works the same shape as tidal
• downloads rank the real opus/aac formats against your quality profile. missing formats claim typical opus 160, never invented MP3 320. premium cookies unlock the premium itags (774/141) via the music player, and only a pasted cookies.txt counts — a browser cookie store is never treated as premium
• mixed best-quality pools score per source now: a soulseek peer no longer forces tidal and youtube through the P2P matcher, and a rejected youtube profile no longer wipes the rest of the pool
• opus bitrate is estimated from size/duration on import and scan, and VBR averages show as ~160 in Enhanced view instead of a dash

took a stabilization round after the merge: a config.settings import silently disabled transcode and catalog auth on a clean tree, matcher-rejected catalog hits now fall through to ytsearch, and expired cookies are only dropped on the last download retry.

remove a server playlist from the compare editor

the server tab could edit a playlist every way except delete it. a "remove from server" pill now sits next to export m3u — confirms, deletes the playlist on plex/jellyfin/navidrome (soulsync-made or not), closes the editor and drops back to the refreshed list. same id-first name-fallback shape as the rest of the edit family: plex and jellyfin delete-recreate on edit, so a stale page id gets re-resolved by name instead of 404ing with the live playlist standing.

fixes

• radio edits were being thrown away, including when you asked for one. \bedit\b lived in the remix patterns and remix was checked first, so "radio edit" classified as a remix — and remix is reject-on-sight. the file scored 0.0 and got binned even when spotify itself named the radio edit. ask for "Song - Radio Edit" now and you get it; ask for the plain version and you still get the plain version
• #1150 per-item quality profiles were ignored at the soulseek search (Zombiehamser). assigning a profile to a wishlist row changed what got ACCEPTED at import but not what got CONSIDERED at search — the filter read the app-wide default. a strict item under a loose default downloaded lossy files and only failed at the guard
• #1127 navidrome paths whose filename is synthesized (Clover-Moss). the subsonic api builds the whole path from tags, so the filename can be wrong too, not just the album folder. dead file cleaner called every file unreachable and album completeness refused to fix anything
• navidrome's verified-empty check read the wrong folder key, so it could never pass with a music folder selected
• songs stuck on "Processing", blocking everything else (Sokhi). nothing was hung. one pool of 3 threads ran both soulseek searches and post-processing, and a search holds its thread 25-60s and usually finds nothing. a finished download queued behind them while showing "Processing" — his log has one waiting 52 seconds for 3 seconds of work. post-processing has its own pool now. measured 33.6s → 0.0s
• "Concurrent Downloads" did nothing above 3. the setting offers up to 10 and is a per-batch limit, but the worker pool was hardwired to 3, so seven of ten workers just sat in a queue while the help text promised a speedup. it's sized from the setting now (takes a restart)
• a batch wedged in post-processing had no rescue. the 30-minute timeout only ran when the batch had orphaned tasks, and a batch whose remaining tracks are all post-processing produces none. it held its slots forever
• the album stall-guard left zombie transfers in slskd (sassmastawillis). marking a stalled transfer failed only resolved our bundle — slskd kept the enqueue alive, so the file sat at "queued, remotely" for hours after the guard said it was handled, and a retry picking the same peer+file collided with the zombie instead of issuing a fresh request. the guard now cancels and removes each stalled transfer, same as the monitor's retry path
• quality quarantine wedged the task in Processing (Sokhi again). the verification wrapper pops the task id out of the context before the inner pipeline runs, so the quarantine branch's requeue and failed-marking always saw task_id=None and silently did nothing. the task then sat in post_processing until stuck detection reaped it at 30 minutes — one wedged download slot per quarantined file, 8x in one log
• the whole download subsystem logged nowhere app.log could see. twelve modules named their logger outside the hierarchy the file handler is attached to, so every completion check and stuck-task decision was invisible in the debug export users paste into issues. we were diagnosing Sokhi's stall half blind. 49 modules elsewhere are still silent
• #1157 deezer genres came back in the server's language (PfannkuchenWolf). deezer localises genre names by the caller's IP, so a german-hosted server got "Filme/Videospiele" instead of "Films/Games". one library ended up with both spellings and strict genre filtering matched neither. auditing the fallback map against the live list also turned up genre 464 filed as "Rap" when it is Metal
• deezer playlists always said NEVER SYNCED (TheHomeGuy). the endpoint returned a hardcoded literal — the field matched spotify's shape but never carried a value. sync ran, tracks downloaded, the card never updated
• loading a big deezer playlist looked broken (TheHomeGuy). "seems to hang... sit here for several minutes doing nothing". a 1200-track playlist resolves ~900 albums for release dates and real track numbers, and the spinner said nothing. that work can't go away — it's what the download picker uses to choose and verify a candidate — so it narrates now: "release dates 340/877 (39%)"
• every deezer caller now shares one rate budget. there were three numbers and none agreed: a decorator enforcing 1/s on nine methods, two playlist loops obeying nothing and counted by nothing, and an undocumented ceiling. eleven bypassing call sites found, all routed through one throttle at 8/s
• #1159 tracks with punctuation were unfindable in the manual-match search (AfonsoG6). the fuzzy fallback split on whitespace only, so "Would've, Could've, Should've" asked the database for %would've,% — matching only a title that has the comma too. a file tagged without them matched one word and ranked third behind unrelated songs
• the other four [#1159] issues, same report (AfonsoG6). cached auto-matches pinned the compare view and shadowed a saved manual match; replace-track didn't persist the pairing, so a corrected bad match reverted on the next compare; jellyfin edits 404'd on stale playlist ids where plex re-resolved by name; and jellyfin thumbs came from a raw unauthenticated url that answered 200 with an empty body — they go through the token-safe image proxy now. all five items in that report are closed
• #1151 a slow prowlarr indexer threw away everyone else's results (Zombiehamser). one search listing every indexer meant a single slow one held the reply past the 75s timeout, and a timed out request returns nothing. it's one request per indexer now, run together, and you keep whatever comes back
• #1091 folders differing only in capitalization made two albums (TomOdellSheetMusic). on linux you got two real folders and jellyfin showed the album twice; on windows and mac the recorded path didn't match the disk
• quality check upgrades always failed with "no matched track in finding" (Lil-Uzi-Chimp and one other). the fix handler was gated on an entity id the scanner never records for an unmatched file, so it never read the finding's own details
• "replace the original file" did nothing on a manual import (Urethra Franklin). the hint was only ever read by the auto-import worker
• recently played showed 12 tracks and neither dashboard rail updated without a reload. 25 now, both refresh on a timer

community PRs

• #1158 gradual file_path corruption during library scans (shkarlsson). when the subsonic api omits path, the code fabricated a bare filename and the UPDATE overwrote the real one — while every other nullable column was COALESCE-guarded. both halves were needed: the fabricated value is non-null, so COALESCE alone couldn't see it
• #1160 a stale wing-it flag is not an unresolved guess (nstrelow). the flag is only ever set, so a track that wing-it'd once and matched properly later carried it forever. 317 of 445 rows in the pool were already resolved
• #1162 canonicalize youtube titles before matching, not only after (nstrelow). youtube music restates a localized title in latin next to the original, and providers index only the plain form — so the raw string searched for nothing. 29 of 69 wing-it stubs resolve at confidence 1.00
• #1161 resolve artist aliases before giving up on a track (nstrelow). "mgk" and "Machine Gun Kelly" share no substring, so a title matching at 1.00 was discarded on the 0.5 artist-similarity floor and written off as a wing-it stub. on a miss, discovery now asks musicbrainz for the artist's aliases and retries under each — machinery [#442] already built, never offered to discovery. six sampled mgk tracks go 0.00 → 0.99, and 25 of one playlist's 77 stubs were a single artist alias
• #1147 optionally search unverified Wing It guesses (nstrelow). his install had 185 stubs across 22 playlists and 77 were findable at the provider — guesses, but mostly right ones. new setting, off by default; a stub the source left nameless stays out either way. follow-up rounds closed the wing-it batch paths that bypassed the gate and a retry-stamp gap that kept a failed stub at retry_count 0 forever
• #1163 the download query ladder gets a version-stripped last resort (nstrelow). every rung preserved the edition suffix, so "Sweet Dreams [2005 Remaster]" with no peer carrying that exact edition never resolved at all. a stripped query now sits at the END of the ladder, and it strips edition words only — never live/remix/acoustic — so it can change which pressing you get, never which take. measured against the real network: 5 of 11 stuck edition-decorated wishlist tracks rescued at 0.91+
• #1154 youtube premium quality (lucasssvaz) has its own section up top

tested

full backend suite green, ruff clean, frontend 1,656 tests across the sync routes, bundle builds. each fix since that run landed with its own targeted tests; worth one more full-suite pass on the final head before merging.

two caveats worth carrying:

#1151 is still inference. every test stubs the http layer, so prowlarr's real behaviour under a hung indexer is unverified. worth confirming with the reporter before closing.

#1154's premium path rests on one account. the format ranking and catalog auth are covered by tests, but the premium itags (774/141) only exist for a premium subscriber — that leg is verified on lucasssvaz's install, not reproduced here.