Sort-Play: The Ultimate Spotify Toolkit

A Spicetify extension that adds powerful sorting, filtering, UI features, and more to the Spotify desktop client.

⚡️ Features • 📷 Screenshots • 🛠️ Installation

⚡️ Features

➕ Comprehensive Sorting - Sort by play count, scrobbles, release date, audio features, and more.

Sort playlists, albums, and artist pages by a wide range of metrics.

• Global Play Count: The track's total play count on Spotify.
• Popularity: Spotify's internal 0-100 popularity index.
• Release Date: The track's official album release date.
• True Release Date: The track's actual historical debut. Automatically bypasses later re-issues, compilations, and remasters to find the original release date, while preserving accurate dates for live tracks and remixes.
• Last.fm Scrobbles: The track's total global scrobbles on Last.fm.
• My Scrobbles: Your personal scrobble count for each track (requires Last.fm username).
• Scrobble Range: Your personal scrobbles within a specific custom date range (requires Last.fm username).
• Last Scrobbled: The date you personally last scrobbled a track (requires Last.fm username).
• Taste Match: Sorts tracks by how well they align with your unique listening history and personal taste profile.
• Energy Wave: Creates a dynamic listening journey by arranging tracks to smoothly transition through different energy levels and moods.
• Album Color: The dominant color of the album artwork, with modes for perceptual grouping or a pure hue gradient.
• Audio Features:
  • Tempo (BPM): The speed of the track measured in beats per minute.
  • Energy: The intensity and activity level of the track.
  • Danceability: How suitable a track is for dancing based on rhythm and beat strength.
  • Valence: The musical positivity conveyed by a track (happy vs. sad).
  • Acousticness: The likelihood that a track was recorded with acoustic instruments.
  • Instrumentalness: The amount of vocals present (higher values indicate more instrumental tracks).

➕ Quick Filters - Instantly filter by liked status, followed artists, release type, and more.

Apply instant filters to your current view without opening complex menus.

• Remove Duplicates: Instantly identify and remove duplicate tracks from the current list.
• One Track per Artist: Keep only a single track for each unique artist, automatically prioritizing the most played or most popular track.
• Liked Status:
  • Remove Liked: Remove tracks you have already saved to your library (uses intelligent ISRC matching).
  • Liked Only: Filter the list to show only the tracks you have saved.
• Followed Artists:
  • Followed (Main/Any): Keep tracks where you follow the primary artist or any credited artist.
  • Not Followed: Remove tracks by artists you already follow to find new music.
• Release Type: Isolate specific release formats. Options include Albums, EPs, Singles, Compilations, and various combinations (e.g., "Albums & EPs").
• Remove Trashed: Instantly remove songs you've banned using the Trashbin extension.
• Exclude via Playlist: Filter out tracks that already exist in another playlist of your choice.

➕ Extra Data Columns - Add play count, BPM, scrobbles, and more as columns in your views.

Enhance your music views with more information.

• Playlist Columns: Add up to two extra data columns to any playlist view.
• Album & Artist Columns: Add one extra data column to album and artist pages.
• Data Types: Display Play Count, Release Date, Scrobbles, My Scrobbles, Last Scrobbled, Key, BPM, Popularity, Energy, Danceability, Valence and DJ Info (Key + BPM + Energy).
• Custom Formatting: Configure the format for release dates and how your personal scrobbles are displayed (number vs. checkmark).
• Quick Column Switching: Click the header of any extra column to instantly switch its data type.

➕ UI & Enhancements - Genre tags, now playing data, old like button, and other tweaks.

• Old Like Button: Brings back the heart (♥) icon for liking songs in track lists, the player bar, and Now Playing sidebar.
• Interactive Genre Tags: Displays clickable tags on the Now Playing bar and Artist pages linking to EveryNoise.
• Now Playing Data: Display extra track info like Release Date, Play Count, and BPM directly in the player bar.
• Configurable Sorting: Easily toggle ascending/descending order for all applicable sort types.
• Last.fm Overrides Manager: Manually fix mismatched Last.fm links, complete with JSON import/export for backups.
• Live Chat: Access a live chat panel directly within the settings to talk with other Sort-Play users.

➕ Context Menus - Powerful right-click actions for tracks, artists, and playlists.

Access tools directly from Spotify's native right-click menus.

• Track Menu: Show Genres: Instantly view detailed, multi-source genre tags for any track in a popup window.
• Track Menu: Last.fm Details: View Last.fm listeners, scrobbles, track tags, and Shoutbox comments directly inside Spotify.
• Artist Menu: Last.fm Details: View global listeners, total scrobbles, and top community tags for any artist.
• Artist Menu: Create Discography: Generate a fully sorted and deduplicated discography playlist right from an artist's context menu.
• All Menus: Shuffle & Play: Instantly shuffle and play any playlist, album, or artist (with optional Vibe & Flow) directly from the right-click menu.

➕ Full Artist Discography - Automatically load and sort an artist's entire catalog.

Apply any sort or filter option while on an Artist page to automatically fetch and process their complete discography.

• Complete Collection: Instantly gathers tracks from all albums, singles, compilations, and "Appears On" releases during the sort process.
• Intelligent Deduplication: Automatically cleans up duplicate tracks with customizable modes in Settings:
  • Default: Keeps the most popular version (or the Album version if sorting by Release Date).
  • Keep Single & Album: Retains both the single/EP version and the album version of a song.
  • One Per Release: Retains one track per uniquely named release.
  • Don't Remove: Keeps all duplicates for a 100% complete collection.

(Note: Compilation versions are always removed if an original version exists, keeping your list clean).

➕ Smart Shuffle & Flow - Artist-aware shuffle with optional energy-based flow.

Randomize your listening with advanced options.

• Intelligent Shuffle: Prevents multiple songs by the same artist from playing back-to-back for a more varied listening session.
• Vibe & Flow Shuffle: An optional mode that creates a dynamic listening journey by arranging shuffled tracks based on their energy and mood.

➕ Dedicated Playlist Creation - Generate top tracks, new releases, discovery mixes, and more.

Generate a variety of curated playlists with a single click.

• Available Playlist Types:
  • My Top Tracks: Create playlists of your most-played tracks from the "Last Month," "Last 6 Months," or "All Time."
  • New Releases from Followed Artists: A full playlist in order of release of all new singles and album tracks from every artist you follow.
  • Discovery Mixes:
    • Recent Taste: Recommendations based on your recent listening habits.
    • All-Time Taste: Recommendations based on your long-term listening history.
    • Pure Discovery: Recommendations exclusively from artists completely new to your listening history.
  • Genre Exploration:
    • Random Genre Explorer: Get a mix from a random selection of 20 genres from across Spotify.
  • Last.fm Generators:
    • Infinite Vibe: A continuous mood generated from your current track, recent obsessions, and library deep cuts.
    • Tastemaker Profile: Enter a Last.fm username to clone their top tracks, loved tracks, and obsessions into a fresh discovery playlist.
    • Neighbors Mix: A balanced mix of obsessions, trends, and favorites from your Last.fm neighbors, filtered for discovery.
• Automated Updates: Schedule your dedicated playlists to update automatically (e.g., daily, weekly on Fridays) to always keep them fresh.
• Customizable Limits: Configure the size of your Top Tracks and Discovery playlists, the time window for New Releases, and the number of tracks to pull from each new album.

➕ Dynamic Playlists - Build self-updating playlists with custom sources, filters, and schedules.

Build powerful, self-updating playlists that manage themselves.

• Multi-Source: Combine tracks from any number of playlists, artists, albums, folders, or your Liked Songs.
• Automated Scheduling: Set a custom schedule (e.g., every 3 hours, daily, weekly on Fridays) for automatic updates.
• Advanced Filtering: Automatically filter tracks based on rules:
  • Exclude songs you have already liked.
  • Exclude songs you have already listened to (via Last.fm scrobbles).
  • Filter by Genre: Include or exclude specific genres.
  • Exclude songs based on keywords or a maximum play count.
• Flexible Update Modes:
  • Replace: Overwrites all tracks in the playlist with fresh ones on each update.
  • Merge: Adds new tracks to the existing ones and re-sorts the entire playlist.
  • Append: Adds new tracks to the top of the playlist without removing old ones.
• Track Sampling (optional): Limit the number of random tracks pulled from each source on every update to keep the playlist fresh and varied.

➕ Playlist Analyzer - Get visual insights and charts for your current view.

Generate a dashboard of the current tracklist (Playlist/Artist/Album) with visual insights and charts.

• Top Artists, Albums & Genres: Explore interactive Treemaps showcasing the most prominent artists and albums, alongside genre distributions.
• Quick Stats: View metrics like total duration, average popularity, and total/median streams.
• Timeline & Eras: See when the tracks were released using a Release Year Bar Chart, or use the Decades Analysis to see the defining eras (e.g., 80s, 90s, 00s) of the list.
• Vibe Map (Mood Analysis): View the emotional tone of the tracks via a categorized Mood Ring, or explore the interactive Heatmap that maps track density based on Positivity (Valence) vs. Intensity (Energy).
• Audio Profile & Musicality: View the Tempo (BPM) distribution, Top Musical Keys displayed on an interactive Camelot Wheel, and a Radar Chart breaking down acousticness, danceability, energy, and more.
• Setting Predictor: Predicts the ideal time of day and weather (e.g., "Late Night", "Sunny & Clear") for the current tracklist based on its audio features.

➕ Vibe Filter - Filter tracks by mood using an interactive grid or mixer.

Analyze and filter tracks based on their raw emotional tone and audio features.

• Grid Mode: Select multiple vibes (e.g., Upbeat, Chill, Focus) to easily filter and include tracks that match any of the selected moods.
• Mixer Mode: Act like a DJ by dialing in exact percentages for each vibe to craft the perfect blended playlist.
• Match Strictness: Choose between Broad, Balanced, or Strict match levels to control how closely tracks must fit your chosen vibes.

➕ Advanced Custom Filter - Filter by keywords, range sliders, and preview results in an interactive table.

A powerful modal to meticulously filter any playlist or discography.

• Keyword Filtering: Use keywords to filter by track title, album, and artist, with options to keep or exclude matches and match whole words.
• Range Sliders: Apply precise range sliders for attributes like Release Date, Duration, Play Count, Popularity, and Audio Features.
• Interactive Table: View, sort, and manually remove tracks from your filtered selection in a detailed table before creating the playlist.
• Save & Load Keywords: Save your favorite keyword sets into named groups and load them instantly for future use.
• Integrated Mini-Player: Preview and listen to tracks directly within the filter modal to help make your selections.

➕ Genre Filtering - Filter by genre using multi-source data from Spotify, Last.fm, and Deezer.

Filter any playlist or discography by genre with a powerful, interactive modal.

• Multi-Source Data: Uses lightning-fast Spotify Track genres by default, with optional toggles to use genre data from Last.fm and Deezer.
• Cloud Caching: Uses a smart, community-driven database. Once a track is processed by any user, its genres load instantly for everyone else.
• Intelligent Mapping: Automatically groups hundreds of specific sub-genres into broader, easy-to-understand main genres.
• Include & Exclude Modes: Offers dual-action filtering to include genres (left-click) or exclude them (right-click).
• Intuitive Interface: Easily browse, search, and select genres, complete with track counts for each genre and a "select all" option.
• Match All Option: An advanced setting to only include tracks that match all of your selected genres instead of just any.
• Sort Your Selection: Choose how to sort the final filtered playlist, whether by play count, release date, or shuffle.

➕ AI Pick - Filter tracks using natural language prompts with Google Gemini.

Use AI to select specific songs from your current list based on your prompt.

• Context-Aware: Picks tracks directly from the current playlist, album, or artist page.
• Powered by Gemini: Utilizes Google's Gemini models for intelligent track selection.
• Customizable Instructions: Edit the AI's system instructions to fine-tune its behavior.
• Advanced Controls: Choose models and toggle data sources like song statistics and lyrics.
• Use Your Own Key: Provide your own free Google Gemini API key for extended usage.
• Prompt Library & History: Save your favorite AI prompts as presets and easily access your recent prompt history.

➕ Local File Integration - Convert local files to Spotify tracks for sorting and streaming.

• Automatic Sorting Integration: Converts local tracks in playlists to their Spotify versions on-the-fly when sorting or filtering.
• Dedicated Conversion Tool: Convert your entire 'Local Files' library into a new, streamable Spotify playlist.
• Detailed Report: After converting your Local Files, view a report of which tracks were found and which couldn't be matched.
• Export Report: Download the detailed conversion report as a JSON file for your records.

➕ Flexible Output Options - Save, overwrite, queue, or customize how results are handled.

Choose what happens after sorting and how your library is managed.

• Save as New Playlist: Create a brand new playlist with the sorted tracks.
• Modify Current Playlist: Directly overwrite your own playlist with the sorted version.
• Add to Queue: Send the sorted tracks directly to your playback queue.
• Playlist Organization: Automatically organizes all created playlists into a dedicated "Sort-Play Library" folder.
• Open After Sorting: Automatically navigate to the new or modified playlist once the process is complete.
• Deduplication Report: View a detailed list of all tracks removed during the deduplication process.
• Playlist Privacy: Configure all newly created playlists to be private by default.
• Automatic Titling: Choose whether to automatically append the sort type (e.g., (PlayCount)) to the playlist title.

📷 Screenshots

Sorting Interface	Extra Columns
Playlist Analyzer	Vibe Filter
Dynamic Playlists	Dedicated Playlists
Genre Filtering	Custom Filters
Now Playing Genre & Data	AI Pick
Last.fm Details	Settings

🛠️ Installation

Using Marketplace

1. Ensure you have Spicetify and Spicetify Marketplace installed.
2. Open the Spicetify Marketplace.
3. Search for Sort-Play.
4. Click Install.

Manual Installation

1. Ensure that Spicetify is installed on your system.

2. Copy the sort-play-loader.mjs file to the Spicetify Extensions folder:

   • Windows: %appdata%\spicetify\Extensions
   • Linux & macOS: ~/.config/spicetify/Extensions

3. Open a terminal and run the following commands:

   spicetify config extensions sort-play-loader.mjs
   spicetify apply