[](https://opensource.org/licenses/MIT)
# lastfm-collage-generator
Python library to create Last.fm collages from user's top items.
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": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "lastfm, music, collage, album, cover, artist, musicbucket, musicbucket.net",
"author": "Pau Riera",
"author_email": "pau.riera.forteza@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c2/22/974ed8a0975519dfa8d30a77ad714eaeeca26e3604c78732236b6528a37b/lastfmcollagegenerator-0.4.13.tar.gz",
"platform": null,
"description": "\n[](https://opensource.org/licenses/MIT)\n\n# lastfm-collage-generator\n\nPython library to create Last.fm collages from user's top items. \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": null,
"summary": "Python library to build Last.fm collages",
"version": "0.4.13",
"project_urls": {
"Bug Tracker": "https://github.com/paurieraf/lastfm-collage-generator/issues",
"Homepage": "https://github.com/paurieraf/lastfm-collage-generator",
"Repository": "https://github.com/paurieraf/lastfm-collage-generator"
},
"split_keywords": [
"lastfm",
" music",
" collage",
" album",
" cover",
" artist",
" musicbucket",
" musicbucket.net"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "def1120b116ac8fd3761feeda67780988676401a1a3a57c705c6dc14e43c0156",
"md5": "619b0d82d7a46b30af9bd6d9488fd28c",
"sha256": "860fc972ca3d0041b03209ec19b98e2c1c1905ba71463624c16c7aed788df2d4"
},
"downloads": -1,
"filename": "lastfmcollagegenerator-0.4.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "619b0d82d7a46b30af9bd6d9488fd28c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 410054,
"upload_time": "2024-09-30T17:20:26",
"upload_time_iso_8601": "2024-09-30T17:20:26.387805Z",
"url": "https://files.pythonhosted.org/packages/de/f1/120b116ac8fd3761feeda67780988676401a1a3a57c705c6dc14e43c0156/lastfmcollagegenerator-0.4.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c222974ed8a0975519dfa8d30a77ad714eaeeca26e3604c78732236b6528a37b",
"md5": "dba264d260e90180bbb365ec108b681e",
"sha256": "a916d99821893c9e939fd62875172053607583db6225f67a1cf34ba155d5fbfa"
},
"downloads": -1,
"filename": "lastfmcollagegenerator-0.4.13.tar.gz",
"has_sig": false,
"md5_digest": "dba264d260e90180bbb365ec108b681e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 408972,
"upload_time": "2024-09-30T17:20:28",
"upload_time_iso_8601": "2024-09-30T17:20:28.437196Z",
"url": "https://files.pythonhosted.org/packages/c2/22/974ed8a0975519dfa8d30a77ad714eaeeca26e3604c78732236b6528a37b/lastfmcollagegenerator-0.4.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-30 17:20:28",
"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"
}
JSON
