96f945150b
|
||
|---|---|---|
| .devcontainer | ||
| .github | ||
| .vscode | ||
| binary_dist | ||
| docs | ||
| examples | ||
| jq | ||
| npm | ||
| scripts | ||
| src | ||
| tests | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| Dockerfile.build | ||
| Dockerfile.build-musl | ||
| EXPERIMENTAL.md | ||
| LICENSE.md | ||
| README.md | ||
| README_AUR.md | ||
| README_DOCKER.md | ||
| README_NPM.md | ||
| README_PYPI.md | ||
| pyproject.toml | ||
| requirements-pip.txt | ||
README.md
iCloud Photos Downloader 
- 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-deleteoption) - Move - download new photos from iCloud and delete photos in iCloud (
--delete-after-downloadoption)
- 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-intervaloption) - Optimizations for incremental runs (
--until-foundand--recentoptions) - Photo metadata (EXIF) updates (
--set-exif-datetimeoption) - ... and many more (use
--helpoption 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, noticloudexecutable
[!TIP] Synchronization logic can be adjusted with command-line parameters. Run
icloudpd --helpto 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.