icloud-photos-downloader / icloud_photos_downloader

A command-line tool to download photos from iCloud
MIT License
6.85k stars 554 forks source link

Support for bursts #758

Open nenning opened 10 months ago

nenning commented 10 months ago

Summary

Currently, burst photos don't seem to be supported. They are not downloaded at all.

Context

I don't know what options you have to download bursts. You could download each "frame" as a separate jpg. File names should reflect the frame number, e.g. IMG_1143-frame-{i}.jpg Maybe even add a flag to define the burst download behavior (keyframe only or all frames).

Notes:

AndreyNikiforov commented 10 months ago

how does icloud.com show bursts? as a series on images? how can you download bursts from icloud.com? are they downloaded as series of files as well?

nenning commented 10 months ago

iCloud has very limited functionality. The image is marked as a burst. You can only download the (single) keyframe as a jpeg. You cannot browse through the individual frames.

AndreyNikiforov commented 10 months ago

icloudpd emulates web access under the hood, so in most cases if functionality is not available on icloud.com, it cannot be implemented in icloudpd.

It sounds strange that Apple would limit icloud.com for bursts to only one frame. Is there any other way to view the whole burst image?

nenning commented 10 months ago

Ok, thanks for the information! I thought it used some kind of API that might be able to do more than the web app. I couldn't find a way to download the whole burst on icloud.com. Also googling didn't help. So let's assume that's not possible.

What's left: icloudpd should download the main frame of a burst. That should be possible based on the web app.