ICloud Shared Album is a library for scraping data off public icloud shared albums. Heavily utilization of [bertrandom/icloud-shared-album-to-flickr](https://github.com/bertrandom/icloud-shared-album-to-flickr), thanks for the great starting point!
npm install icloud-shared-albumICloud Shared Album is a library for scraping data off public icloud shared albums. Heavily utilization of bertrandom/icloud-shared-album-to-flickr, thanks for the great starting point!
``bash`
npm install -s icloud-shared-album
Apple uses CORS protection for the iCloud library API endpoints. Recommended use is server-side to avoid any CORS related errors.
`js
import { getImages } from 'icloud-shared-album';
const data = await getImages('YOUR_ALBUM_TOKEN');
console.log(data);
`
You can obtain your ICloud album token from the public URL.
`
https://www.icloud.com/sharedalbum/#B0z5qAGN1JIFd3y
^^^^^^^^^^^^^^^
The string behind the hash will be your token.
The CLI will output the data in JSON if successful.
`
npx icloud-shared-album $TOKEN
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Fixed a bug caused by Apple redirecting the requests: https://github.com/ghostops/ICloud-Shared-Album/issues/6
Duplicate derivatives are now handled with an incrementing index:
`typescript`
derivatives: {
'720': {
checksum: 'string',
fileSize: 1000,
width: 50,
height: 720,
url: 'https://...',
},
'720-1': {
checksum: 'string',
fileSize: 5000,
width: 500,
height: 720,
url: 'https://...',
},
'720-2': {
checksum: 'string',
fileSize: 10000,
width: 5000,
height: 720,
url: 'https://...',
}
}
We now return the metadata associated with an album in addition to an array of images. The response from getImages now looks like this:
`typescript`
{
metadata: {
streamName: 'string',
userFirstName: 'string',
userLastName: 'string',
streamCtag: 'string',
itemsReturned: 0,
locations: {},
},
photos: [{ ...'same as before' }],
}
The bestDerivative and url variables have been removed. Instead the variable url has been added to the Derivative object. The key to the derivative is the height of the image, just like in the response from ICloud.
Previously:
`typescript`
{
url: 'https://...',
bestDerivative: {
checksum: 'string',
fileSize: 'number',
width: 'number',
height: 'number',
}
}
Now:
`typescript``
{
derivatives: {
'100': {
checksum: 'string',
fileSize: 1000,
width: 50,
height: 100,
url: 'https://...',
},
'1234': {
checksum: 'string',
fileSize: 5000,
width: 500,
height: 1234,
url: 'https://...',
}
}
}