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
adjustedfile, which iCloud already delivers uprightrating:
5for favorites,-1(rejected) for hidden or deleted assetsScreenshotas 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.