Metadata

icloudpd saves the files as they are in iCloud. Some metadata that iCloud keeps outside the file can be added locally.

File Dates

The modification time of every file icloudpd downloads, including the video of a Live Photo, is set to the creation date of the asset. Files that already exist locally are not touched.

XMP Sidecars

Added in version 1.25.0.

With --xmp-sidecar, icloudpd writes an XMP file next to each downloaded photo or video (one per size), named after the full file name, e.g. IMG_1234.HEIC.xmp. The video of a Live Photo doesn’t get one. The sidecar holds what iCloud knows about the asset, when present:

  • title (caption) and description

  • keywords

  • location: latitude, longitude, altitude, speed and GPS time

  • creation date, with the time zone offset iCloud stored for the asset

  • orientation, from the edits in Photos; left out of the sidecar of the adjusted file, which iCloud already delivers upright

  • rating: 5 for favorites, -1 (rejected) for hidden or deleted assets

  • Screenshot as camera make, for screenshots

The sidecar is written again on every run, so changes in iCloud reach the local copy. A sidecar that was not written by icloudpd (e.g. by Lightroom or digiKam), or that can’t be read as XML, is never overwritten. Fields that iCloud sends in an unexpected format are left out.

EXIF Date

With --set-exif-datetime, icloudpd writes the creation date into downloaded JPEG files (.jpg/.jpeg) that have no DateTimeOriginal EXIF tag. It writes the DateTimeOriginal, DateTimeDigitized and DateTime tags, using the creation date in the local time zone. Files that already have DateTimeOriginal, other formats (HEIC, PNG, RAW, videos), and files that were already downloaded before are left as they are.

Note

This changes the downloaded file, so it is no longer identical to the one in iCloud.

Changed in version 1.33.0: A JPEG that got its date written is recognised as the same photo on the next run and is no longer downloaded again with a size suffix

This works as long as the date icloudpd would write stays the same; with the default --file-match-policy, changing the time zone between runs (see Folder Structure) makes icloudpd download such files again with a size suffix.