iCloud Photos Downloader

A command-line tool to download all your iCloud photos.
Works on Mac, Linux, and Windows.
Run it multiple times to download any new photos.

Why?

I use the Photos app on my MacBook, set to "Optimize Mac Storage". It stores full-resolution images in iCloud, and only stores thumbnails on my computer until they are requested.
I want to download a copy of all my photos onto my Linux PC, because:
- I use Plex instead of an Apple TV. Now I can display photo slideshows with Plex.
- I like having a backup of all my photos on my own hard-drive.
I only want to download the "medium" size of all my photos. They save some space while still being big enough for slideshows. If "medium" is not available, then fall back to downloading the original size.

Installation

# Clone the repo somewhere
git clone https://github.com/ndbroadbent/icloud_photos_downloader.git
cd icloud_photos_downloader

# Install dependencies (Linux)
sudo pip install -r requirements.txt

Authentication

If your account has two-factor authentication enabled, you will be prompted for a code when you run the script.

Two-factor authentication will expire after an interval set by Apple, at which point you will have to re-authenticate. This interval is currently two months.

NOTE: Using the system keyring to store your iCloud password is not supported, because this is an automated script. Just provide your iCloud password by using the --password option.

Usage

$ ./download_photos.py <download_directory>
                       --username=<username>
                       --password=<password>
                       [--size=(original|medium|thumb)]
                       [--recent <integer>]
                       [--until-found <integer>]
                       [--auto-delete]

Options:
  --username <username>           Your iCloud username or email address
  --password <password>           Your iCloud password
  --size [original|medium|thumb]  Image size to download (default: original)
  --recent INTEGER                Number of recent photos to download (default: download all photos)
  --until-found INTEGER RANGE     Download most recently added photos until we
                                  find x number of previously downloaded
                                  consecutive photos (default: download all photos)
  --download-videos               Download both videos and photos (default: only download 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.)
  -h, --help                      Show this message and exit.

Example:

$ ./download_photos.py ./Photos \
    [email protected] \
    --password=pass1234 \
    --size=original \
    --recent 500 \
    --auto-delete

Error on first run

The first time you run the script, you will probably see an error message like this:

Bad Request (400)

This error usually means that Apple's servers are getting ready to send you data about your photos. This process can take around 5-10 minutes, so please wait a few minutes, then try again.

(If you are still seeing this message after 30 minutes, then please open an issue on GitHub.)

Run once every 3 hours using Cron

cp cron_script.sh.example cron_script.sh

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

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

volkandod / icloud_photos_downloader Goto Github PK