Ross ROSS = Recommend OSS · open-source software intelligence for agents

mandarons/icloud-docker

Dockerized iCloud Client - make a local copy of your iCloud documents and photos, and keep it automatically up-to-date. observed · 2026-08-28

github.com/mandarons/icloud-docker · Python · BSD-3-Clause (permissive) observed · 2026-08-28

Health v2 · maintenance only

98/100

  • Activity 99
  • Release rhythm 96
  • Longevity 100
How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.

  • gap_med: 16
  • age_days: 2024
  • days_rel: 26
  • days_push: 7
  • n_releases_24m: 10

Full methodology

Adoption not part of the score

1868 stars · 73 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Dockerized iCloud client that periodically downloads iCloud Drive documents and photos to a local directory, keeping the copy up to date. It is a one-way sync tool (download only) built in Python on top of the iCloudPy library, with an optional web UI.

Use cases

  • back up my iCloud photos to a local server
  • keep a local copy of iCloud Drive documents in sync
  • run an iCloud sync client on a home server with docker-compose
  • download iCloud files to a NAS without installing iCloud on a Mac
  • automatically mirror specific iCloud folders on a schedule
  • get iCloud content into a local backup pipeline

When to choose

  • you run a Docker-based home server or NAS and want iCloud content locally
  • you need scheduled, automatic one-way downloads of iCloud Drive and photos
  • you want a headless client configurable via YAML and environment variables

When to avoid

  • you need to upload or make two-way sync of local files to iCloud
  • you want a native desktop iCloud client with real-time Finder/Explorer integration
  • you are not comfortable running containers or managing app-specific iCloud passwords

Facets

application · maturity active

backup file-system scheduling self-hosted developer-tools files self-hosted cloud-computing self-hosted cross-platform icloud file-sync docker-container photos-backup one-way-sync python automation docker linux

1 source

Member repositories

RepositoryRoleHealth v2
mandarons/icloud-dockermain98

For agents

markdown · JSON · MCP: product_card(name="mandarons/icloud-docker")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem