File Naming

Assets on iCloud have names. When downloading assets, icloudpd can adjust names.

Folder Structure

Changed in version 1.7.0: Support for none value added

icloudpd uses asset metadata (created date) to build folder hierarchy, and it can be adjusted with --folder-stucture parameter.

Specifying --folder-structure none will put all files into one folder.

Duplicates

Changed in version 1.20.0: --file-match-policy parameter added and name-id7 policy implemented

In large iCloud collections it is possible to have name collisions. To avoid collisions if files need to be downloaded into the same folder, use --file-match-policy parameter:

  • add unique invariant asset identification suffix to the name (e.g. “IMG_1234_QAZXSW.JPG”) with --file-match-policy name-id7

  • de-duplicate by adding file size as a suffix (e.g. “IMG_1234-67890.JPG” for second asset); --file-match-policy name-size-dedup-with-suffix - it is default

Live Photos

Changed in version 1.18.0: --live-photo-mov-filename-policy parameter added and original policy implemented

Live Photo assets have two components: still image and short video. icloudpd can download both and allows customizing file name of the video portion with --live-photo-mov-filename-policy parameter:

  • Use video file name the same as still image with original policy; use --file-match-policy name-id7 to avoid clashes of video file with other videos.

  • Use suffix from the still image with suffix policy: “IMG_1234_HEVC.MOV” for “IMG_1234.HEIC” still. This is default and works for HIEC still images only

Unicode

Changed in version 1.18.0: --keep-unicode-in-filenames parameter flag added with default false

Unicode characters are stripped from file names for better compatibility. icloudpd can leave them when --keep-unicode-in-filenames is specified.