spotipy-dev/spotipy
Spotipy
Spotipy is a Python client library for interacting with the Spotify Web API. It provides a programmatic interface to manage music data, user accounts, and media playback.
The library implements a full OAuth 2.0 client capable of handling authorization codes, client credentials, and implicit grants. It includes a token manager that supports automated token refreshing and pluggable caching backends to maintain stateful sessions.
The project covers music metadata retrieval and search, allowing for the lookup of artists, albums, and tracks via resource identifiers and URIs. It also provides capabilities for playback queue management and the retrieval of private user account data.
Features
- Music Metadata Retrieval - Provides programmatic retrieval of detailed music metadata for tracks, artists, and albums.
- Spotify Client Libraries - Provides a comprehensive Python client library for interacting with the Spotify Web API.
- API Request Authentication - Verifies user identity and secures outgoing requests using OAuth 2.0 tokens.
- Authentication Management - Manages user identity verification and authentication lifecycles to secure API access.
- OAuth 2.0 Authorization Flows - Implements standard OAuth 2.0 flows including authorization codes, client credentials, and implicit grants for API access.
- Spotify OAuth Integrations - Implements Spotify-specific OAuth 2.0 integrations to securely access private user data.
- Multi-Grant Type Flows - Supports multiple OAuth 2.0 grant types, including authorization code and client credentials flows.
- User Profile Retrieval - Provides authenticated endpoints for fetching the current user's identity, profile, and saved library content.
- REST Clients - Provides a Pythonic wrapper that maps high-level methods to Spotify's REST API endpoints.
- Playback Queues - Enables adding specific media tracks to a user's active playback queue on a target device.
- Playback Queue Managers - Manages the runtime sequential playback ordering by adding songs to the active queue.
- Media Playback Controls - Controls media playback state and manages active playback queues on connected devices.
- Music Collection Organization - Enables gathering and organizing large sets of music metadata for processing in Python.
- Music Content Search - Allows searching for music-related entities like songs, albums, and artists via API queries.
- Automatic Token Refreshes - Implements automatic renewal of expired access tokens to maintain continuous API sessions.
- Client-to-Server Authentication - Supports client credentials flow for secure server-to-server authentication to public endpoints.
- Session State Management - Tracks authentication status and active tokens across requests to ensure session continuity.
- Token Lifecycle Management - Manages the full lifecycle of API tokens, including automated refreshing and storage.
- Authorization Code Flow Handlers - Implements the authorization code flow to obtain refreshable access tokens for user accounts.
- OAuth Token Management - Provides a dedicated system for managing the lifecycle and persistence of OAuth tokens.
- Authentication Token Caching - Provides pluggable caching for authentication tokens using local files or in-memory stores.
- Music Metadata Integration - Provides interfaces for retrieving and organizing music-specific metadata from Spotify's external database.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
