v1.8.2 - Track Name Resolution Fix

v1.8.2

Fixes playlist names for selected songs whose metadata is not already available from the active player.

Fixed

• Retries exact-track metadata through Spotify search when the direct lookup fails
• Matches the returned Spotify track ID before using its title
• Prevents misleading Similar to - My Mix playlists
• Shows a clear error if Spotify cannot resolve the selected song title at all

Validation

• TypeScript typecheck
• 9 automated tests, including the off-player metadata regression
• Release bundle build

v1.8.1 - Similar Playlist Playback Fix

v1.8.1

This patch completes the v1.8 playlist playback flow:

• Keeps Shuffle Similar disabled after creating and playing a permanent similar-song playlist
• Releases the native-shuffle guard when playlist playback begins
• Keeps the playbar toggle visually synchronized with the ended recommendation session

Includes all v1.8.0 features: automatic skip learning, playlist-wide recommendation scoring, improved artist diversity, and Create Similar Playlist.

Validated with TypeScript, 8 automated tests, release bundle generation, and local Spicetify application.

v1.8.0 - Automatic Learning and Similar Playlists

What's new

• Create Similar Playlist from a track, album, artist, or playlist, then immediately play the new playlist
• Automatic session-based learning from early skips
• Playlist-wide acoustic and affinity scoring with stronger artist diversity
• Expanded recommendation sourcing and larger default batches
• Deterministic recommendation and Spotify playlist regression tests

Fixes

• Use Spotify Desktop's playlist APIs correctly, including preserving their required receiver context
• Playlist creation no longer activates or leaves behind the automatic Shuffle Similar queue
• Guard weighted selection and popularity scoring against invalid numeric values

Install

Download shuffle-similar.js below, copy it into your Spicetify Extensions folder, and run spicetify apply. Marketplace users receive the updated root manifest and bundle automatically.

Validation

• TypeScript typecheck
• 8 automated tests
• Release bundle build
• Manifest validation

v1.6.0

Shuffle Similar v1.6.0 with Soundtrack & Instrumental filtering

v1.5.0

Implements soundtrack & instrumental filtering to prevent soundtrack leakage and unwanted instrumentals on vocal sessions.

v1.4.0: Enhanced Similarity & Discovery Mode

This release introduces a new granular Discovery depth mode, personal top track penalties, cross-device recently-played history integration, and smart search offsets to improve autoplay diversity and similarity.

v1.0.0

Initial Re-Release to Shuffle Similar

Added

• Shuffle Similar Context Menu - support for tracks, albums, playlists, and artists
• Dedicated Playbar Button - separate toggle with native shuffle blocking
• Progressive Shuffle - plays similar songs first, then progressively blends in library or playlist tracks
• Variety Controls - artist spacing, era window constraints, and recent-play deprioritization to avoid repeating tracks
• Flexible Settings - customize queue size, refill threshold, and audio feature matching weights
• Large Collection Support - handles playlists up to 2,000 tracks with multi-seed recommendation sampling

Features

• Shuffle Similar context menu on tracks, albums, playlists, and artists
• Dedicated playbar button for Shuffle Similar (separate from Spotify shuffle)
• Native shuffle is blocked while Shuffle Similar is active
• Progressive blend curve: similar tracks first, library/playlists later
• True shuffle with artist spacing and recent-play deprioritization
• Settings for era window, queue size, refill threshold, and more

Usage

1. Right-click a track, album, playlist, or artist and choose Shuffle Similar
2. Or click the Shuffle Similar button (left of Spotify shuffle) in the playbar: first click enables, second reshuffles (hover shows refresh), third turns off
3. While Shuffle Similar is on, Spotify's built-in shuffle is greyed out and unclickable
4. Open Profile menu (top right icon) → Shuffle Similar to adjust settings