github icloud-photos-downloader/icloud_photos_downloader v1.34.0

one hour ago

1.34.0 (2026-11-21)

  • feat: add --skip-screenshots to leave out screenshots #1386
  • feat: add --exclude-filename to skip assets by filename pattern #1259
  • feat: add --temp-suffix to change the suffix of temporary download files, e.g. for WebDAV mounts that refuse .part #1288
    • .part files left by interrupted downloads before the suffix was changed are not resumed or removed; delete them by hand
  • feat: add --xmp-sidecar-only to write the XMP sidecars without downloading the photos and videos #1265
  • feat: add --webui-host to choose the address the web UI listens on, for example 127.0.0.1 to allow access from this computer only; the default 0.0.0.0 keeps the current behavior
  • feat: add opt-in --ignore-indexing-state to continue, with a warning, when iCloud keeps reporting the library as still indexing; the end of the run then says that the listing may be incomplete instead of "All photos and videos have been downloaded"; it can't be combined with options that delete #1387
  • feat: --live-photo-directory downloads the video part of Live Photos to a separate directory, with the same folder structure as --directory #94
  • fix: --log-level now also applies to the bundled iCloud library, so debug shows its debug lines (e.g. the indexing state retries) and error quiets its warnings; the per-request lines with response headers and session tokens stay out of the output #1488
  • fix: a refused sign-in is now one readable ERROR line with Apple's message and code instead of a Python tuple with raw JSON, with hints when Apple refused the password #1348 #1240
  • fix: accounts whose photo library Apple moved from the PrimarySync zone to another zone, such as PrimarySync1, failed with ZONE_NOT_FOUND; icloudpd now looks up that zone when PrimarySync doesn't exist (based on #1367 by @tural-ali) #1361
  • chore: the release workflow can publish to npm with trusted publishing (OIDC) once it is set up on npmjs.com, so no npm token is needed; until then it publishes with the NPM_TOKEN secret as before #1446
  • chore: publish to PyPI with trusted publishing from a job in create-release.yml that uses the "release" environment, instead of a password in the repository secrets; the Docker Hub and npm jobs use that environment too

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.34.0, commit sha:47039b6, commit timestamp:Fri Nov 20 19:17:40 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.34.0, commit sha:47039b6, commit timestamp:Fri Nov 20 19:17:40 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.