Skip to main content

Create collages

Project description

MIT License


Python library to create collages from user's top albums.

It supports different configurations like the grid size or the period.


  • Choose the number of rows and columns (for now, up to 5)
  • Choose the period to calculate the top (7day, 1month, 3month, 6month, 12month, overall. Default: 7day)


Install lastfmcollagegenerator with pip

  pip install lastfmcollagegenerator


Entity values

"album", "artist", "track"

Period values

"7day", "1month", "3month", "6month", "12month", "overall"


from lastfmcollagegenerator.collage_generator import CollageGenerator

collage_generator = CollageGenerator(lastfm_api_key="YOUR_API_KEY", lastfm_api_secret="YOUR_API_SECRET")

# Returns a PIL Image object
image = collage_generator.generate(entity="album", username="username", cols=5, rows=5, period="7day")"5x5 album collage.png", "png")

# Or just call the method directly
image = collage_generator.generate_top_albums_collage(username="username", cols=5, rows=5, period="7day")"5x5 album collage.png", "png")




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

lastfmcollagegenerator-0.4.2.tar.gz (409.9 kB view hashes)

Uploaded Source

Built Distribution

lastfmcollagegenerator-0.4.2-py3-none-any.whl (409.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page