README file from
GithubObsidian 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
- Go to developer.spotify.com/dashboard and create an app (or use an existing one).
- In the app settings, add
obsidian://spotify-authas a Redirect URI and save. - 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
-
Download
main.js,manifest.json, andstyles.cssfrom the latest release. -
Copy them into your vault's plugin folder:
<your-vault>/.obsidian/plugins/spotify-sorter/ ├── main.js ├── manifest.json └── styles.css -
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.