Obsidian 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:

Setting	Description
Client ID	From your Spotify Developer Dashboard app
Client Secret	From your Spotify Developer Dashboard app
Redirect URI	Must match the Redirect URI in your Spotify app settings (default: obsidian://spotify-auth)
Output folder	Vault folder to save reports in — leave blank for the vault root

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.