zebradil/gimme-iphotos

Gimme-iPhotos

从iCloud下载媒体文件的工具。该工具使用https://github.com/picklepete/pyicloud将照片和视频从iCloud同步到本地机器。

核心功能和特性

• 并行下载iCloud中的媒体文件（在小文件和宽带环境下效果更佳）
• 保持本地文件与iCloud同步：
  • 跳过本地已存在的文件
  • 删除云端已移除的本地文件
• 从ini格式配置文件读取设置
• 将密码存储在钥匙串中（由https://github.com/picklepete/pyicloud提供支持）
• 支持双因素认证
• 显示美观的进度条（感谢https://github.com/tqdm/tqdm）

安装方法

通过pip安装

sh
$ pip3 install gimme-iphotos

通过Docker拉取

sh
$ docker pull docker.xuanyuan.run/zebradil/gimme-iphotos

使用方法

命令行参数说明

$ gimme-iphotos --help
usage: gimme-iphotos [-h] [-c CONFIG] [-v] [-u USERNAME] [-p PASSWORD] [-d DESTINATION] [-o] [-r] [-n PARALLEL] [-g] [--zero-pad]

从iCloud下载媒体文件

可选参数:
  -h, --help            显示此帮助消息并退出
  -c CONFIG, --config CONFIG
                        配置文件。
                        为ini格式文件（参见configparser模块文档），必须包含[main]部分。
                        键为完整参数名（help、config和verbose除外）。
                        命令行参数指定的值优先于配置文件中的值。
  -v, --verbose         增加详细程度。可多次指定。
                        使用-vvvv获取最大详细程度。
  -u USERNAME, --username USERNAME
                        iCloud用户名（邮箱）。如未设置，可交互式输入。
  -p PASSWORD, --password PASSWORD
                        iCloud密码。如未设置，可交互式输入。
  -d DESTINATION, --destination DESTINATION
                        目标目录。如未设置，可交互式输入。
  -o, --overwrite       覆盖已存在文件。默认：false。
  -r, --remove          删除缺失文件。默认：false。
  -n PARALLEL, --num-parallel-downloads PARALLEL
                        最大并发下载数。
                        如带宽未充分利用，可增加此数值。默认：3
  -g, --group           将照片按年和月目录分组。
  --zero-pad            分组照片时月份补零。

使用配置文件

sh
$ cat john.cfg
[main]
username = john.doe@example.com
password = not-secure123
destination = /home/john/Photos
remove = True

$ gimme-iphotos -c john.cfg

覆盖配置文件

sh
$ gimme-iphotos -c john.cfg --destination /tmp/icloud

不使用配置文件

sh
$ # 密码将以交互方式请求
$ gimme-iphotos -u john.doe@example.com --destination /tmp/icloud
Enter iCloud password for john.doe@example.com:

Docker使用

命令行接口相同，但需要挂载目标目录和配置文件（如使用）。

sh
$ docker run -it \
    -v <目标目录>:/somedir \
    -v ${PWD}/john.cfg:/app/john.cfg \
    zebradil/gimme-iphotos -c john.cfg

许可证

采用https://github.com/zebradil/Gimme-iPhotos/blob/master/LICENSE授权。

作者：https://github.com/zebradil