Overview
While downloading my library and removing media items older than 90 days from iCloud, I occasionally encounter download errors. The process reports that a file (e.g., xyz.heic) could not be downloaded, but immediately afterward I receive a prompt stating that the image was deleted anyway.
Steps to Reproduce
I’m running the following command to process roughly 750 files from the past two years. Most of the items are already downloaded, but some files in between are still missing. During the run, the tool attempts to download those missing files, and that’s where the intermittent errors occur.
/home/<username>/bin/icloudpd \
--directory /mnt/nas-media/iCloud \
--cookie-directory /var/local/icloudpd/cookies \
--username "<my-username>" \
--size original \
--live-photo-size original \
--folder-structure "{:%Y/%B/%d}" \
--password-provider console \
--keep-icloud-recent-days 90 \
--log-level info
[OS]
Linux raspberrypi 6.12.34+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.34-1+rpt1~bookworm (2025-06-26) aarch64 GNU/Linux
[icloudpd]
version:1.32.2, commit sha:dd5a421, commit timestamp:Tue Sep 2 02:53:56 2025 CEST
Expected Behavior
In case an image download fails, the original resource should stay where it is.
Actual Behavior
Media resource gets deleted.
Context
The current behavior cause a data loos risk which is quite unpleasant especially if iCloud is your single source of truth synchronizing your data onto your local backup storage.
Overview
While downloading my library and removing media items older than 90 days from iCloud, I occasionally encounter download errors. The process reports that a file (e.g., xyz.heic) could not be downloaded, but immediately afterward I receive a prompt stating that the image was deleted anyway.
Steps to Reproduce
I’m running the following command to process roughly 750 files from the past two years. Most of the items are already downloaded, but some files in between are still missing. During the run, the tool attempts to download those missing files, and that’s where the intermittent errors occur.
[OS]
Linux raspberrypi 6.12.34+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.34-1+rpt1~bookworm (2025-06-26) aarch64 GNU/Linux[icloudpd]
version:1.32.2, commit sha:dd5a421, commit timestamp:Tue Sep 2 02:53:56 2025 CESTExpected Behavior
In case an image download fails, the original resource should stay where it is.
Actual Behavior
Media resource gets deleted.
Context
The current behavior cause a data loos risk which is quite unpleasant especially if iCloud is your single source of truth synchronizing your data onto your local backup storage.