Obsidian Spotify Link

Obsidian plugin that integrates Spotify API to insert currently playing tracks and podcasts into notes using customizable templates.

Features

  • Connect Spotify account via OAuth
  • Insert currently playing track/episode at cursor position
  • Insert any track by Spotify ID or URL (no need to be playing)
  • Create dedicated files for tracks/episodes
  • Fetch recently played tracks (current day)
  • Template support for inline and file-based templates
  • Support for both songs and podcasts
  • Customizable variable substitution system
  • Track and artist popularity scores
  • List all playlists with metadata (single file or individual files)
  • Auto-regenerate playlist notes when adding songs (opt-in)

Quick Start

  1. Create Spotify App at developer.spotify.com
  2. Configure Client ID and Secret in plugin settings
  3. Set Redirect URI to obsidian://spotify-auth/
  4. Click Spotify icon in sidebar to authenticate
  5. Use commands to insert tracks

Core Commands

Append to Current Note

  • Append Spotify currently playing track - Insert track with timestamp
  • Append Spotify currently playing track using template - Insert using custom template
  • Append Spotify currently playing episode - Insert podcast with timestamp
  • Append Spotify currently playing episode using template - Insert podcast using template
  • Append track by Spotify ID or URL using template - Insert any track by pasting its URL or ID
  • Append all playlists using template - Insert all playlists using template

Create New Files

  • Create file for currently playing track - New file with basic info
  • Create file for currently playing track using template - New file with template
  • Create file for currently playing episode - New file for podcast
  • Create file for currently playing episode using template - Template-based podcast file
  • Create file for track by Spotify ID or URL using template - New file for any track by URL or ID
  • Create file for recently played tracks using template - Daily listening history
  • Create file for all playlists using template - All playlists in one file
  • Create individual files for all playlists using template - One file per playlist (required for auto-regenerate)

Session Management

  • Refresh session - Manually refresh access token

Documentation