If your Photos library won't open or the ‌Photos‌ app is exhibiting odd behavior on your Mac, the ‌Photos‌ Repair Library tool may fix the issue. Keep reading to learn how it works.

photos
The Repair Library tool is a hidden utility in macOS that analyses your photo library's database and repairs any inconsistencies it detects. The tool isn't guaranteed to fix all problems that can arise with photo libraries, but it is worth giving it a go before contacting Apple Support.

Before you use the ‌Photos‌ Repair Library tool, make sure you have a local backup of your photo library, either by using Time Machine or a third-party backup solution, ideally with an external drive. By default, your photo library is stored in the Pictures folder within your home folder.

If you're repairing a library that's used with iCloud Photos, iCloud will check the library after the repair process has completed to ensure everything has synced correctly.

How to Launch the Photos Repair Library Tool

  1. If ‌Photos‌ is open, close the app.
  2. While clicking the ‌Photos‌ icon to open the app, hold down the Command and Option keys at the same time.
  3. In the window that opens, click Repair to begin the repair process. Enter your user account password if prompted.
  4. Wait while the repair process completes.

photos repair tool

Depending on the size of your library, the repairs may take some time. When the process has finished, ‌Photos‌ will open the library, and with a little bit of luck, any unexpected behavior will have been resolved.

Popular Stories

iPhone 17 Pro Dark Blue and Orange

iPhone 17 Release Date, Pre-Orders, and What to Expect

Thursday August 28, 2025 4:08 am PDT by
An iPhone 17 announcement is a dead cert for September 2025 – Apple has already sent out invites for an "Awe dropping" event on Tuesday, September 9 at the Apple Park campus in Cupertino, California. The timing follows Apple's trend of introducing new iPhone models annually in the fall. At the event, Apple is expected to unveil its new-generation iPhone 17, an all-new ultra-thin iPhone 17...
iPhone 17 Pro Iridescent Feature 2

iPhone 17 Pro Clear Case Leak Reveals Three Key Changes

Sunday August 31, 2025 1:26 pm PDT by
Apple is expected to unveil the iPhone 17 series on Tuesday, September 9, and last-minute rumors about the devices continue to surface. The latest info comes from a leaker known as Majin Bu, who has shared alleged images of Apple's Clear Case for the iPhone 17 Pro and Pro Max, or at least replicas. Image Credit: @MajinBuOfficial The images show three alleged changes compared to Apple's iP...
xiaomi apple ad india

Apple and Samsung Push Back Against Xiaomi's Bold India Ads

Friday August 29, 2025 4:54 am PDT by
Apple and Samsung have reportedly issued cease-and-desist notices to Xiaomi in India for an ad campaign that directly compares the rivals' devices to Xiaomi's products. The two companies have threatened the Chinese vendor with legal action, calling the ads "disparaging." Ads have appeared in local print media and on social media that take pot shots at the competitors' premium offerings. One...
iOS 18 on iPhone Arrow Down

Apple Preparing iOS 18.7 for iPhones as iOS 26 Release Date Nears

Sunday August 31, 2025 4:35 pm PDT by
Apple is preparing to release iOS 18.7 for compatible iPhone models, according to evidence of the update in the MacRumors visitor logs. We expect iOS 18.7 to be released in September, alongside iOS 26. The update will likely include fixes for security vulnerabilities, but little else. iOS 18.7 will be one of the final updates ever released for the iPhone XS, iPhone XS Max, and iPhone XR,...
iphone 16 pro ghost hand

iPhone 17 Pro: 5 Reasons Not to Upgrade This Year

Monday September 1, 2025 4:35 am PDT by
Apple will launch its new iPhone 17 series this month, and the iPhone 17 Pro models are expected to get a new design for the rear casing and the camera area. But more significant changes to the lineup are not expected until next year, when the iPhone 18 models arrive. If you're thinking of trading in your iPhone for this year's latest, consider the following features rumored to be coming to...