Asset Sizes¶

Basic Sizes¶

Changed in version 1.19.0: Multiple --size parameters can be specified

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

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

If 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 suffix added to their name, e.g. IMG-1234-medium.JPG.

Added in version 1.19.0.

Image edits are represented as a special size adjusted. Two common use cases related to edits:

Download edited version or original if it was not edited: use --size adjusted parameter
Download edit and original: use --size adjusted --size original parameters. Edits will have -adjusted suffix added if file extension is the same as original.

Note

Portraits are represented in iCloud as edits.