Spotify Sorter

An Obsidian plugin that finds Liked Songs in your Spotify library that aren't in any of your playlists, then saves them as a note in your vault.

Desktop only — the Obsidian mobile app is not supported.

Prerequisites

• A Spotify Developer account with an app configured

Spotify App Setup

1. Go to developer.spotify.com/dashboard and create an app (or use an existing one).
2. In the app settings, add obsidian://spotify-auth as a Redirect URI and save.
3. Copy your Client ID and Client Secret — you'll paste these into the plugin settings.

Installing into Obsidian

From the community plugin browser (recommended)

Search for Spotify Sorter in Settings → Community plugins → Browse.

Manual installation

1. Download main.js, manifest.json, and styles.css from the latest release.

2. Copy them into your vault's plugin folder:

   <your-vault>/.obsidian/plugins/spotify-sorter/
   ├── main.js
   ├── manifest.json
   └── styles.css
   

3. In Obsidian, go to Settings → Community plugins, disable Safe mode if prompted, and enable Spotify Sorter.

Configuration

Open Settings → Spotify Sorter and fill in:

Usage

Run "Find unorganized Spotify tracks" from the command palette (Ctrl/Cmd+P), or click the music note icon in the ribbon.

First run: your browser will open to Spotify's authorization page. Grant access, then return to Obsidian — the plugin captures the OAuth callback automatically via the obsidian://spotify-auth URI.

Subsequent runs: the saved refresh token is reused silently; no browser step needed. Use the Clear tokens button in settings to force re-authentication.

The plugin creates (or overwrites) a note named Spotify Unorganized Tracks YYYY-MM-DD.md in your configured output folder, listing every liked song that isn't in any playlist with clickable Spotify links.

Building from source

npm install
npm run build   # produces main.js

Use npm run dev for watch mode during development.

License

Licensed under the Apache License 2.0.