What is this?
icloud_photos_downloader (icloudpd) is a command-line tool that downloads all your photos and videos from iCloud to your local system.
icloud_photos_downloader (icloudpd) is a command-line tool that downloads all your photos and videos from iCloud to your local system.Is the command actually called 'icloud'?No, the executable is named icloudpd, not icloud, a common mix-up the README specifically calls out.
No, the executable is named icloudpd, not icloud, a common mix-up the README specifically calls out.How do I get it running?You can download a prebuilt executable for your platform from the GitHub Release, install it through a package manager (Docker, PyPI, AUR, or npm), or build and run it from source.
You can download a prebuilt executable for your platform from the GitHub Release, install it through a package manager (Docker, PyPI, AUR, or npm), or build and run it from source.Do I need to change any iCloud settings before using it?Yes, you need to enable 'Access iCloud Data on the Web' and disable 'Advanced Data Protection' in your Apple ID iCloud settings, otherwise Apple's servers return an ACCESSDENIED error.
Yes, you need to enable 'Access iCloud Data on the Web' and disable 'Advanced Data Protection' in your Apple ID iCloud settings, otherwise Apple's servers return an ACCESSDENIED error.Is this project actively maintained?The README currently shows a banner saying the project is looking for a new maintainer, which suggests ongoing development may slow down.
The README currently shows a banner saying the project is looking for a new maintainer, which suggests ongoing development may slow down.Can I run this on a NAS, not just a laptop?Yes, it works on Linux, Windows, and macOS across laptops, desktops, and NAS devices, and an official Docker image is available.
Yes, it works on Linux, Windows, and macOS across laptops, desktops, and NAS devices, and an official Docker image is available.What's the difference between Copy, Sync, and Move modes?Copy (the default) just downloads new photos from iCloud; Sync also deletes local files that were removed in iCloud via the --auto-delete option; Move downloads photos and then deletes them from iCloud using --keep-icloud-recent-days.
Copy (the default) just downloads new photos from iCloud; Sync also deletes local files that were removed in iCloud via the --auto-delete option; Move downloads photos and then deletes them from iCloud using --keep-icloud-recent-days.Does it handle Live Photos and RAW images?Yes, Live Photos are saved as separate image and video files, RAW (including RAW+JPEG) images are supported, and photos with duplicate names are automatically de-duplicated.
Yes, Live Photos are saved as separate image and video files, RAW (including RAW+JPEG) images are supported, and photos with duplicate names are automatically de-duplicated.Can it keep watching for new photos instead of running once?Yes, the --watch-with-interval option lets icloudpd monitor iCloud continuously for changes rather than doing a single one-time download.
Yes, the --watch-with-interval option lets icloudpd monitor iCloud continuously for changes rather than doing a single one-time download.Can it update photo metadata on download?Yes, the --set-exif-datetime option updates EXIF metadata on downloaded photos, among other options listed in icloudpd --help.
Yes, the --set-exif-datetime option updates EXIF metadata on downloaded photos, among other options listed in icloudpd --help.What are similar projects?pytube, gallery-dl, yoinks, XHS-Downloader, czkawka, skills-manager, rclone, mackup
pytube, gallery-dl, yoinks, XHS-Downloader, czkawka, skills-manager, rclone, mackupWhich topics is it in?aur, photos, pypi, sync, image, backup, downloader, apple, video, utility, productivity, command-line-tool
aur, photos, pypi, sync, image, backup, downloader, apple, video, utility, productivity, command-line-tool