Registry / crm-productivity / spotify-utils

spotify-utils

library2.0.1pypypiunverified

A CLI and TUI tool for various Spotify utility tasks like playlist management, export, and import. Current version 2.0.1, released Sep 2025. Active development with frequent minor releases.

crm-productivity data

pip install spotify-utils

github ↗package ↗

INSTALL

IMPORT

SIG · SPOTIFY-UTILS

spotify-utils

crm-productivitypythonv2.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SpotifyClient

✓ from spotify_utils import SpotifyClient

✗ from spotify_utils import SpotifyClient

Initialize client with Spotify OAuth credentials and fetch playlists.

from spotify_utils import SpotifyClient import os client = SpotifyClient( client_id=os.environ.get('SPOTIFY_CLIENT_ID', ''), client_secret=os.environ.get('SPOTIFY_CLIENT_SECRET', ''), redirect_uri=os.environ.get('SPOTIFY_REDIRECT_URI', 'http://localhost:8888/callback') ) # List first 10 playlists playlists = client.get_playlists(limit=10) for pl in playlists: print(pl['name'])

spotify-utils --version

Debug

Known issues

breakingv2.0.0 renamed the main package from 'spotify_utils' to 'spotify_utils' (no change) but moved `SpotifyClient` to top-level import. Old import path `from spotify_utils.client import SpotifyClient` no longer works.

fix

Use `from spotify_utils import SpotifyClient` for v2.x.

affects: <2.0.0

deprecatedThe `export` command format templates changed in v1.1.0. Old custom templates (Jinja2 based) may break if using deprecated placeholders.

fix

Review new template format in docs; old placeholders like `{{ track }}` should be `{{ track.name }}`.

affects: >=1.1.0

gotchaSpotify OAuth requires a redirect URI exactly matching the one registered in Spotify App Dashboard. Use `http://localhost:8888/callback` for local development.

fix

Ensure `redirect_uri` in code matches the callback URL in your Spotify App settings.

affects: all

gotchaRate limits: Spotify API has a limit of 100 requests per 30 seconds. Bulk operations may fail silently if not handling HTTP 429.

fix

Implement exponential backoff or use the built-in retry mechanism (available since v1.0.14).

affects: all

Upgrade

Version history

2.0.1latest on PyPI · released Feb 28, 2026

Audit

Dependencies

spotipyrequiredCore Spotify Web API client library

typerrequiredCLI framework

richrequiredTUI and formatted output

Agent activity

41 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/fabieu/spotify-utils ↗

packagehttps://pypi.org/project/spotify-utils/ ↗