How To Download Photos From Icloud To Computer

Community Maintained

I hope this tool is useful for you! Unfortunately I don't employ information technology personally anymore, and I don't want to spend lots of time working on it. Please let me know if y'all want to assist maintain it and respond to the GitHub issues and pull requests.

Withal, I'k happy to accept any pull requests to keep the projection working if the code is high quality and has 100% test coverage. Thanks a lot for your assist!

Build Status Coverage Status MIT License

iCloud Photos Downloader

A command-line tool to download all your iCloud photos.
Works on Linux, Windows, and MacOS.
Run as a scheduled cron task to keep a local backup of your photos and videos.

Install

icloudpd is a Python package that can be installed using pip:

If you demand to install Python, meet the Requirements section for instructions.

Usage

                $ icloudpd <download_directory>            --username <username>            [-p, --password <countersign>]            [-d, --directory <directory>]            [--cookie-directory </cookie/directory>]            [--size (original|medium|thumb)]            [--live-photo-size (original|medium|thumb)]            [--recent <integer>]            [--until-found <integer>]            [-a, --album <album>]            [-l, --list-albums]            [--skip-videos]            [--skip-live-photos]            [--strength-size]            [--car-delete]            [--merely-print-filenames]            [--folder-construction ({:%Y/%one thousand/%d})]            [--set-exif-datetime]            [--smtp-username <smtp_username>]            [--smtp-password <smtp_password>]            [--smtp-host <smtp_host>]            [--smtp-port <smtp_port>]            [--smtp-no-tls]            [--notification-email <notification_email>]            [--notification-script PATH]            [--log-level (debug|info|error)]            [--no-progress-bar]            [--threads-num <threads>]  Options:     --username <username>           Your iCloud username or email address     --countersign <countersign>           Your iCloud password (default: use PyiCloud                                     keyring or prompt for countersign)     --cookie-directory </cookie/directory>                                     Directory to shop cookies for                                     authentication (default: ~/.pyicloud)     --size [original|medium|thumb]  Image size to download (default: original)     --live-photo-size [original|medium|pollex]                                     Live Photograph video size to download (default:                                     original)     --recent INTEGER RANGE          Number of recent photos to download                                     (default: download all photos)     --until-plant INTEGER RANGE     Download most recently added photos until we                                     observe x number of previously downloaded                                     sequent photos (default: download all                                     photos)     -a, --album <anthology>             Album to download (default: All Photos)     -50, --listing-albums               Lists the avaliable albums     --skip-videos                   Don't download any videos (default: Download                                     both photos and videos)     --skip-live-photos              Don't download any live photos (default:                                     Download live photos)     --force-size                    Only download the requested size (default:                                     download original if size is not available)     --auto-delete                   Scans the "Recently Deleted" folder and                                     deletes any files found in there. (If you                                     restore the photo in iCloud, it will be                                     downloaded again.)     --only-print-filenames          Just prints the filenames of all files that                                     volition be downloaded. (Does not download any                                     files.)     --folder-structure <folder_structure>                                     Folder structure (default: {:%Y/%m/%d})     --set-exif-datetime             Write the DateTimeOriginal exif tag from                                     file creation date, if information technology doesn't exist.     --smtp-username <smtp_username>                                     Your SMTP username, for sending email                                     notifications when two-step authentication                                     expires.     --smtp-password <smtp_password>                                     Your SMTP countersign, for sending email                                     notifications when ii-step authentication                                     expires.     --smtp-host <smtp_host>         Your SMTP server host. Defaults to:                                     smtp.gmail.com     --smtp-port <smtp_port>         Your SMTP server port. Default: 587 (Gmail)     --smtp-no-tls                   Pass this flag to disable TLS for SMTP (TLS                                     is required for Gmail)     --notification-e-mail <notification_email>                                     Electronic mail address where you would like to                                     receive email notifications. Default: SMTP                                     username     --notification-script PATH      Runs an external script when two factor                                     hallmark expires. (path required:                                     /path/to/my/script.sh)     --log-level [debug|info|error]  Log level (default: debug)     --no-progress-bar               Disables the one-line progress bar and                                     prints log messages on carve up lines                                     (Progress bar is disabled past default if                                     there is no tty attached)     --threads-num INTEGER RANGE     Number of cpu threads(default: cpu count *                                     5)     --version                       Evidence the version and exit.     -h, --help                      Prove this bulletin and exit.

Case:

                $ icloudpd ./Photos \     --username [electronic mail protected] \     --password pass1234 \     --recent 500 \     --auto-delete

Requirements

Python 3.4+
- Python 2.x is not supported.
pip

Install Python & pip

Windows

Download Python 3.vii.0

Mac

Install Homebrew (if not already installed):

                which brew > /dev/cypher ii>&i || /usr/bin/ruby -eastward "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/primary/install)"

Install Python (includes pip):

Alternatively, you can download the Python 3.7.0 installer for Mac.

Linux (Ubuntu)

                sudo apt-get update sudo apt-get install -y python

Authentication

If your Apple account has two-cistron authentication enabled, yous will exist prompted for a code when yous run the script.

Two-gene hallmark will expire subsequently an interval set by Apple tree, at which point you will have to re-authenticate. This interval is currently two months.

Authentication cookies will exist stored in a temp directory (/tmp/pyicloud on Linux, or /var/tmp/... on MacOS.) This directory can be configured with the --cookie-directory choice.

You can receive an email notification when two-gene authentication expires past passing the --smtp-username and --smtp-countersign options. Emails volition be sent to --smtp-username by default, or you can transport to a different email address with --notification-email.

If y'all want to send notification emails using your Gmail account, and y'all have enabled two-factor authentication, you will demand to generate an App Password at https://myaccount.google.com/apppasswords

System Keyring

You tin store your password in the system keyring using the icloud command-line tool (installed with the pyicloud dependency):

                $ icloud --username [email protected] ICloud Countersign for [email protected]: Relieve countersign in keyring? (y/Due north)

If y'all have stored a password in the keyring, yous will not be required to provide a password when running the script.

If you lot would like to delete a password stored in your system keyring, yous can articulate a stored countersign using the --delete-from-keyring command-line option:

                $ icloud --username [email protected] --delete-from-keyring

Error on outset run

When y'all run the script for the starting time time, you might see an error bulletin like this:

This fault often happens considering your business relationship hasn't used the iCloud API before, so Apple's servers demand to prepare some data about your photos. This process can take effectually 5-10 minutes, then please wait a few minutes and try again.

If you are still seeing this message after xxx minutes, then please open an consequence on GitHub and post the script output.

Cron Task

Follow these instructions to run icloudpd as a scheduled cron task.

                # Clone the git repo somewhere git clone https://github.com/ndbroadbent/icloud_photos_downloader.git cd icloud_photos_downloader  # Copy the instance cron script cp cron_script.sh.example cron_script.sh

Update cron_script.sh with your username, password, and other options
Edit your "crontab" with crontab -e, and so add the following line:

                0 */6 * * * /path/to/icloud_photos_downloader/cron_script.sh

Now the script volition run every 6 hours to download any new photos and videos.

If you provide SMTP credentials, the script will send an email notification whenever two-step authentication expires.

Docker

This script is available in a Docker prototype: docker pull ndbroadbent/icloudpd

Usage:

                                  #                  Downloads all photos to ./Photos                $ docker pull ndbroadbent/icloudpd $ docker run -information technology --rm --name icloud -five                                  $(pwd)                /Photos:/data ndbroadbent/icloudpd:latest \     icloudpd /data \     --username [electronic mail protected] \     --password pass1234 \     --size original \     --recent 500 \     --auto-delete

Contributing

Install dependencies:

                sudo pip install -r requirements.txt sudo pip install -r requirements-examination.txt

Run tests:

Before submitting a pull request, delight check the following:

All tests pass
- Run ./scripts/test
100% test coverage
- After running ./scripts/test, you lot will see the test coverage results in the output
- Yous can also open the HTML report at: ./htmlcov/index.html
Code is formatted with autopep8
- Run ./scripts/format
No pylint errors
- Run ./scripts/lint (or pylint icloudpd)
If yous've added or changed any command-line options, please update the Usage section in the README.

If you need to brand any changes to the pyicloud library, icloudpd uses a fork of this library that has been renamed to pyicloud-ipd. Delight clone my pyicloud fork and check out the pyicloud-ipd branch. PRs should be based on the pyicloud-ipd branch and submitted to ndbroadbent/pyicloud.

Building the Docker epitome:

                $ git clone https://github.com/ndbroadbent/icloud_photos_downloader.git $ cd icloud_photos_downloader/docker $ docker build -t ndbroadbent/icloudpd .