iCloud backup via a Mac, with optional source control
macbak is a collection of tools for providing an independent backup and optional source control for Apple iCloud based resources. These work by converting each resource to HTML and copying it to your Mac for both safekeeping and as a way to allow line-based source control such as git if desired. The icdrivebak tool doesn't convert but forces all iCloud Drive files to be copied to the Mac. Together these allow normal Mac backup of these files.
Tools:
- notes2html — Back up Apple Notes to HTML files
- icdrivebak — Force all iCloud Drive files to be downloaded, for backup
To install, clone this repository:
git clone https://github.com/forbes3100/macbak.git
cd macbak
Notes backup is done whenever macbak is scheduled to run.
It will create the folder notes_icloud_bak in Documents if it doesn't exist, and write each note to a .html file there in subfolders matching the folder hierarchy in Notes. The file names have spaces changed to underscores to ease use with Unix.
When run again only updated notes will be written.
iCloud Drive backup is done whenever macbak is scheduled to run.
It will download any files on iCloud Drive that have yet to be downloaded to this Mac, listing those files. The files are stored locally in ~/Library/Mobile Documents, allowing Time Machine, etc. to back them up.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
- Scott Forbes - Initial work - forbes3100
See also the list of contributors who participated in this project.
This project is licensed under the GNU General Public License.