Software Updates

See what's new, what's been fixed, and what's changed in each version of SugarSpin.

v1.3.4 Latest April 3, 2026

New Features

  • Repair All Album Tags — One button to fix your entire library. Phase 1 groups unknown tracks into albums from your folder structure. Phase 2 looks up every album on MusicBrainz and corrects the artist, title, year, and genre.
  • Smart MusicBrainz Search — Cleans messy album titles before searching. Removes file extensions, splits "Artist – Title" folder name patterns, strips edition suffixes, and uses keyword fallback when exact matches fail.
  • Smart Fix per Album — Click the gear icon on any album to preview MusicBrainz corrections before saving. Changes are preview only until you confirm.
  • Playlist Sort Toggle — Sort playlists by oldest first or newest first with one click.
  • Software Updates Page — This page! Track what's new in each version.

Bug Fixes

  • Heart (Liked) sync in play bar — The play bar heart now correctly reflects whether the current track is liked. Previously it always showed empty due to a property name mismatch between the server and the app.
  • Shuffle actually works — Shuffle now picks a random track on every skip and when songs end naturally. Previously it only shuffled the queue once and then played linearly.
  • Pause stops all audio — Pressing pause now silences both audio channels. Previously, if a crossfade was in progress, the incoming track kept playing in the background.
  • Smart Fix no longer auto-saves — Cover art and metadata changes are preview only. Nothing saves until you click "Save Changes." Clicking Cancel discards everything.
  • Fetch Missing Covers — Fixed a URL encoding bug that prevented MusicBrainz cover art downloads from working.
  • Duplicate route conflicts resolved — Several API endpoints had duplicate definitions causing save failures and missing features.

Changes

  • Shuffle simplified — Reduced from three confusing modes (Off, Standard, Smart) to a simple On/Off toggle.
  • Shuffle Mode removed from Settings — Shuffle is now controlled entirely from the play bar button.
  • Watchtower moved — Watchtower now appears at the top of the right column in Settings for easier access.
  • Repair Library — Now has its own dedicated state and progress indicator, separate from other repair tools.
  • About page rewritten — Updated with Roger's personal story in his own voice.
  • Deploy script updated — Now supports local-only deploys by default. Use --push flag to publish to Docker Hub.

Removed

  • Fix All button — Replaced by Repair All Album Tags, which uses MusicBrainz as the authority instead of blindly trusting folder names.
  • Fix Unknown Tags button — Merged into Repair All Album Tags (Phase 1 handles unknowns automatically).
v1.3.3 March 29, 2026

New Features

  • Multi-device sync — Play music from one device, control it from another. All clients stay in sync over WebSocket.
  • Audio target selection — Choose which device plays the audio. Control playback from your phone while sound comes from your desktop.
  • Album editor — Edit album title, artist, year, and genre. Upload or search for cover art from iTunes and Discogs.
  • Cover art search — Search iTunes and Discogs for album artwork directly from the album editor.
  • File watcher (Watchtower) — SugarSpin watches your music folder and automatically picks up new files.
  • Crossfade — Smoothly blend between songs with adjustable duration (0 to 15 seconds).
  • Hi-Fi mode — Bypass the equalizer for pure signal output to your DAC.
  • 15-band equalizer — Fine-tune your sound with built-in presets (Bass, Treble, Rock, Jazz, Classical, and more) or create custom EQ profiles.
  • Album EQ presets — Save EQ settings per album so they load automatically when that album plays.
  • Format-aware playback — When you have the same song in multiple formats (FLAC + MP3), choose which version plays.
  • License system — Free, Pro, and Gold tiers with offline validation.

Changes

  • Now Playing view — Full-screen experience with vinyl animation, VU meters, and spectrum visualizer.
  • Improved scanning — Faster initial library scan with better metadata extraction.
  • Responsive design — Better mobile layout for phones and tablets.
v1.0.0 March 2026

Initial Release

  • Self-hosted music streaming from your NAS or server
  • Docker-based installation with one command
  • Support for FLAC, MP3, M4A, WAV, OGG, AAC, OPUS, AIFF, APE, WV, ALAC
  • Album and artist browsing with artwork
  • Search across your entire library
  • Playlists and Liked Songs
  • Play history and listening stats
  • Works on any device with a web browser