文章摘要
这是一个名为icloudphotosdownloader的命令行工具,可以从iCloud下载照片,项目托管在GitHub上。
文章总结
iCloud 照片下载工具
项目名称:icloudphotosdownloader
项目地址:https://github.com/icloud-photos-downloader/icloudphotosdownloader
许可证:MIT
项目简介
这是一个命令行工具,用于从iCloud下载照片。它支持Linux、Windows和macOS系统,可以在笔记本电脑、台式机和NAS上运行。工具提供了多种安装方式,包括直接下载可执行文件、通过Docker、PyPI、AUR和npm等包管理器安装。
主要功能
三种操作模式:
- 复制模式:从iCloud下载新照片(默认模式)。
- 同步模式:下载新照片并删除本地已从iCloud移除的文件(通过
--auto-delete选项启用)。 - 移动模式:下载新照片并删除iCloud中的照片(通过
--keep-icloud-recent-days选项启用)。
其他特性:
- 支持Live Photos(图像和视频作为单独文件)和RAW图像(包括RAW+JPEG)。
- 自动去重同名照片。
- 支持一次性下载或持续监控iCloud变化(通过
--watch-with-interval选项)。 - 优化增量运行(通过
--until-found和--recent选项)。 - 更新照片元数据(EXIF)(通过
--set-exif-datetime选项)。
使用前提
- 在iPhone/iPad上启用
设置 > Apple ID > iCloud > 在网页上访问iCloud数据。 - 禁用
设置 > Apple ID > iCloud > 高级数据保护。
安装与运行
- 直接下载:从GitHub发布页面下载对应平台的可执行文件并运行。
- 包管理器安装:通过Docker、PyPI、AUR或npm安装。
- 从源代码构建:自行构建并运行。
示例命令
- 同步iCloud照片到本地目录:
bash icloudpd --directory /data --username my@email.address --watch-with-interval 3600 - 仅验证会话(包括2SA/2FA验证):
bash icloudpd --username my@email.address --password my_password --auth-only
实验性功能
部分新功能会先加入实验模式,通过实验性功能文档了解详情。
贡献
欢迎贡献!详情请参阅贡献指南。
项目状态
- Stars:9.8k
- Forks:700
- Watchers:106
- 贡献者:42人
语言分布
- Python:93.7%
- HTML:3.1%
- Shell:2.7%
- JavaScript:0.3%
- Dockerfile:0.2%
- CSS:0.0%
注意
项目目前正在寻找维护者(详情见Issue #1305)。
更多详细信息请参阅项目文档。
评论总结
评论总结:
- 对iCloud照片导出问题的抱怨
- 用户指出iCloud缺乏官方批量导出功能,导致操作困难 "Photos app chokes and crashes and manually babysitting smaller batches is a pain" (ericj5) "You need an extra tool to download your own photos? That's... not a basic feature?" (hannob)
- 现有解决方案讨论
- 推荐开源命令行工具icloudpd "Here is an open-source command-line tool to download all your iCloud photos" (reconnecting) "I've been using this for several years now on a little unraid box" (Dachande663)
- 官方替代方案争议
- 部分用户提到通过Apple隐私页面申请数据存档 "can't you go to privacy.apple.com, ask for an archive of your data" (caminanteblanco)
- 但有人认为过程缓慢不便 "they'll email you the link to a zip file in a week or two" (caminanteblanco)
- 技术担忧
- 对特殊格式(如Live Photos)导出的担忧 "there are some proprietary formats like Live Photos...exports are lossy" (rgovostes)
- 对工具安全性的顾虑 "Always makes me nervous, the access it has" (Dachande663)
- 生态系统批评
- 对苹果封闭生态的批评 "Apples lack of any 3rd party integration...is really annoying" (shireboy)
- 考虑转投其他平台 "I want to switch to android but the only thing stopping me is eight years of photos" (axpy906)
- 其他工具推荐
- 推荐Parachute等替代方案 "I'm a big fan of Parachute Backup for this purpose" (jeanofthedead)
- 讨论rclone等工具 "why not use rclone" (Razele)