This repository contains a script for automatic backups of photos and videos from iCloud to local storage. Optional Telegram notifications and iCloud video deleting.
- 🚀 Automatic backup of photos and videos from iCloud to local storage.
- 📲 Optional notifications via Telegram about the progress and summary of the backup.
- 📂 Efficient management of iCloud albums, including the option to empty the 'Recently Deleted' album.
- 🛠️ Support for iCloud's two-factor authentication.
- ⚙️ Customizable Telegram notification feature.
- ⚙️ Customizable iCloud video deleting feature.
- 🐍 Python 3.x.
- 🔐 iCloud credentials. Optional: A Telegram Token for notifications.
- 📥 Clone this repository:
git clone https://github.com/your-user/iCloud-Backup-Tool.git
- 📂 Navigate to the project directory:
cd iCloud-Backup-Tool
- 🖥️ Install the required dependencies:
pip install -r requirements.txt
- ⚙️ Set up your iCloud credentials in the .env file. Optionally, set up Telegram credentials for notifications.
After setting up your credentials, you can run the script to perform backups. Optionally, you can enable Telegram notifications.
🔍 Modify the script's arguments according to your needs to customize the backup process and notification settings.
After setting up your credentials, you can run the script with different arguments according to your needs:
- Perform a backup of the 'All Photos' album and save them in the '/backup/icloud' directory:
python icloud_backup.py --album "All Photos" --destination "/backup/icloud"
- Perform a backup of the 'Vacation' album, delete the videos after the backup, and send a Telegram notification:
python icloud_backup.py --album "Vacation" --destination "/backup/icloud" --delete-videos --send-telegram
🤝 Contributing Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
🧐 Make sure to update the tests as appropriate.
Created with 💖 by Pablo González