- 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.
- 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.
# 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
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.
$ ./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
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.)
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