开源 iCloud 照片下载器 (又名：摆脱 iCloud)

开源 iCloud 照片下载器 (又名：摆脱 iCloud)
iCloud Photos Downloader

原始链接: https://github.com/icloud-photos-downloader/icloud_photos_downloader

## iCloud 照片下载器：摘要 iCloud 照片下载器 (icloudpd) 是一个命令行工具，用于将您的整个 iCloud 照片库下载到 Linux、Windows 或 macOS，甚至 NAS 设备。它可作为直接下载或通过 Docker 和 PyPI 等包管理器获得，由志愿者维护并每周更新。为了正常工作，请确保在您的 iCloud 设置中启用“在网络上访问 iCloud 数据”并*禁用*“高级数据保护”。 icloudpd 提供三种模式：**复制**（下载新照片）、**同步**（下载新照片并删除已删除的本地文件）和 **移动**（下载新照片并从 iCloud 中删除）。它支持实况照片、RAW 图像、自动去重以及增量下载，并提供持续监控的选项。主要功能包括元数据更新和一套全面的命令行参数，用于自定义。对于持续同步，请使用 `--watch-with-interval`。详细说明和完整的选项列表可通过 `icloudpd --help` 获取。欢迎贡献！

一个黑客新闻的讨论强调了一个新的开源命令行工具，用于从iCloud下载所有照片 (github.com/icloud-photos-downloader)。该工具解决了苹果缺乏官方下载选项的问题。用户们讨论了备份iCloud照片到本地的替代方法。虽然苹果*确实*提供了通过调整iCloud照片图库设置或完全禁用它来下载照片到Mac和iPhone的选项，但一些人认为苹果故意使照片导出变得困难，以保留用户在其生态系统内。原始发帖人证实了该工具的实用性，因为缺乏直接的官方下载功能，并且对话强调了用户希望对存储在云服务中的个人数据拥有更大的控制权。

原文

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

We aim to release new versions once a week (Friday), if there is something worth delivering.

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
Disable Advanced Data Protection: On your iPhone /iPad disable Settings > Apple ID > iCloud > Advanced Data Protection

There are three ways to run icloudpd:

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

See Documentation for more details

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)

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

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

icloudpd --directory /data --username [email protected] --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 independently create and authorize a session (and complete 2SA/2FA validation if needed) on your local system:

icloudpd --username [email protected] --password my_password --auth-only

Tip

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

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

开源 iCloud 照片下载器 (又名：摆脱 iCloud) iCloud Photos Downloader

开源 iCloud 照片下载器 (又名：摆脱 iCloud)
iCloud Photos Downloader