iCloud Photos Downloader: Indexing State Retry Fix

A single pull request on October 14 addresses repeated download failures caused by Apple's indexing check returning running for ready libraries. The fix adds retries before failing, restoring reliability for most runs.

Duration: PT2M2S

Episode overview

This episode is a short developer briefing from iCloud Photos Downloader.

It explains recent repository work in plain language.

  • Show: iCloud Photos Downloader
  • Published: 2026-10-14T13:30:22Z
  • Audio duration: PT2M2S

Transcript excerpt

This excerpt keeps the crawler page concise. Listen to the episode or use the RSS feed for the full update.

Good morning, it's October 14th, 2026, and this is your iCloud Photos Downloader briefing.

To be direct: there is no broad sweep today — just one focused, high-impact reliability fix that decides whether your photos download at all.

Since around October 12th, Apple's indexing state check for primary sync has become flaky. For libraries that are ready, it often returns running with zero progress, then finished if you ask again. The problem, documented in issue 1387, is that photo library setup checked only once. A single running response…

Pull request 1388 addresses that by adding retries before failing. Instead of trusting the first response, the downloader now re-checks the indexing state up to a set retry limit, giving Apple's backend a chance to return the correct finished state. That small change matters for reliability: it turns most runs from…

For developers, the takeaway is straightforward: do not assume a single backend status response is authoritative when the service has shown intermittent behavior. Defensive polling with bounded retries avoids unnecessary failures while keeping startup fast in the normal case. It also reduces support noise from users…

What's next is…

Nearby episodes from iCloud Photos Downloader

  1. Weekly Recap - Trustworthy Failures and Sign-In Control
  2. Safer Sign-In Proposal
  3. Clearer Login Failure Instead of Crash
  4. Fixing Silent Successes
  5. Weekly Recap - Retention Safety and Proposed Project Reset
  6. Repository Reset Around Photo Curator
  7. Smarter Deletion Age Logic
  8. Weekly Recap - Rethinking Auto-Delete Safety