github icloud-photos-downloader/icloud_photos_downloader v1.33.1

51 minutes ago

1.33.1 (2026-11-17)

  • fix: an asset that iCloud lists without an original version stopped the whole run with KeyError: <AssetVersionSize.ORIGINAL: 'original'> when downloading originals (the default), so nothing past it was ever downloaded; it is now logged and skipped like a missing --force-size size #926 #1261
  • fix: "IOError while writing file" always guessed "You might have run out of disk space" and hid the actual error; it now shows the error from the system, e.g. [Errno 28] No space left on device #1288
  • fix: --until-found counted files instead of photos, so with more than one --size (e.g. --size original --size medium) each photo counted once per size and the run stopped before it had found X already downloaded photos
  • fix: --auto-delete didn't delete the local Live Photo video of a photo deleted in iCloud when it was downloaded with --live-photo-size medium or thumb; it looked for IMG_1234.MOV instead of IMG_1234-medium.MOV or IMG_1234-thumb.MOV
  • fix: with --xmp-sidecar, the sidecar of an adjusted photo (--size adjusted) had the orientation of the original, so apps that read it rotated the already upright photo a second time; the adjusted sidecar no longer has the orientation #1080
  • fix: --keep-icloud-recent-days with --skip-live-photos deleted Live Photos from iCloud, including their video that was never downloaded; they are now kept in iCloud, with a warning at startup
  • fix: --only-print-filenames with more than one --album only printed the files of the first album
  • fix: --keep-icloud-recent-days 0 together with --delete-after-download was not rejected like other values of --keep-icloud-recent-days
  • fix: icloudpd --help in a terminal only showed the section headers and no options (1.33.0, built with Python 3.15, whose argparse colors the help) #1474
  • fix: the Web UI status page showed the --smtp-password in plain text to anyone who could open the Web UI; passwords are no longer shown there
  • fix: --dry-run with --keep-icloud-recent-days re-reads the same page forever #1480

Minimal Effort Compatibility

Checks if icloudpd can be installed using minimal effort and ran bare minimum functionality of displaying a version information. Minimal effort may require installing default version of package manager using OS tools

Version: version:1.33.1, commit sha:33805ae, commit timestamp:Tue Nov 17 15:18:33 2026 UTC

Compatibility rate: 88.4% (153 passed out of 173)

Legend:

  • N/A - not applicable/available
  • pass - test pass
  • fail - test fail
  • pass (src) - Test pass using src (for pip)

bin

Compatibility rate: 100.0% (37 passed out of 37)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass pass pass
alpine_3_21 pass pass pass
alpine_3_22 pass pass pass
alpine_3_23 pass pass pass
alpine_3_24 pass pass pass
debian_11_bullseye pass pass pass
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass
windows-2022 pass N/A N/A
windows-2025 pass N/A N/A

bin-musl

Compatibility rate: 100.0% (15 passed out of 15)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass pass pass
alpine_3_21 pass pass pass
alpine_3_22 pass pass pass
alpine_3_23 pass pass pass
alpine_3_24 pass pass pass

docker

Compatibility rate: 100.0% (3 passed out of 3)

OSes and distros amd64 arm64 arm32v7
linux pass pass pass

npm

Compatibility rate: 74.4% (29 passed out of 39)

OSes and distros amd64 arm64 arm32v7
alpine_3_13 N/A N/A fail
alpine_3_14 N/A N/A fail
alpine_3_15 N/A N/A fail
alpine_3_16 N/A N/A fail
alpine_3_17 N/A N/A fail
alpine_3_18 N/A N/A fail
alpine_3_19 N/A N/A fail
alpine_3_20 pass pass fail
alpine_3_21 pass pass fail
alpine_3_22 pass pass fail
alpine_3_23 pass pass N/A
alpine_3_24 pass pass N/A
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass
windows-2022 pass N/A N/A
windows-2025 pass N/A N/A

npx

Compatibility rate: 74.4% (29 passed out of 39)

OSes and distros amd64 arm64 arm32v7
alpine_3_13 N/A N/A fail
alpine_3_14 N/A N/A fail
alpine_3_15 N/A N/A fail
alpine_3_16 N/A N/A fail
alpine_3_17 N/A N/A fail
alpine_3_18 N/A N/A fail
alpine_3_19 N/A N/A fail
alpine_3_20 pass pass fail
alpine_3_21 pass pass fail
alpine_3_22 pass pass fail
alpine_3_23 pass pass N/A
alpine_3_24 pass pass N/A
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass
windows-2022 pass N/A N/A
windows-2025 pass N/A N/A

pip

Compatibility rate: 100.0% (40 passed out of 40)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass pass pass
alpine_3_21 pass pass pass
alpine_3_22 pass pass pass
alpine_3_23 pass pass pass
alpine_3_24 pass pass pass
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
python3_15 pass pass pass
python3_15_alpine3_24 pass pass pass
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass
windows-2022 pass N/A N/A
windows-2025 pass N/A N/A

Timezone and Locale Compatibility

Checks if icloudpd can be installed using minimal effort and ran bare minimum functionality of displaying version and commit timestamp in local timezone and RU locale. Minimal effort may require installing default version of package manager, timezone data, and locales using OS tools

Version: version:1.33.1, commit sha:33805ae, commit timestamp:Tue Nov 17 15:18:33 2026 UTC

Compatibility rate: 86.1% (142 passed out of 165)

Legend:

  • N/A - not applicable/available
  • pass - test pass
  • fail - test fail
  • pass (invalid) - Incorrect values were generated

bin

Compatibility rate: 91.4% (32 passed out of 35)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass (invalid) pass (invalid) pass (invalid)
alpine_3_21 pass (invalid) pass (invalid) pass (invalid)
alpine_3_22 pass (invalid) pass (invalid) pass (invalid)
alpine_3_23 pass (invalid) pass (invalid) pass (invalid)
alpine_3_24 pass (invalid) pass (invalid) pass (invalid)
debian_11_bullseye fail fail fail
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass

bin-musl

Compatibility rate: 100.0% (15 passed out of 15)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass pass pass
alpine_3_21 pass pass pass
alpine_3_22 pass pass pass
alpine_3_23 pass pass pass
alpine_3_24 pass pass pass

docker

Compatibility rate: 100.0% (3 passed out of 3)

OSes and distros amd64 arm64 arm32v7
linux pass pass pass

npm

Compatibility rate: 73.0% (27 passed out of 37)

OSes and distros amd64 arm64 arm32v7
alpine_3_13 N/A N/A fail
alpine_3_14 N/A N/A fail
alpine_3_15 N/A N/A fail
alpine_3_16 N/A N/A fail
alpine_3_17 N/A N/A fail
alpine_3_18 N/A N/A fail
alpine_3_19 N/A N/A fail
alpine_3_20 pass (invalid) pass (invalid) fail
alpine_3_21 pass (invalid) pass (invalid) fail
alpine_3_22 pass (invalid) pass (invalid) fail
alpine_3_23 pass (invalid) pass (invalid) N/A
alpine_3_24 pass (invalid) pass (invalid) N/A
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass

npx

Compatibility rate: 73.0% (27 passed out of 37)

OSes and distros amd64 arm64 arm32v7
alpine_3_13 N/A N/A fail
alpine_3_14 N/A N/A fail
alpine_3_15 N/A N/A fail
alpine_3_16 N/A N/A fail
alpine_3_17 N/A N/A fail
alpine_3_18 N/A N/A fail
alpine_3_19 N/A N/A fail
alpine_3_20 pass (invalid) pass (invalid) fail
alpine_3_21 pass (invalid) pass (invalid) fail
alpine_3_22 pass (invalid) pass (invalid) fail
alpine_3_23 pass (invalid) pass (invalid) N/A
alpine_3_24 pass (invalid) pass (invalid) N/A
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass

pip

Compatibility rate: 100.0% (38 passed out of 38)

OSes and distros amd64 arm64 arm32v7
alpine_3_20 pass pass pass
alpine_3_21 pass pass pass
alpine_3_22 pass pass pass
alpine_3_23 pass pass pass
alpine_3_24 pass pass pass
debian_12_bookworm pass pass pass
debian_13_trixie pass pass pass
macos-15 pass pass N/A
python3_15 pass pass pass
python3_15_alpine3_24 pass pass pass
ubuntu_22_jammy pass pass pass
ubuntu_24_noble pass pass pass
ubuntu_26_resolute pass pass pass

Don't miss a new icloud_photos_downloader release

NewReleases is sending notifications on new releases.