Skip to main content

Download album artwork from Spotify

Project description


spotify_images provides a simple method of retrieving all unique album art from either a Spotify playlist or artist on Spotify and creating a collage from the query.


git clone


Before using this program, you'll need to get credentials from Spotify's API. An account on Spotify will provide two credentials: 'client id' and 'client secret.'

Modify the file's two fields:

client_id = 'your_client_id'
client_secret = 'your_client_secret'

Two prerequisites you'll need installed on your machine are pillow and spotipy. You can easily get both of these from the pip repository. If you aren't yet aware of the beauty of pip, go check out it's website. You're welcome.

pip3 install -r requirements.txt


Download album art from an artist or playlist:

By default spotify_images fetches all unique art of any Spotify arist or playlist link given as an argument



Use the -v or --verbose flag to see what the program is doing in real time.

Create a collage

Use the -c or --collage collage flag to create a collage of the artwork downloaded.

python3 -vc
Name: SRC#15
Type: playlist
12 saved to results/src#15
Total unique pictures: 12
Rows: 3	Cols: 4
Collage saved as: results/src#15.jpeg

The resulting collage:

Unleash The Archers Collage

Future features:

I would love to be able to specify a width and height for the purposes of creating wallpapers. Additionally, a website that hosts this code via Flask would be ideal so that anyone could utilize this software without the hassle of installation and configuration. However if I'm going do that I may as well rewrite this program in Javascript and save myself some trouble.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spotify-album-art- (4.8 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page