Skip to content

Listening List

Mark albums and tracks as listened, with inline indicators across Spotify.

Listened badges beside each track on an album tracklist

  • Mark albums and tracks as listened via right-click context menu
  • Want-to-listen list for albums: bookmark badge until you’ve heard it, then it flips to listened automatically
  • Inline badge surfaces (tracklist rows, album page header, album cards, now-playing bar) — each toggleable
  • Auto-seed listened albums from your playlists (threshold configurable)
  • Auto-mark tracks past a play-progress threshold (threshold configurable)
  • Local-only storage; nothing leaves your machine
  • Export / import JSON
  • Built-in viewer (sortable list) and stats summary

The extension stores two LocalStorage records: your listened items and your configuration. DOM observers attach small badges to tracklist rows, album headers, album cards, and the now-playing bar based on whichever surfaces you enable.

Requires Spicetify, installed and applied at least once. The Marketplace route also needs the Spicetify Marketplace custom app.

  1. In Spotify, open Marketplace (the shopping-cart icon at the top left) and stay on the Extensions tab.
  2. Search for Listening List. If it doesn’t show up, click Load more (» at the bottom of the list) until it does. Marketplace loads extensions in batches and only searches the ones it has loaded.
  3. Hover the Listening List card, click its download button, then click Reload now.
  1. Download listening-list.js (right-click → Save link as…) into your Spicetify Extensions folder:

    • Windows: %APPDATA%\spicetify\Extensions
    • macOS / Linux: ~/.config/spicetify/Extensions
  2. Enable it and apply:

    Terminal window
    spicetify config extensions listening-list.js
    spicetify apply

Right-click any track or album → “Mark as listened”. A badge appears in enabled surfaces. Right-click an album → “Want to listen” to queue it up; it shows a bookmark badge and moves to listened once you mark it or (with auto-mark on play enabled) play enough of its tracks. Open the profile menu → “Listening List” to access Settings, the Viewer (Albums / Tracks / Want to listen), and Stats.

A marked album gets a badge on its page header:

Album page header with a listened badge at the start of the artist and release line

The Viewer lists everything you have marked, with filtering and sorting:

Viewer tab listing marked albums with artist, date listened, and source

Stats summarises totals, recent activity, and how each item got marked:

Stats tab showing totals, last 30 days, breakdown by source, and date range

Accessed via profile menu → “Listening List”. Toggle surfaces, choose badge style, enable auto-seed / auto-on-play, export/import data, clear all.

Settings tab with surface toggles, badge style, auto-seed, auto-mark, and data controls

  • Badges not appearing? Confirm the relevant surface toggle is on in Settings and reload Spotify.
  • Auto-seed fails? The Spicetify Platform API for playlists is undocumented and varies by Spotify version. Check DevTools console for the error.
  • Open DevTools: enable once via spicetify enable-devtools, then Ctrl+Shift+I inside Spotify.

MIT — see LICENSE.

Independent project. Not affiliated with or endorsed by Spotify or Spicetify.