iCloud Photos Downloader (icloudpd)
Open sourceActive
Latest GitHub release v1.33.0 (published 2026-11-05; the CHANGELOG section is dated 2026-11-03) and latest PyPI version 1.33.0 (uploaded 2026-11-04); the previous release was v1.32.3 (2026-05-30). On 2026-11-10 master was identical to v1.33.0. The README banner and an open issue (#1305, opened 2026-01-06) say the project is looking for a maintainer, and the README says it is developed and maintained by volunteers. Not tested.
iCloud Photos Downloader (icloudpd) is a command-line tool that downloads a user's own iCloud photos to local storage, with copy, sync and move modes, and can run continuously to monitor for changes. Authentication uses the account holder's Apple ID credentials and any two-factor code, and its documentation describes no forensic purpose, evidence handling or legal-process workflow. It is a personal-backup tool listed here for context.
Facts
| Website | github.com |
|---|---|
| Vendor | icloud_photos_downloader contributors (originally Nathan Broadbent) |
| Licence | Open source (MIT (LICENSE file; PyPI metadata carries the MIT text)) |
| Category | Cloud extraction |
| Functions | Cloud extraction |
| Targets | Cloud services |
| Runs on | Linux, Windows, macOS |
| Pricing | Free |
| Users | Open-source DFIR community, Private recovery |
| Last activity | 2026-11-05 · v1.33.0 release (adds --adp-web-access and FIDO security-key sign-in) [github.com] |
| GitHub activity | icloud-photos-downloader/icloud_photos_downloader · 12,407 stars · last push 2026-11-04 · latest release v1.33.0 (2026-11-05) · checked 2026-11-10 |
Capabilities
- The README describes three modes: copy (download new photos from iCloud, the default), sync (also delete local files removed in iCloud, with --auto-delete) and move (download new photos and delete photos in iCloud, with --keep-icloud-recent-days). [github.com]
- The README lists support for Live Photos (image and video as separate files) and RAW images including RAW+JPEG, automatic de-duplication of photos with the same name, a watch option to monitor iCloud changes continuously, and EXIF datetime updates. [github.com]
- The documentation states that the tool prompts for a code when two-factor authentication is enabled, and that the MFA code can be supplied through the console or a web interface. [icloud-photos-downloader.github.io]
- The README documents an --auth-only run that creates and authorises a session independently (completing 2SA/2FA validation if needed) and can also be used to check that the session is still authenticated. [github.com]
- The documentation states that several accounts, or several configurations of one account, can be processed in one invocation by repeating --username. [icloud-photos-downloader.github.io]
Limitations
- It authenticates as the account holder: the README's usage examples pass the Apple ID email address (and, for the --auth-only example, the account password) on the command line. [github.com]
- The documentation states that, when two-factor authentication is enabled, a code is requested and that two-factor authentication expires after an interval set by Apple, currently two months, after which the user must re-authenticate. [icloud-photos-downloader.github.io]
- The README states that, to avoid an ACCESS_DENIED error from Apple servers, the account must have 'Access iCloud Data on the Web' enabled on the iPhone or iPad. [github.com]
- The documentation at v1.33.0 states that accounts with Advanced Data Protection (ADP) can be used only with the opt-in `--adp-web-access` parameter, which replays the consent sequence that icloud.com performs before showing photos and requires 'Access iCloud Data on the Web' to be enabled on the Apple device. It states that the first run sends an approval notification to the user's Apple devices and waits up to two minutes for it to be accepted, and that without the parameter an ADP account fails with ACCESS_DENIED. The page marks the section as added in 1.33.0. [github.com]
- The v1.33.0 README states that ADP must either be disabled or kept enabled and run with `--adp-web-access`. [github.com]
- The v1.33.0 CHANGELOG lists `--adp-web-access` as added to download from accounts with Advanced Data Protection. Not tested. [github.com]
- The documentation states that access to iCloud.com from mainland China is blocked, with the --domain cn option reported to give mixed results. [icloud-photos-downloader.github.io]
- The documentation states that, for accounts with security keys (FIDO, e.g. YubiKey), icloudpd asks for one of the registered keys instead of a six-digit code and the key must be plugged into the machine running icloudpd; on a machine without the key the user can sign in once with --auth-only where the key is and copy the cookie directory over. It states that the webui MFA provider does not support security keys. [github.com]
- Sync mode deletes local files that were removed in iCloud, and move mode deletes photos in iCloud after download (README feature list). [github.com]
Links
Related tools
- Elcomsoft Phone Breaker · Cloud extraction
- Cellebrite PA Cloud · Cloud extraction
- Apple Data and Privacy · Cloud extraction
- Google Takeout · Cloud extraction
Guides that discuss this tool
- Cloud extraction: tokens, backups and legal process · Three routes to phone data in the cloud: provider legal process, credential or token tools, and account-holder export, with Apple, Google and SWGDE sources.
Sources
- GitHub: icloud-photos-downloader/icloud_photos_downloader (README) (github.com)
- icloud_photos_downloader LICENSE.md (MIT) (github.com)
- icloudpd documentation: iCloud Authentication (icloud-photos-downloader.github.io)
- GitHub: icloudpd release v1.33.0 (2026-11-05) (github.com)
- GitHub: icloudpd release v1.32.3 (2026-05-30) (github.com)
- PyPI JSON: icloudpd release list (1.33.0 uploaded 2026-11-04) (pypi.org)
- GitHub issue 1305: Looking for new MAINTAINER (github.com)
- GitHub: icloudpd master commit history (github.com)
- icloudpd v1.33.0 docs/authentication.md (FIDO and ADP sections) (github.com)
- icloudpd v1.33.0 README (github.com)
- icloudpd v1.33.0 CHANGELOG.md (github.com)
Reviewed . Spotted an error? See the corrections policy.