spotipylist

0.2.1 verified Sat May 09 auth: no python

A playlist generator for creating local playlists using Spotify curated playlists. Current version 0.2.1, supports Python >=3.6, and is maintained with occasional updates.

pip install spotipylist

Common errors

error spotipy.oauth2.SpotifyOauthError: You must set the CLIENT_ID and CLIENT_SECRET environment variables or pass them to SpotifyClientCredentials ↓

cause Missing Spotify API credentials.

fix

Set SPOTIPY_CLIENT_ID and SPOTIPY_CLIENT_SECRET environment variables or pass them to generate_playlist.

error AttributeError: 'dict' object has no attribute 'name' ↓

cause Code expecting a Playlist object but receiving a dict (pre-v0.2.0 behavior).

fix

Upgrade to v0.2.0+ and use Playlist/Song objects, or update code to access dict keys like ['name'].

Warnings

breaking v0.2.0 introduced Playlist and Song classes, replacing earlier dict-based data structures. Code relying on dict access may break. ↓

fix Update code to use Playlist and Song objects instead of dicts.

gotcha The library requires Spotify API credentials (client ID and secret). Missing credentials cause authentication failures. ↓

fix Set environment variables SPOTIPY_CLIENT_ID and SPOTIPY_CLIENT_SECRET or pass them directly.

Imports

Playlist
```
from spotipylist import Playlist
```
Playlist class available since v0.2.0
Song
```
from spotipylist import Song
```
Song class available since v0.2.0
generate_playlist
```
from spotipylist import generate_playlist
```
Top-level function for playlist generation

Quickstart

Generate a local playlist using Spotify curated playlists.

import os
from spotipylist import generate_playlist

# Set environment variables for Spotify API credentials
generate_playlist(
    spotify_client_id=os.environ.get('SPOTIPY_CLIENT_ID', ''),
    spotify_client_secret=os.environ.get('SPOTIPY_CLIENT_SECRET', ''),
    playlist_name='My Playlist',
    num_songs=20
)