1.34.0 (2026-11-21)
- feat: add
--skip-screenshotsto leave out screenshots #1386 - feat: add
--exclude-filenameto skip assets by filename pattern #1259 - feat: add
--temp-suffixto change the suffix of temporary download files, e.g. for WebDAV mounts that refuse.part#1288.partfiles left by interrupted downloads before the suffix was changed are not resumed or removed; delete them by hand
- feat: add
--xmp-sidecar-onlyto write the XMP sidecars without downloading the photos and videos #1265 - feat: add
--webui-hostto choose the address the web UI listens on, for example127.0.0.1to allow access from this computer only; the default0.0.0.0keeps the current behavior - feat: add opt-in
--ignore-indexing-stateto 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-directorydownloads the video part of Live Photos to a separate directory, with the same folder structure as--directory#94 - fix:
--log-levelnow also applies to the bundled iCloud library, sodebugshows its debug lines (e.g. the indexing state retries) anderrorquiets 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
ERRORline 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
PrimarySynczone to another zone, such asPrimarySync1, failed withZONE_NOT_FOUND; icloudpd now looks up that zone whenPrimarySyncdoesn'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_TOKENsecret as before #1446 - chore: publish to PyPI with trusted publishing from a job in
create-release.ymlthat 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 |