Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 3.11 KB

FAQ.md

File metadata and controls

68 lines (45 loc) · 3.11 KB
Raw

Nuances and Known Issues

iCloud Authentication

If your Apple account has two-factor authentication enabled, you will be prompted for a code when you run the script. Two-factor authentication will expire after an interval set by Apple, at which point you will have to re-authenticate. This interval is currently two months.

You can receive an email notification when two-factor authentication expires by passing the --smtp-username and --smtp-password options. Emails will be sent to --smtp-username by default, or you can send to a different email address with --notification-email.

If you want to send notification emails using your Gmail account, and you have enabled two-factor authentication, you will need to generate an App Password at https://myaccount.google.com/apppasswords

System Keyring

You can store your password in the system keyring using the icloud command-line tool:

$ icloud --username [email protected]
ICloud Password for [email protected]:
Save password in keyring? (y/N)

If you have stored a password in the keyring, you will not be required to provide a password when running the script.

If you would like to delete a password stored in your system keyring, you can clear a stored password using the --delete-from-keyring command-line option:

icloud --username [email protected] --delete-from-keyring

Error on the First Run

When you run the script for the first time, you might see an error message like this:

Bad Request (400)

This error often happens because your account hasn't used the iCloud API before, so Apple's servers need to prepare some information about your photos. This process can take around 5-10 minutes, so please wait a few minutes and try again.

If you are still seeing this message after 30 minutes, then please open an issue on GitHub and post the script output.

Access from Mainland China

Access to iCloud.com is blocked from mainland China. icloudpd does not currently support icloud.com.cn version yet.

iOS 16 Shared Library

iOS 16 feature to share libraries between accounts is not supported yet.

MacOS binary

icloudpd is available as Intel 64bit binary for MacOS, but works on ARM macs too (M1, M2).

Here are the steps to make it working:

  • download binary from Github Releases into desired local folder
  • add executable flag by running chmod +x icloudpd-1.16.1-macos-amd64
  • start it from the terminal: icloudpd-1.16.1-macos-amd64
  • Apple will tell you that it cannot check for malicous software and refuse to run the app; click "Ok"
  • Open "System Settings"/"Privacy & Security" and find icloudpd-1.16.1-macos-amd64 as blocked app; Click "Allow"
  • Start icloudpd-1.16.1-macos-amd64 from the terminal again
  • Apple will show another warning; click "Open"
  • After that you can run icloudpd-1.16.1-macos-amd64 icloudpd --help or any other supported command/option