Summary
https://icloud-photos-downloader.github.io/icloud_photos_downloader/install.html#docker
docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data -e TZ=America/Los_Angeles icloudpd/icloudpd:latest icloudpd --directory /data --username my@email.address --watch-with-interval 3600
version: '3'
services:
icloudpd:
image: icloudpd/icloudpd:latest
container_name: icloudpd
environment:
- TZ=Asia/Hong_Kong
volumes:
- ./Photos:/data
command: icloudpd --directory /data --username my@email.address --watch-with-interval 3600
截图
Raw
Skip to content
Navigation Menu
icloud-photos-downloader
icloud_photos_downloader
Type / to search
Code
Issues
95
Pull requests
28
Discussions
Actions
Projects
Wiki
Security
Insights
Owner avatar
icloud_photos_downloader
Public
icloud-photos-downloader/icloud_photos_downloader
Go to file
t
Add file
Folders and files
Name
Latest commit
AndreyNikiforov
AndreyNikiforov
bump 1.25.0
96f9451
·
2 weeks ago
History
.devcontainer
use locale and tz in --version, use --version in compat testing (#902)
5 months ago
.github
Update bug-report.md
last month
.vscode
doc updates (#912)
5 months ago
binary_dist
bump 1.25.0
2 weeks ago
docs
bump 1.25.0
2 weeks ago
examples
folder structure cleanup (#649)
last year
jq
fix npm package (#639)
last year
npm
separate linux glibc and musl binaries. deprecate linux 386 & arm/v6 (#…
5 months ago
scripts
bump 1.25.0
2 weeks ago
src
add s2k_fo srp protocol support #975 (#1014)
2 weeks ago
tests
fix: failed to login non-2FA account for the first attempt (#1015)
2 weeks ago
.dockerignore
normalize eol (#815)
8 months ago
.gitattributes
normalize eol (#815)
8 months ago
.gitignore
doc updates (#912)
5 months ago
CHANGELOG.md
bump 1.25.0
2 weeks ago
CODE_OF_CONDUCT.md
update documentation
4 years ago
CONTRIBUTING.md
bump 1.25.0
2 weeks ago
Dockerfile
separate linux glibc and musl binaries. deprecate linux 386 & arm/v6 (#…
5 months ago
Dockerfile.build
separate linux glibc and musl binaries. deprecate linux 386 & arm/v6 (#…
5 months ago
Dockerfile.build-musl
bump python alpine 3.18->3.19 to bump default rust 1.71 -> 1.76 to un…
4 months ago
EXPERIMENTAL.md
doc updates (#912)
5 months ago
LICENSE.md
add experimental npm distribution (#635)
last year
README.md
bump 1.25.0
2 weeks ago
README_AUR.md
Add README_AUR.md (#783)
11 months ago
README_DOCKER.md
fix spelling
6 months ago
README_NPM.md
fix spelling
6 months ago
README_PYPI.md
fix spelling
6 months ago
pyproject.toml
bump 1.25.0
2 weeks ago
requirements-pip.txt
update deps (#578)
last year
Repository files navigation
README
Code of conduct
MIT license
iCloud Photos Downloader Quality Checks Multi Platform Docker Build MIT License
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.
Install and Run
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
Features
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 (--delete-after-download 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)
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 my@email.address --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 my@email.address --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.
GlarityGlarity
⚡️4种AI模型同时输出 - 使用Felo AI聊天找到完美答案！🧠✨ 免费开始！
这是一款命令行工具，用于下载所有iCloud照片，支持Linux、Windows和macOS系统，可在笔记本、台式机和NAS上使用。工具可通过直接下载可执行文件或通过包管理器（如Docker、PyPI、AUR、npm）安装。工具由志愿者开发和维护，计划每周五发布新版本。工具提供三种操作模式：复制、同步和移动，并支持Live Photos和RAW图像。它还具有自动去重、元数据更新等功能。用户可以通过命令行参数调整同步逻辑，并可独立创建和验证会话。欢迎贡献者参与开发。
Translation
Select language
About
A command-line tool to download photos from iCloud
Resources
Readme
License
MIT license
Code of conduct
Code of conduct
Activity
Custom properties
Stars
7.3k stars
Watchers
101 watching
Forks
570 forks
Report repository
Releases 58
v1.25.0
Latest
2 weeks ago
+ 57 releases
Packages
No packages published
Contributors
36
@AndreyNikiforov
@ndbroadbent
@menkej
@dependabot[bot]
@chadj
@jfsimoneau
@iowk
@artemryzhov
@nicoh88
@jorgeas80
@cclauss
@fver
@fnordahl
@undefined-landmark
+ 22 contributors
Deployments
29
github-pages 2 weeks ago
+ 28 deployments
Languages
Python
94.3%
Shell
2.6%
HTML
2.6%
JavaScript
0.4%
Dockerfile
0.1%
jq
0.0%
Footer
© 2024 GitHub, Inc.
Footer navigation
Terms
Privacy
Security
Status
Docs
Contact
Manage cookies
Do not share my personal information
Translate
