{"id":28235,"library":"spotipy-cli","title":"spotipy-cli","description":"A command-line interface for Spotify Web API built on top of Spotipy. Version 0.3.0 is the latest. Development appears to be intermittent.","status":"active","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/kandrelczyk/spotipy-cli","tags":["spotify","cli","api","music","spotipy"],"install":[{"cmd":"pip install spotipy-cli","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Core dependency for Spotify Web API interaction.","package":"spotipy","optional":false},{"reason":"CLI framework used.","package":"click","optional":false}],"imports":[{"note":"The package exposes a 'cli' function as the entry point.","wrong":"import spotipy_cli","symbol":"cli","correct":"from spotipy_cli import cli"}],"quickstart":{"code":"from spotipy_cli import cli\ncli()","lang":"python","description":"Run the CLI. It expects SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET, and SPOTIPY_REDIRECT_URI environment variables to be set."},"warnings":[{"fix":"Pin spotipy version or test with your spotipy version.","message":"spotipy-cli relies on the Spotipy library; changes in Spotipy's API may break spotipy-cli. Ensure spotipy version compatibility.","severity":"breaking","affected_versions":"0.3.0"},{"fix":"Pre-authenticate using Spotipy utilities and set environment variables for token.","message":"The CLI requires interactive auth (OAuth) and will open a browser. It may not work in headless environments without manual token caching.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use 'from spotipy_cli import cli' after installing via 'pip install spotipy-cli'.","cause":"The package is installed as 'spotipy-cli' but imported as 'spotipy_cli' (underscore).","error":"ModuleNotFoundError: No module named 'spotipy_cli'"},{"fix":"Set SPOTIPY_CLIENT_SECRET to your Spotify app's client secret.","cause":"Missing or incorrect SPOTIPY_CLIENT_SECRET environment variable.","error":"spotipy.oauth2.SpotifyOAuthError: Invalid client secret"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}