iCloud Photo Export

Bulk download and backup iCloud Photos to your Mac. Export iPhone photos by date, month, or range. Convert HEIC to JPG. Simple CLI wrapper for icloudpd.

How to Download iCloud Photos

# Download all photos from July 2025
./icloud_photo_export.sh 2025-07 -a your@email.com -o ~/Photos

# Download a date range
./icloud_photo_export.sh 2025-07 --to 2025-09 -a your@email.com -o ~/Photos

# Convert HEIC to JPG
./convert_heic.sh -i ~/Photos/2025-07

Features

• Date-based downloads — Specify YYYY-MM (month) or YYYY-MM-DD (day)
• Range support — Use --to for multi-month or multi-day ranges
• HEIC to JPG — Convert iPhone photos to universal JPG format
• Zero dependencies — Uses macOS built-in tools + icloudpd
• Organized output — Auto-creates folders like 2025-07/ or 2025-07_to_2025-09/

Installation

# Install icloudpd
pip install icloudpd

# Clone and setup
git clone https://github.com/YOUR_USERNAME/icloud-photo-export.git
cd icloud-photo-export
chmod +x *.sh

Photo Export Usage

./icloud_photo_export.sh <date> -a <email> -o <dir> [OPTIONS]

Examples

# Single month
./icloud_photo_export.sh 2025-07 -a you@email.com -o ~/Photos

# Single day
./icloud_photo_export.sh 2025-07-15 -a you@email.com -o ~/Photos

# Month range (July-September)
./icloud_photo_export.sh 2025-07 --to 2025-09 -a you@email.com -o ~/Photos

# Include videos
./icloud_photo_export.sh 2025-07 -a you@email.com -o ~/Photos -v

HEIC Converter Usage

./convert_heic.sh -i <directory> [OPTIONS]

Examples

# Convert and delete originals
./convert_heic.sh -i ~/Photos/2025-07

# Keep originals
./convert_heic.sh -i ~/Photos/2025-07 --keep-originals

# Preview first
./convert_heic.sh -i ~/Photos/2025-07 --dry-run

Authentication

On first run, enter your iCloud password and 2FA code. Sessions are cached in ~/.pyicloud.

To re-authenticate:

rm -rf ~/.pyicloud

Troubleshooting

Related

• icloudpd — Underlying download engine
• pyicloud — Python iCloud API

License

MIT

---

_{Keywords: download icloud photos, backup iphone photos to mac, export icloud photos, icloud photo downloader, bulk download icloud, heic to jpg mac, convert heic to jpeg, icloudpd wrapper, apple photos backup, icloud cli tool, macos photo export}