Skip to main content

Create Last.fm collages

Project description

MIT License

lastfm-collage-generator

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

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

Features

  • 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)

Installation

Install lastfmcollagegenerator with pip

  pip install lastfmcollagegenerator

Options

Entity values

"album", "artist", "track"

Period values

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

Usage/Examples

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")
image.save("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")
image.save("5x5 album collage.png", "png")

License

MIT

Authors

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.3.0.tar.gz (409.0 kB view hashes)

Uploaded Source

Built Distribution

lastfmcollagegenerator-0.3.0-py3-none-any.whl (408.7 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