ci-rebuild-icps v1.2.0-nightly.1

Overview

This project provides a one-way sync engine for the iCloud Photos Library. The intention behind this project is to provide an easy way, to backup the full iCloud Photos Library to the native filesystem.

Currently, this can only be achieved, by having a Mac continuously run the Photos.app (with Keep originals enabled). With this method, the files cannot be easily viewed without the Photos.app.

This CLI Application offers the following high level functionality:

Documentation

A Get Started Guide can be found on GH Pages. Additional documentation and further resources - including my personal use case / workflow - are published there as well.

Limitations

As this application is using an undocumented public API, there are a couple of known limitations:

• iCloud Shared Photo Library: While this app is syncing all assets from the Shared Photo Library, unfortunately the API does not provide the location of shared assets within the user's folder hierarchy (when navigating to a folder on the WebUI while having Shared Photo Library enabled will yield an error). Until this functionality is available, Shared Photo Library assets will only be present in the _Shared-Photos folder and therefore cannot be archived.
• Advanced Data Protection: In order to use this app with an account that is secured through Advanced Data Protection, please make sure access through the iCloud WebUI is enabled. This is a minimum requirement since this tool is re-using those APIs - I'm still waiting on confirmation that this will enable functionality, please report your experience!
• FileType Support: The support of file types needs to be hardcoded by this application, since a full list is not available or retrievable. If you come across an Unknown filetype descriptor error, please report it, in order for the file type to be added to the application.

OS Support

Contributing & Feedback

Please check the contributing guidelines to learn how to engage with this project.