Playlist Repair

for Spotify

Finds the greyed-out tracks in your Spotify playlists, matches each one to a playable version of the same recording, and swaps the matches in after you approve them.

View on GitHub Setup guide

Open source. Runs on your own computer today: there is no hosted version yet. How to run it.

See it work

How it works

  1. Scan

    Pick a playlist you own. A window lists its broken tracks and its local files, and says why each one is a problem.

  2. Review matches, grouped by confidence

    Choose Find fixes. The app says how many requests that will take before it sends any, then searches for a playable version of each track, starting with the recording's ISRC. Each match lands in one of four groups:

    Exact
    Same ISRC, duration within 2 seconds, same explicit flag. Ticked for you.
    High
    A strong score with a close duration, and the same version and explicit flag. Ticked for you.
    Review
    A fair match, or one held back because the version or explicit flag differs. A live or remix version never reaches the ticked groups for a studio original. Not ticked.
    None
    Nothing scores well enough. The track is left in place.
  3. Approve in bulk

    Each row shows the broken track beside its proposed replacement, with the differences marked. Tick a whole group or single rows, and pick a different candidate where the first is wrong.

  4. Apply

    Only now does anything change. The app backs up the playlist, inserts the replacements, removes the broken tracks, and checks the result.

Why it’s safe

One thing does change: replacements get today’s date as their “date added”. The backup file keeps the original dates.

Local files

Playlist Repair can replace local files with streaming versions, with limits:

Get started

Playlist Repair runs locally today. A hosted version isn’t available.

Spotify’s development mode allows at most 5 users per app and needs Premium for the owner, so one shared client ID cannot serve everyone. Each person creates their own Spotify app and pastes in its client ID, which is not a secret. Only playlists you own are listed.

  1. Follow the setup guide to create a Spotify app and copy its client ID. It takes about five minutes and is done once.
  2. Get the code from GitHub. You need Node.js 24 or later. Then run:
    npm install
    npm run dev
  3. Open http://127.0.0.1:5173/, not localhost, paste the client ID, and log in.

The README has the full run steps.