iCloud Photos Downloader: Shared Master Duplicate Fix

A single correctness fix dominates today. PR #1394 addresses missing downloads when multiple assets share one master image, a case that also caused paging overlap and repeated photos.

Duration: PT1M58S

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-24T13:19:28Z
  • Audio duration: PT1M58S

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 Saturday, October 24th, 2026, and this is your iCloud Photos Downloader briefing.

There's no broad sweep across the codebase today — a single, focused correctness fix carries the day, and it affects whether duplicated photos actually get downloaded.

That fix is pull request 1394, addressing issue 1393. The problem was in how the photo album listing assembled results from iCloud. The code grouped asset records by their underlying master image, and yielded one result per master.

That works when each photo has its own master, but not when several assets share one. Apple's Photos Duplicate feature does exactly that — iCloud returns the master image once, with each duplicate asset listed separately. Under the old logic, only the last duplicate in the group survived.

Paging made it worse. The client advanced its offset once per master, while the service counts once per asset. That meant the next page started inside the current page, pulling in an unrelated photo a second time. Because one photo went missing and another was repeated, the total count still looked right, which hid…

For developers and users, the impact is reliability. Duplicate detection, backup…

Nearby episodes from iCloud Photos Downloader

  1. Safer Deletes and Leaner CI
  2. Critical Trust Fix and Python 3.14 Move
  3. Staying Buildable and Fixing Trust
  4. Weekly Recap - Advanced Data Protection Access, Duplicate Handling, and CI Maintenance
  5. Advanced Data Protection Unlock
  6. Weekly Recap - Reliability Fix for Indexing False Positives
  7. Indexing State Retry Fix
  8. Weekly Recap - Trustworthy Failures and Sign-In Control