# boredazfcuk/docker-icloudpd

An Alpine Linux container for the iCloud Photos Downloader command line utility

Repository: https://github.com/boredazfcuk/docker-icloudpd
Canonical: https://ross.abutalabs.com/products/docker-icloudpd
Language: Shell
License Family: other
Topics: icloud, apple, photos, docker-container
Last push: 2026-05-30T21:13:25+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 85, release rhythm 35, longevity 100
- inputs: {"age_days": 2556, "days_push": 95, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2931, forks 231 (observed 2026-08-28T04:07:30.667299+00:00)

## What it is
An Alpine Linux Docker container wrapping the iCloud Photos Downloader (icloudpd) utility for syncing iCloud photo libraries to a local server. It supports secure credential storage, HEIC to JPG conversion, remote re-authentication via Telegram, and optional Nextcloud upload/delete syncing.

## Use cases
- back up all my family's iPhone photos to my home server
- automatically download iCloud photo library to a NAS
- convert HEIC photos to JPG during sync
- re-authenticate iCloud 2FA cookie remotely via Telegram
- sync downloaded photos to Nextcloud
- schedule periodic iCloud photo downloads in Docker

## When to choose
- you want a single location backing up photos from multiple Apple devices
- you run a self-hosted Docker environment and want automated iCloud photo syncing
- you need HEIC to JPG conversion and notification integrations like Telegram or Discord

## When to avoid
- you have Apple Advanced Data Protection (ADP) enabled, which is unsupported
- you need a GUI photo management tool rather than a headless sync container
- you don't use Docker or a Linux-based server

## Facets
- artifact type: application
- maturity: active
- function: file-system, workflow-automation, scheduling, image-processing
- domain: apple-ecosystem, self-hosted
- platform: self-hosted
- tags: icloud, icloudpd, photo-sync, heic-conversion, alpine-linux, multi-factor-authentication, telegram-bot, nextcloud-upload, notification, photos, backup, docker, linux

## Member repositories
- boredazfcuk/docker-icloudpd (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:30.667299+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:47:39.061114+00:00, confidence not recorded.
  - readme: https://github.com/boredazfcuk/docker-icloudpd (fetched 2026-08-28T04:07:30.667299+00:00, sha f6a145f67215)
- Data as of 2026-08-30T08:39:29.467469+00:00.