icloud_photos_downloader README

The project's README from github.com/icloud-photos-downloader/icloud_photos_downloader. As one markdown file: README.md.

!!!! Looking for MAINTAINER for this project !!!!

iCloud Photos Downloader Quality Checks Build and Package MIT License

See Documentation for more details. Also, check Issues

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

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:

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

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 [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.

Contributing

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

icloud_photos_downloader (icloud-photos-downloader/icloud_photos_downloader)

Searching Database…

这是什么?icloud_photos_downloader(icloudpd)是一个命令行工具,可以把你 iCloud 中的所有照片和视频下载到本地系统。
这个命令真的叫 'icloud' 吗?不是,可执行文件名为 icloudpd,而不是 icloud。这是一个常见的混淆,README 也专门指出了这一点。
我该如何让它运行起来?你可以从 GitHub Release 下载适用于你平台的预编译可执行文件,也可以通过包管理器安装(Docker、PyPI、AUR 或 npm),或者从源代码构建并运行。
使用前是否需要更改任何 iCloud 设置?需要。你要在 Apple ID 的 iCloud 设置中启用“通过网页访问 iCloud 数据”,并关闭“高级数据保护”,否则 Apple 的服务器会返回 ACCESSDENIED 错误。
这个项目还在积极维护吗?README 目前显示一条横幅,写明项目正在寻找新的维护者,这意味着后续开发可能会放缓。
我能在 NAS 上运行它,而不只是笔记本电脑吗?可以。它支持 Linux、Windows 和 macOS,适用于笔记本电脑、台式机和 NAS 设备,并且提供官方 Docker 镜像。
复制、同步和移动模式有什么区别?复制(默认模式)只会从 iCloud 下载新照片;同步还会通过 --auto-delete 选项删除本地中那些已在 iCloud 中被删除的文件;移动会先下载照片,然后通过 --keep-icloud-recent-days 将其从 iCloud 中删除。
它能处理实况照片和 RAW 图片吗?可以。实况照片会保存为单独的图片和视频文件,支持 RAW 图片(包括 RAW+JPEG),重名的照片会自动去重。
它能持续监控新照片,而不是只运行一次吗?可以。--watch-with-interval 选项可以让 icloudpd 持续监控 iCloud 的变化,而不是只进行一次性下载。
它能在下载时更新照片的元数据吗?可以。--set-exif-datetime 选项可以更新下载照片的 EXIF 元数据,此外还有其他选项,可通过 icloudpd --help 查看。
Size
45.7 MB
Stars
12.3K
Age
10y
Commits · 90 Days