Skip to content

size.md

Latest commit

 

History

History
47 lines (31 loc) · 1.91 KB

size.md

File metadata and controls

47 lines (31 loc) · 1.91 KB

Asset Sizes

Basic Sizes

Multiple `--size` parameters can be specified

icloudpd emulates the web browser to access iCloud.com. Whatever Apple makes available in the iCloud.com web UI is available to icloudpd.

Each asset in iCloud may have multiple sizes available for downloading:

  • original: The original file as uploaded to iCloud (e.g. HEIC, JPEG, RAW).
  • medium: A downscaled version generated by iCloud (usually JPEG).
  • thumb: A thumbnail version generated by iCloud (usually JPEG).
The file formats for `medium` and `thumb` are determined by Apple and can change at any time (e.g. Apple could decide to switch `medium` to HEIC in the future).

Size can be selected with the --size parameter and multiple specifications are accepted (e.g., --size original --size medium). The default is original.

Fallback Logic

icloudpd implements its own logic on top of what is available from Apple.

If the size parameter is specified, but it is not available for the asset in iCloud, then original is downloaded, unless --force-size is specified.

Assets for sizes other than original will have a suffix added to their name, e.g., IMG-1234-medium.JPG.

Special Sizes

Image edits are represented as a special size adjusted. This usually corresponds to the current version of the image with edits (crops, filters, etc.) applied.

Two common use cases related to edits:

  • Download the edited version or original if it was not edited: use the --size adjusted parameter.
  • Download edit and original: use the --size adjusted --size original parameters. Edits will have a -adjusted suffix added if the file extension is the same as the original.
Portraits are represented in iCloud as edits. `adjusted` size often downloads as HEIC with the correct crop/edits applied.

[RAW](raw) assets use `alternative` size
⚡