Danh mục

icloud-photos-downloader/icloud_photos_downloader

A command-line tool to download photos from iCloud

snapshot · 26/10/2026
II

icloud-photos-downloader/icloud_photos_downloader

image-tools · Python · danh tính provisional_slug_only

A command-line tool to download photos from iCloud

Sao12.3klịch sử sao
Hạng#4338snapshot toàn cục
Fork854bản ghi nguồn
Số ngày trending6lịch sử xu hướng
Snapshot chỉ có lịch sử sao đầy đủ của star-history/star-history. Lịch sử thiếu thì không vẽ.

README

Từ GitHub · lưu tạm tối đa 7 ngày

iCloud Photos Downloader Quality Checks Build and Package MIT License

  • A command-line tool to download all your iCloud photos.
  • Works on Linux, Windows, and macOS; laptop, desktop, and NAS
  • Available as an executable for direct downloading and through package managers/ecosystems (Docker, PyPI, AUR, npm)
  • Developed and maintained by volunteers (we are always looking for help).

See Documentation for more details. Also, check Issues

iCloud Prerequisites

To make iCloud Photo Downloader work, ensure the iCloud account is configured with the following settings, otherwise Apple Servers will return an ACCESS_DENIED error:

  • Enable Access iCloud Data on the Web: On your iPhone / iPad, enable Settings > Apple ID > iCloud > Access iCloud Data on the Web
  • Advanced Data Protection (ADP): either disable Settings > Apple ID > iCloud > Advanced Data Protection on your iPhone / iPad, or keep it enabled and run with --adp-web-access (see Authentication)

Install and Run

There are three ways to run icloudpd:

  1. Download executable for your platform from the GitHub Release and run it
  2. Use package manager to install, update, and, in some cases, run (Docker, PyPI, AUR, npm)
  3. Build and run from the source

See Documentation for more details

Features

  • Three modes of operation:
    • Copy - download new photos from iCloud (default mode)
    • Sync - download new photos from iCloud and delete local files that were removed in iCloud (--auto-delete option)
    • Move - download new photos from iCloud and delete photos in iCloud (--keep-icloud-recent-days option)
  • 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
  • One time download and an option to monitor for iCloud changes continuously (--watch-with-interval option)
  • Optimizations for incremental runs (--until-found and --recent options)
  • Photo metadata (EXIF) updates (--set-exif-datetime option)
  • ... and many more (use --help option to get full list)

Experimental Mode

Some changes are added to the experimental mode before they graduate into the main package. Details

Usage

To keep your iCloud photo collection synchronized to your local system:

icloudpd --directory /data --username my@email.address --watch-with-interval 3600

Important

It is icloudpd, not icloud executable

Tip

Synchronization logic can be adjusted with command-line parameters. Run icloudpd --help to get full list.

To move tracked local copies out of the active mirror when photos leave a shared library (including moves back to a participant's personal library), use a dedicated download directory:

icloudpd --directory /data/shared --username my@email.address \
  --library 'SharedSync-YOUR-LIBRARY-ID' --prune-orphans

By default, tracking starts with newly written files and the first successful run only establishes a baseline. To also clean old orphans in an existing dedicated flat, original-size mirror, explicitly opt in to the one-time --prune-orphans-adopt-existing bootstrap and preview it with --dry-run first.

Pruned files are moved into .icloudpd-pruned/, never permanently deleted: even consistent counts cannot prove Apple's listing is complete. Exclude that folder from gallery scans. Pruning problems warn without failing downloads. See the option reference for ownership requirements, hashing costs and recovery instructions.

To independently create and authorize a session (and complete 2SA/2FA validation if needed) on your local system:

icloudpd --username my@email.address --auth-only

Tip

This feature can also be used to check and verify that the session is still authenticated.

Contributing

Want to contribute to iCloud Photos Downloader? Awesome! Check out the contributing guidelines to get involved.