How boredazfcuk/docker-icloudpd works
docker-icloudpd is a Dockerized iCloud Photos backup and synchronization service. Its main workflow is syncing photos from iCloud to local storage, with documented HEIC conversion and optional Nextcloud upload/delete synchronization. Separate capabilities include credential storage, local and Telegram-based reauthentication, Telegram-triggered sync, and notifications. The README documents these behaviors, but no runtime source excerpts were supplied, so links between scripts and feature implementations are limited to relationships the documentation states explicitly.
Main entry points: sync-icloud.sh iCloud photo sync · reauth.sh Local reauthentication · launcher.sh Container launcher · authenticate.exp Authentication setup
Components 14
Photo sync
- Container launcher
launcher.sh - iCloud photo sync
sync-icloud.sh - Local photo files
- HEIC conversion
sync-icloud.sh - Container health check
healthcheck.sh
Authentication and messaging
- System keyring
- Authentication setup
authenticate.exp - Local reauthentication
reauth.sh - Telegram bot
- Telegram messaging
sendmessage.sh
Storage and notifications
- Nextcloud
- Notification services
Other components
- Container operator
- iCloud Photos
Connections 15
- Container operator → Container launcher: starts container
- Container launcher → iCloud photo sync: runs sync
- iCloud photo sync → iCloud Photos: downloads photos
- iCloud photo sync → Local photo files: writes files
- iCloud photo sync → HEIC conversion: converts HEIC
- iCloud photo sync → Nextcloud: uploads and syncs deletes
- HEIC conversion → Local photo files: creates JPGs
- HEIC conversion → Nextcloud: uploads JPGs
- Authentication setup → System keyring: stores credentials
- Local reauthentication → iCloud Photos: renews authentication
- Telegram bot → iCloud photo sync: requests sync
- Telegram bot → Local reauthentication: submits MFA code
- Telegram messaging → Telegram bot: sends messages
- iCloud photo sync → Notification services: sends notifications
- Container operator → Local reauthentication: runs locally