https://github.com/etigerstudio/apple-music-cover-scraper
A command line tool to scrape album cover from apple music preview page.
https://github.com/etigerstudio/apple-music-cover-scraper
Last synced: 5 months ago
JSON representation
A command line tool to scrape album cover from apple music preview page.
- Host: GitHub
- URL: https://github.com/etigerstudio/apple-music-cover-scraper
- Owner: etigerstudio
- Created: 2019-03-15T02:54:20.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T17:41:45.000Z (over 3 years ago)
- Last Synced: 2025-08-19T20:35:41.642Z (10 months ago)
- Language: JavaScript
- Homepage:
- Size: 439 KB
- Stars: 13
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Music Cover Scraper [](https://badge.fury.io/js/apple-music-cover-scraper)
Ever been frustrated by low-resolution, over-compressed, distorted album cover of your favorite track in your music library? Obtain comparatively clear, briliant, original cover image from Apple Music catalog preview page using this scraper.
## Installing
This scraper is distributed on NPM. Type this one-line command to install the scraper:
```
$ npm i -g apple-music-cover-scraper
```
## Usage
The main executable is linked as `am_scraper`:
```
$ am_scraper [<-s|--size> ] [-v|--version] [-h|--help] url [file name]
```
The *required* `url` denotes the url to the apple music preview web page.
The *optional* `file name` specifies the file name to save the cover as. *Default*: the album title.
The *optional* `size` sets the expected size(width in pixel) of the cover. *Default*: 800.
Use `version` switch to query the version installed.
Use `help` switch to print help infomation.
## Examples
Scrape the cover of *Flux* from *CN* server & save as `Flux - Single.jpg`(Using original album title):
```
$ am_scraper https://itunes.apple.com/cn/album/flux-single/1453562770
```
Scrape the cover of *Flux* in width of *1024* px from *US* server & save as `cover.jpg`:
```
$ am_scraper -s 1024 https://itunes.apple.com/us/album/flux-single/1453562770 cover.jpg
```
## Notes
Preview pages of certain Apple Music servers may not be accessible in certain countries or regions. For example, preview pages of US server is not available in mainland China.
## Disclaimer
This projected is not affiliated with Apple Music in any way. Apple Music is a trademark of Apple Inc.
> Brought to you with ❤️ by E-Tiger Studio 2019.