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-sizesize #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-foundcounted 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-deletedidn't delete the local Live Photo video of a photo deleted in iCloud when it was downloaded with--live-photo-size mediumorthumb; it looked forIMG_1234.MOVinstead ofIMG_1234-medium.MOVorIMG_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-dayswith--skip-live-photosdeleted 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-filenameswith more than one--albumonly printed the files of the first album - fix:
--keep-icloud-recent-days 0together with--delete-after-downloadwas not rejected like other values of--keep-icloud-recent-days - fix:
icloudpd --helpin 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-passwordin plain text to anyone who could open the Web UI; passwords are no longer shown there - fix:
--dry-runwith--keep-icloud-recent-daysre-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 |