icloudpd/icloudpd repository overview

⁠iCloud Photos Downloader

A command-line tool to download all your iCloud photos.

⁠Install, Run, and Use

docker run -it --rm --name icloudpd -v $(pwd)/Photos:/data -e TZ=America/Los_Angeles icloudpd/icloudpd:latest icloudpd --directory /data --username [email protected] --watch-with-interval 3600

Image asset date will be converted to specified TZ and then used for creating folders (see --folder-stucture parameter)

On Windows:

• use %cd% instead of $(pwd)
• or full path, e.g. -v c:/photos/icloud:/data
• only Linux containers are supported

Synchronization logic can be adjusted with command-line parameters. Run the following to get full list:

docker run -it --rm icloudpd/icloudpd:latest icloudpd --help

⁠Getting Docker

On Windows and Mac Docker is available as Docker Desktop⁠ app.

On Linux, Docker engine and client can be installed using platform package managers, e.g. Installing on Ubuntu⁠

Appliance (e.g. NAS) will have their own way to install Docker engines and running containers - see manufacturer's instructions.

⁠More

See Project page⁠ for more details.