Metadata-Version: 2.1
Name: lastfmcollagegenerator
Version: 0.4.1
Summary: Create Last.fm collages
Home-page: https://github.com/paurieraf/lastfm-collage-generator
Author: Pau Riera
Author-email: pau.riera.forteza@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/paurieraf/lastfm-collage-generator/issues
Keywords: lastfm,music,collage,albumcover,album,artist,musicbucket,musicbucket.net
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

![](https://img.shields.io/pypi/dm/lastfm-collage-generator?)
[![MIT License](https://img.shields.io/apm/l/atomic-design-ui.svg?)](https://github.com/tterb/atomic-design-ui/blob/master/LICENSEs)

# 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

```bash
  pip install lastfmcollagegenerator
```

## Options

Entity values
```
"album", "artist", "track"
```
Period values
```
"7day", "1month", "3month", "6month", "12month", "overall"
```


## Usage/Examples

```python
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](https://choosealicense.com/licenses/mit/)

  
## Authors

- [@paurieraf](https://www.github.com/paurieraf)

