FAQ Frequently asked questions

Here we collect answers to various things that you might encounter while using icloudpd.

Is it possible to have spaces/blanks in your password?

Yes, it is possible. You must escape the spaces on the command line, p.e. -p "my s3cret Password".

How to use the folder structure option? #131

The option --folder-structure uses a standard [Python string formatting functions](https://docs.python.org/3/library/string.html#string-formatting and references a datetime.datetime object for the corresponding photo like datetime.datetime(2020, 10, 30, 11, 18, 26, 244000, tzinfo=<DstTzInfo 'Europe/Berlin' CET+1:00:00 STD>) as input.

none leads to all pictures put into the folder specified by -d. No sub-structure is created.

Example: --folder-structure {:%Y/%Y-%m-%d}

If you're not used to these types of substitutions, what's going on there is %Y gets replaced with the full year, %m with the month number, zero padded (eg, Jan is 01, Jul is 07 etc) and %d with the date, also zero-padded to two places (eg, 05, 11, 31 etc).

So with the above, my folder layout becomes:

path/to/photos/
              2019/
                 2019-12-23/
              2020/
                 2020-02-03/
                 2020-02-09/

Further information can also be found here.

pyicloud_ipd.exceptions.PyiCloudServiceNotActivatedErrror: Please log into https://icloud.com/ to manually finish setting up your iCloud service (ZONE_NOT_FOUND)

Also refer to toe list of error codes of the CloudKitWebServices.

You will get this error ZONE_NOT_FOUND(404) because synchronization for photos wasn't enabled yet. If you want to have photos in iCloud need to switch on synchronisation in device settings, after switch on icloud_photos_downloader will work as expected. (#107)