![](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)
Raw data
{
"_id": null,
"home_page": "https://github.com/paurieraf/lastfm-collage-generator",
"name": "lastfmcollagegenerator",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "lastfm,music,collage,albumcover,album,artist,musicbucket,musicbucket.net",
"author": "Pau Riera",
"author_email": "pau.riera.forteza@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/ec/e31a08e8867de518179afda2e2912dedc6613d4167e0ad0c68e8bac68fa1/lastfmcollagegenerator-0.4.2.tar.gz",
"platform": null,
"description": "![](https://img.shields.io/pypi/dm/lastfm-collage-generator?)\n[![MIT License](https://img.shields.io/apm/l/atomic-design-ui.svg?)](https://github.com/tterb/atomic-design-ui/blob/master/LICENSEs)\n\n# lastfm-collage-generator\n\nPython library to create Last.fm collages from user's top albums. \n\nIt supports different configurations like the grid size or the period.\n\n\n## Features\n\n- Choose the number of rows and columns (for now, up to 5)\n- Choose the period to calculate the top (7day, 1month, 3month, 6month, 12month, overall. Default: 7day)\n \n## Installation\n\nInstall lastfmcollagegenerator with pip\n\n```bash\n pip install lastfmcollagegenerator\n```\n\n## Options\n\nEntity values\n```\n\"album\", \"artist\", \"track\"\n```\nPeriod values\n```\n\"7day\", \"1month\", \"3month\", \"6month\", \"12month\", \"overall\"\n```\n\n\n## Usage/Examples\n\n```python\nfrom lastfmcollagegenerator.collage_generator import CollageGenerator\n\ncollage_generator = CollageGenerator(lastfm_api_key=\"YOUR_API_KEY\", lastfm_api_secret=\"YOUR_API_SECRET\")\n\n# Returns a PIL Image object\nimage = collage_generator.generate(entity=\"album\", username=\"username\", cols=5, rows=5, period=\"7day\")\nimage.save(\"5x5 album collage.png\", \"png\")\n\n# Or just call the method directly\nimage = collage_generator.generate_top_albums_collage(username=\"username\", cols=5, rows=5, period=\"7day\")\nimage.save(\"5x5 album collage.png\", \"png\")\n```\n\n \n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n \n## Authors\n\n- [@paurieraf](https://www.github.com/paurieraf)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Create Last.fm collages",
"version": "0.4.2",
"project_urls": {
"Bug Tracker": "https://github.com/paurieraf/lastfm-collage-generator/issues",
"Homepage": "https://github.com/paurieraf/lastfm-collage-generator"
},
"split_keywords": [
"lastfm",
"music",
"collage",
"albumcover",
"album",
"artist",
"musicbucket",
"musicbucket.net"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b80a3dfb68e137d4b767e3490e76d1e8527a66f1879f75ad2d2e803d1132f582",
"md5": "49fba8c808681a20cb2097866ce71d3e",
"sha256": "bb14371b7d74a0f691a3a30d2bf034f99fa9d0e1be2cc2d43cdc66248ea7d0cd"
},
"downloads": -1,
"filename": "lastfmcollagegenerator-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "49fba8c808681a20cb2097866ce71d3e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 409866,
"upload_time": "2023-12-29T16:18:49",
"upload_time_iso_8601": "2023-12-29T16:18:49.706465Z",
"url": "https://files.pythonhosted.org/packages/b8/0a/3dfb68e137d4b767e3490e76d1e8527a66f1879f75ad2d2e803d1132f582/lastfmcollagegenerator-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d7ece31a08e8867de518179afda2e2912dedc6613d4167e0ad0c68e8bac68fa1",
"md5": "86374950757b0cd21b23df9be2f53a95",
"sha256": "3e6169398030558401c5677ad4bc4ab4b72ca4a219b5b37a6e1b22d213e19a07"
},
"downloads": -1,
"filename": "lastfmcollagegenerator-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "86374950757b0cd21b23df9be2f53a95",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 409904,
"upload_time": "2023-12-29T16:18:51",
"upload_time_iso_8601": "2023-12-29T16:18:51.816630Z",
"url": "https://files.pythonhosted.org/packages/d7/ec/e31a08e8867de518179afda2e2912dedc6613d4167e0ad0c68e8bac68fa1/lastfmcollagegenerator-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-29 16:18:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "paurieraf",
"github_project": "lastfm-collage-generator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "lastfmcollagegenerator"
}