icloud-backup
v1.1.2
Published
[![NPM Version](https://img.shields.io/npm/v/icloud-backup)](https://npmjs.com/package/icloud-backup) [![Sponsor](https://img.shields.io/github/sponsors/weejewel)](https://github.com/sponsors/WeeJeWel) [![Build & Publish NPM Package](https://github.com/We
Downloads
1
Readme
iCloud Backup
This module automatically downloads your iCloud Drive & Photos to the local filesystem.
This tool will output the following directory structure:
.
└── Drive
└── <...>
└── Photos
└── All Photos
└── <.png|.jpg|.mov|...>
Why?
Apple makes great services, but there are many horror stories of people locked out of their accounts. So be safe, and keep your data backed up!
Usage
1. Run
Node.js
If you have Node.js already installed, run:
$ npx -y icloud-backup \
--username "[email protected]" \
--password "abcd efgh ijkl mnop" \
--filepath "~/Backups/iCloud/" \
--services "drive,photos"
The first time you will need to enter your 2FA code manually.
Hint: You can schedule this in a cronjob for automated backups.
Docker
If you prefer Docker, this is an example how to run:
$ docker run -it \
--env ICLOUD_BACKUP_USERNAME="[email protected]" \
--env ICLOUD_BACKUP_PASSWORD="abcd efgh ijkl mnop" \
--env ICLOUD_BACKUP_FILEPATH="/backups" \
--volume="~/Backups/iCloud/:/backups/" \
ghcr.io/weejewel/icloud-backup
Hint: when automating this within a cronjob, remove
-it
after the first run.
Credits
Most hard work is done by @foxt in icloud.js. Please sponsor them!
Also see
Looking to backup Google Mail, Calendar & Contacts in a similar way? See Google Backup.