{"id":16065208,"url":"https://github.com/lacymorrow/album-art","last_synced_at":"2026-05-21T00:09:55.733Z","repository":{"id":15767502,"uuid":"18506404","full_name":"lacymorrow/album-art","owner":"lacymorrow","description":"💽   Fetch cover art for an artist or album:  \"The Beatles\" ➔ http://path/to/beatles.jpg","archived":false,"fork":false,"pushed_at":"2024-09-01T20:26:55.000Z","size":578,"stargazers_count":111,"open_issues_count":2,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-29T10:36:09.737Z","etag":null,"topics":["album","album-art","artists","cli","javascript","nextjs","nodejs","plugin","react"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/album-art","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lacymorrow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"lacymorrow","patreon":"lacymorrow","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["buymeacoffee.com/lm","lacymorrow.com/donate"]}},"created_at":"2014-04-07T04:30:49.000Z","updated_at":"2024-09-17T07:52:00.000Z","dependencies_parsed_at":"2023-11-09T16:02:32.687Z","dependency_job_id":"87fc1156-60e1-4698-b3f6-3c9082d0dc1b","html_url":"https://github.com/lacymorrow/album-art","commit_stats":{"total_commits":81,"total_committers":9,"mean_commits":9.0,"dds":"0.18518518518518523","last_synced_commit":"ab4c4a329cfa4a79ff7da03ff87ba8f6a1eea092"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Falbum-art","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Falbum-art/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Falbum-art/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lacymorrow%2Falbum-art/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lacymorrow","download_url":"https://codeload.github.com/lacymorrow/album-art/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247119275,"owners_count":20886721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["album","album-art","artists","cli","javascript","nextjs","nodejs","plugin","react"],"created_at":"2024-10-09T05:11:53.738Z","updated_at":"2026-05-21T00:09:55.727Z","avatar_url":"https://github.com/lacymorrow.png","language":"JavaScript","funding_links":["https://github.com/sponsors/lacymorrow","https://patreon.com/lacymorrow","buymeacoffee.com/lm","lacymorrow.com/donate","https://buymeacoffee.com/lm"],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/lacymorrow/album-art\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/lacymorrow/album-art/master/.github/assets/logo-horizontal-dark.svg\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/lacymorrow/album-art/master/.github/assets/logo-horizontal.svg\" alt=\"album-art\" width=\"320\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\n  \u003cp\u003e\u003cstrong\u003eFetch album or artist cover art\u003c/strong\u003e ➔ \"The Beatles\" → http://path/to/beatles.jpg\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://www.npmjs.com/package/album-art\"\u003e\u003cimg alt=\"npm version\" src=\"https://img.shields.io/npm/v/album-art?style=flat\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.npmjs.com/package/album-art\"\u003e\u003cimg alt=\"npm downloads\" src=\"https://img.shields.io/npm/dm/album-art?style=flat\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/lacymorrow/album-art/actions/workflows/ci.yml\"\u003e\u003cimg alt=\"CI\" src=\"https://img.shields.io/github/actions/workflow/status/lacymorrow/album-art/ci.yml?style=flat\u0026label=CI\"\u003e\u003c/a\u003e\n    \u003ca href=\"./LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/npm/l/album-art?style=flat\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://npm.runkit.com/album-art\"\u003e\u003cimg alt=\"Try on RunKit\" src=\"https://img.shields.io/badge/Try-RunKit-f55fa6?style=flat\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cimg src=\"./demo.svg?sanitize=true\" alt=\"album-art demo\" width=\"700\"\u003e\n\u003c/div\u003e\n\n---\n\n\u003e [!IMPORTANT]\n\u003e This library is **feature-complete** and only receives bug-fix updates. Feature requests still welcome — please open an issue.\n\n\u003e [!NOTE]\n\u003e Last.fm [cannabilized their own API](https://getsatisfaction.com/lastfm/topics/api-announcement-dac8oefw5vrxq) and broke many applications, including this one. `album-art` now uses Spotify for image data. The public API is fully backwards-compatible.\n\n## Features\n\n- Use anywhere, browser or Node (UMD bundle — [browser support](https://caniuse.com/#feat=fetch))\n- Works in React + Next.js, client and server, via [cross-fetch](https://www.npmjs.com/package/cross-fetch)\n- Promise **and** callback API\n- Fetch images for albums or artists\n- Multiple size options (`small` · `medium` · `large`)\n- Powered by Spotify's catalog\n\n## Install\n\n```bash\nnpm install album-art\n```\n\nIn the browser:\n\n```html\n\u003c!-- albumArt as a window global --\u003e\n\u003cscript src=\"https://unpkg.com/album-art\"\u003e\u003c/script\u003e\n```\n\nAlso available via [JSDelivr](https://cdn.jsdelivr.net/npm/album-art/index.min.js).\n\n## Usage\n\n```js\nconst albumArt = require(\"album-art\");\n\nalbumArt(\"Rush\").then(console.log);\n//=\u003e http://path/to/rush.jpg\n```\n\n### Callback form\n\n```js\nalbumArt(\"Rush\", (error, response) =\u003e {\n  console.log(response);\n  //=\u003e http://path/to/rush.jpg\n});\n```\n\n### With album and size options\n\n```js\nalbumArt(\"Rush\", { album: \"2112\", size: \"small\" }).then(console.log);\n//=\u003e http://path/to/rush_2112_small.jpg\n```\n\n\u003e [!TIP]\n\u003e Try it live without installing — [open in RunKit](https://runkit.com/lacymorrow/album-art) (here's an [example output](https://runkit.io/lacymorrow/album-art/branches/master?search=Ben+Folds\u0026album=Songs+for+Silverman)).\n\n## API\n\n### `albumArt(artist [, options] [, callback])`\n\nAccepts an artist string to search for. Returns a Promise that resolves to a URL string.\n\n| Argument | Type | Required | Description |\n|---|---|:---:|---|\n| `artist` | `string` | ✅ | Artist to search for |\n| `options.album` | `string` | | Album to search for |\n| `options.size` | `\"small\" \\| \"medium\" \\| \"large\"` | | Requested image size |\n| `callback` | `(err, response) =\u003e void` | | Optional Node-style callback |\n\n## CLI\n\nInstall globally to use from the shell:\n\n```bash\nnpm install --global album-art\n\nalbum-art --help\n#  Usage\n#    $ album-art artist [album] [size]\n#\n#  Example\n#    $ album-art 'The Beatles' --album 'Abbey Road' --size 'large'\n#    http://path/to/beatles/abbey_road_large.jpg\n```\n\n## Related\n\nPart of a small family of media-data utilities:\n\n- [movie-info](https://github.com/lacymorrow/movie-info) — Get info, images, and ratings about a movie.\n- [movie-trailer](https://github.com/lacymorrow/movie-trailer) — Find the trailer for a movie.\n- [movie-art](https://github.com/lacymorrow/movie-art) — Get the poster art for a movie.\n\n## Acknowledgments\n\n- [Spotify Web API](https://developer.spotify.com/documentation/web-api) — image data (subject to the [Spotify API Terms](https://developer.spotify.com/terms/)).\n- The original [Last.fm API](https://www.last.fm/api) — RIP, you were the source for the first three major versions of this library.\n\n## License\n\n[MIT](./LICENSE) © [Lacy Morrow](https://lacymorrow.com)\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eIf album-art saved you time, consider \u003ca href=\"https://github.com/sponsors/lacymorrow\"\u003esponsoring on GitHub\u003c/a\u003e, \u003ca href=\"https://patreon.com/lacymorrow\"\u003esupporting on Patreon\u003c/a\u003e, or \u003ca href=\"https://buymeacoffee.com/lm\"\u003ebuying a coffee\u003c/a\u003e.\u003c/sub\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacymorrow%2Falbum-art","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flacymorrow%2Falbum-art","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flacymorrow%2Falbum-art/lists"}