v1.4.0 — Sort by

New

• Sort by control inside a collection: date added (oldest/newest), name A–Z / Z–A, artist or creator A–Z / Z–A, release date (newest/oldest), genre A–Z, and type (albums first). Choice is remembered across sessions.
• Metadata fetch now also captures artist, release date, genre (album genre → primary-artist genre fallback) and type, so the new sort keys work.
• In-app version badge next to the Collections title so you can tell at a glance whether you're up to date.

Both the one-click extension build and the custom-app build are updated.

Updating

Re-running the installer is the update — it overwrites with the latest main and re-applies. Marketplace users: remove + reinstall. Your saved collections are untouched.

v1.3.0 — One-click Marketplace extension + terminal one-liner

Now installable without GitHub or a download — two ways added.

One-click from Marketplace

Search "Collections" in Spicetify Marketplace:

• Collections (Extensions tab) — real one-click Install. UI opens as a full-screen overlay from the Collections button in Your Library (Esc / back closes it).
• Collections (custom app) (Apps tab) — the dedicated sidebar tab/page (browse-only in Marketplace; use an installer).

Both builds share the same saved data.

One-line terminal install

macOS / Linux:

bash <(curl -fsSL https://raw.githubusercontent.com/fletcherholt/album-collections/main/install-remote.sh)

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/fletcherholt/album-collections/main/install-remote.ps1 | iex

Also in the zip

Per-OS installers (install.command/.sh/.bat+.ps1), the custom app, and the standalone collections.js extension.

v1.2.0 — Windows & Linux installers

The custom app already runs anywhere Spicetify does — this release makes the one-click installer cross-platform.

Installers

• macOS — install.command (double-click)
• Windows — install.bat (double-click; runs install.ps1, finds Spotify/Spicetify under %APPDATA%/%LOCALAPPDATA%)
• Linux — install.sh (chmod +x install.sh && ./install.sh; resolves XDG_CONFIG_HOME/~/.config/spicetify)

Matching uninstall.* for each. All do the same thing: copy the app into Spicetify's CustomApps, register it, and run spicetify apply.

Notes

• Use the desktop Spotify build — the Microsoft Store version can't be patched by Spicetify.
• Flatpak/Snap Spotify on Linux may need its path set once; the script points to the Spicetify Linux docs if apply fails.

Download Collections-for-Spotify.zip, unzip, run the installer for your OS.

v1.1.0 — Library button, fixed art & navigation

Bug-fix + integration release.

Fixed

• Album/playlist art + name now load. Metadata falls back from the Web API to the auth-free oEmbed endpoint, so covers/titles resolve even on clients where CosmosAsync Web API is broken (spicetify/cli#1735).
• Back/forward work. Collection views are now real routes (?c=<id>) instead of internal state, so Spotify's nav buttons and re-entering the app behave correctly. Removed a setState-during-render bug that made buttons flaky.
• Sidebar icon no longer tiny — it now fills its slot.

New

• Collections button is pinned in "Your Library" (next to your playlists/albums), injected and kept in place via a MutationObserver and styled to match the native rows. The top-nav icon remains too.

Install

Download Collections-for-Spotify.zip, unzip, double-click install.command (right-click → Open if macOS blocks it). Already installed? Re-run it or spicetify apply to update.

v1.0.0 — Collections for Spotify (macOS)

Group albums and playlists into named collections that live in their own sidebar tab in Spotify — without dumping every track into one big playlist. Each item stays separate and clickable.

Install (run once)

1. Have Spotify desktop (direct .dmg, not the App Store build) and Spicetify installed.
2. Download Collections-for-Spotify.zip below, unzip, and double-click install.command.
   • If macOS blocks it: right-click → Open → Open.
3. Spotify relaunches with a Collections tab in the left sidebar.

Use

• Right-click any album or playlist → Add to collection.
• Open the Collections tab → click a collection → grid of covers → click a cover to open it.
• Hover an item → ✕ removes it from the collection (your library is untouched).

Uninstall

Double-click uninstall.command.

The installer (install.command) is bundled in the zip alongside the app.