DupShelf

DupShelf

Find duplicate photos on Mac in your browser

Mac users often store libraries in Photos.app, iCloud Drive, and exported Lightroom folders—plus a Downloads folder full of AirDrop and chat saves. DupShelf does not replace Photos’ cloud intelligence; it cleans folders on disk with exact byte matching. Use Chrome or Edge on macOS (not Safari) for full folder scan and optional move-to-folder.

Use Chrome or Edge on macOS

Safari lacks the folder-picker workflow DupShelf needs at scale. Install or use Chrome/Edge, open the workbench, grant folder access, and scan. Apple Silicon and Intel Macs both work; performance scales with SSD speed and RAM.

Photos app vs folder scan

The Photos library database is not directly opened. Export albums, copy Masters, or scan ~/Downloads and ~/Pictures where loose files live. For iCloud Photos, ensure originals are on this Mac before scanning synced paths.

Common Mac duplicate sources

Exact mode groups only byte-identical files.

  • AirDrop saves twice with different names
  • Lightroom or Capture One export folders duplicated after backup
  • iCloud Drive conflict copies
  • Screenshots and meme folders in Downloads

Cleanup in Finder

Move duplicates to dupshelf-duplicate-images, open in Finder gallery view, verify, then move to Trash. Empty Trash only after a backup if the archive is irreplaceable.

Before Time Machine or NAS backup

Dedup on disk first to shrink the next backup snapshot and reduce sync time to a home NAS.

Mac mini and Studio displays

Headless Mac minis used as family media servers can run Chrome remotely via screen sharing. Scan the SMB-mounted photo share from the Mac that has Chrome installed with local folder access to the mount.

Apple Silicon vs Intel Macs

M-series Macs hash large folders quickly thanks to fast SSDs and efficient CPUs. Older Intel Macs with spinning internal drives benefit from scanning a copied folder on an external SSD first. Close Final Cut, Xcode, and photo apps during multi-hour scans to avoid memory pressure. macOS will not pause DupShelf’s tab if you switch spaces, but sleep will—disable sleep on power adapter for overnight jobs.

Migrating libraries between Macs

Before Migration Assistant or manual copy to a new MacBook, dedup on the old machine’s source folders. You avoid carrying a decade of WhatsApp-forwards-in-Downloads to pristine hardware. After migration, one verification scan on the new Mac catches duplicates introduced during copy if the same folder was merged twice.

iCloud Drive path on Mac

Photos in iCloud Drive under ~/Library/Mobile Documents may need originals on this Mac. Scan only when files are local bytes.

CleanMyMac and other utilities

Mac cleaners vary in duplicate logic. DupShelf gives explicit groups and keeper choice with no install—useful when you avoid another subscription app.

Summary and next steps

Mac users should treat DupShelf as a filesystem tool, not a Photos.app replacement. Export, scan, verify, delete—then let iCloud or Photos sync catch up if you use those services. Time Machine will thank you for smaller source folders. If you use Lightroom Classic, dedup before import to keep catalog previews smaller. For creative pros on MacBook Pro, scanning from the internal SSD is fastest; avoid scanning directly from slow SD readers when a copy to SSD is easy. macOS permissions prompts are normal: you are granting access to your chosen folder only. If move fails, check Full Disk Access settings for Chrome under System Settings. Keep a bootable backup before aggressive delete on a lifetime archive. The goal is the same on every OS: provable duplicates removed, unique photos untouched. Use Chrome or Edge, not Safari, for the full folder workflow. Scan loose folders before blaming Photos.app storage.

Questions

Will this merge with Apple Photos?
No direct integration. Scan exported or loose folders you control.
Does it work on MacBook Air 8 GB RAM?
Yes for moderate folders; scan Downloads first or split large libraries.
iCloud-only thumbnails?
Files must be present as bytes on disk. Download originals first.
Can I scan an external APFS drive?
Yes when mounted and readable by Chrome.
Is Safari support coming?
Folder scan depends on browser APIs Safari does not expose the same way. Use Chrome/Edge for now.
Will DupShelf modify iCloud sync?
Only files in folders you grant write access to when using move.
Rosetta or Apple Silicon difference?
Chrome runs natively on Apple Silicon; scanning speed follows disk and CPU, not Rosetta.

Related guides