Arguments

Create a Spotify playlist based on free-text criteria.

Usage: /spotify-playlist [description of what you want]

Examples:

• /spotify-playlist jazz flute instrumentals for deep work
• /spotify-playlist modern covers of traditional Christmas hymns
• /spotify-playlist upbeat 90s hip hop for morning energy
• /spotify-playlist melancholy piano pieces for a rainy evening

Arguments

$ARGUMENTS - Free text describing the desired playlist mood, genre, era, instruments, artists, or vibe.

How It Works

1. Interpret the user's free-text criteria
2. Generate 15-25 search queries targeting specific tracks/artists that fit
3. Use the Spotify API to search and collect track URIs
4. Create a named playlist and add all found tracks
5. Open the playlist in Spotify

Spotify Authentication

Read credentials from the user's .env file (path configured in ~/.spotify-mood/config.json):

• SPOTIFY_CLIENT_ID → set as SPOTIPY_CLIENT_ID
• SPOTIFY_CLIENT_SECRET → set as SPOTIPY_CLIENT_SECRET
• SPOTIFY_REDIRECT_URI → set as SPOTIPY_REDIRECT_URI

Token cache: ~/.spotify-mood/.spotify_cache

Requires Python package spotipy. If not available, install via:

uv pip install spotipy

Implementation

Write a Python script that:

1. Authenticates via SpotifyOAuth with scopes playlist-modify-public playlist-modify-private
2. Gets the current user ID
3. Based on the user's criteria, generates search queries. Think creatively:
   • Include specific well-known artists in the genre
   • Mix iconic tracks with deep cuts
   • Include related genres and adjacent artists
   • Consider era, mood, instrumentation, tempo
4. Searches Spotify for each query (sp.search(q=..., type="track", limit=3))
5. Deduplicates by track URI
6. Creates a private playlist with a descriptive name (under 40 chars) and description
7. Adds all found tracks
8. Prints the playlist URL and opens it

Playlist Naming

Generate a short, evocative name from the criteria:

• "jazz flute instrumentals for deep work" → "Jazz Flute Focus"
• "melancholy piano for a rainy evening" → "Rainy Evening Piano"

Output

Created: "Playlist Name" — XX tracks
URL: https://open.spotify.com/playlist/...