Skip to content

Library Care

Library care: keep every photo present, undamaged and duplicate-free Watch on YouTube

Library Care keeps your library healthy. It checks that every original is there and readable, and helps you fix what isn’t with exact, verified copies, never “close enough” ones. It also rejoins split Live Photos and gathers your organising, import and automation tools in one place.

When a photo’s file is damaged or goes missing, Frameleaf tries to fix it by itself first: it repairs damaged photos, looks for an exact copy, restores the original from Cloud Backup and asks your phones. Damaged and missing files lists what it did and what’s left for you. See Damaged and missing files.

When nightly processing leaves photos over because their file is missing or damaged, Recent work in Background work says so, and Open in Library care opens Damaged and missing files. See When some photos are left over.

Open Library Care at the bottom of the sidebar. It opens Settings, then Library care, which starts with Library health: the answer to “is my library all right?”.

An administrator sees the whole household. Library health says Your library is healthy, Not checked yet before the first check, or how many files need attention, for example 5 files need attention with See what was found. When nothing was found, Check now starts the file checks straight away. Below it:

Section What’s there
Needs attention One row for each kind of problem found: missing files (Find them), damaged files and files not in a library (Review). Nothing has been removed; each row opens the place it’s fixed. Shown only when something was found
Look after your library File checks (missing files, damaged files and files not in a library), Things to fix, Tidy up (clutter suggested for the Archive), Duplicates (identical files and look-alike photos) and Search and recognition progress (what is still waiting for faces, captions and search)
Tools Live Photo pairing, Missing files, Damaged files and, for the server’s owner, Unused files

File checks has the three integrity checks, Missing files, Damaged files and Files not in a library, each with its own Check now. Once something was found, Check again runs them all again. Photos found by Files not in a library are put back by themselves; See the photos shows them as pictures, with Undo. See Photos found on the drive. Duplicates shows Identical files, which are stored once (see Physical deduplication), and Look-alike photos, which you review yourself in Duplicate review.

A member sees their own library and no settings. Library health says Your library is healthy when all their photos and videos were on the drive and undamaged when last checked. Look after your library has Things to fix, Tidy up and Duplicates, and Tools has Live Photo pairing. File checks and the Missing files and Damaged files tools are administrator tools. When one of your files is missing or damaged, you see what Frameleaf did about it, and what you can do, in Damaged and missing files.

Things to fix lists what Frameleaf found and suggests, one row per kind, such as Missing files, Damaged files, Live Photos to reconnect and RAW files to match. Missing files and Damaged files open Damaged and missing files, and administrators also see Fixed for you, what Frameleaf fixed by itself this week. Nothing else changes until you choose.

Every tool is also in Settings, then Tools, grouped as Organize, Repair, Import, Automate and Connect.

Group Tools
Organize Duplicate review, Large files, Fix locations
Repair Live Photo pairing, and for administrators Missing files and Damaged files
Import iCloud Photos. See iCloud Photos
Automate Workflows
Connect Mobile apps

The Library care page for an administrator: Your library is healthy with Check now, then Look after your library listing File checks, Things to fix, Tidy up, Duplicates, Album cleanup and Search and recognition progress, each with its state and an Open button.

Library care as an administrator sees it: Library health at the top, then the pages that look after your library. Open one to see what it found. Select the image to enlarge it.

Couldn’t process lists the photos and videos Frameleaf couldn’t finish, such as a file it couldn’t read or make a preview of. It’s a row in Things to fix, with how many files and how many were set aside. Each file has one row, with what went wrong, its name and date, and which step was tried.

A file tried three times is Set aside: “Tried 3 times. It won’t be tried again until you choose Try again.” Nothing is deleted.

  • Try again runs every step that’s waiting for that file. The file leaves the list once it works.
  • Download original gives you the file, for your own photos.
  • Keep as is takes it off the list and leaves the file as it is.

Everyone sees their own files. An administrator sees the whole household, with whose each file is, a filter by person, and a link to what the server recorded for that photo in its logs.

Album cleanup on the Library Care page opens the Magic Albums review of your albums, shows when you last tidied and how many albums have a new suggestion, and has Undo last cleanup. See Tidy your albums.

Tidy up finds memes, receipts, screenshots, shop photos and other clutter and suggests moving them off your timeline to the Archive. You choose which kinds it looks for, review the suggestions in a large view, and nothing moves until you press Archive. It never deletes anything, and it only archives on its own for a kind where you turned on Archive automatically. See Tidy up.

The Date & Time Doctor finds photos that sit in the wrong place on your timeline because a camera clock, a time zone or a missing date was off. It shows each photo’s time before and after, fixes a whole group when you say so, and lets you undo any fix for 30 days. Your original files are not rewritten.

When it has found something, Things to fix has a row, Dates that look wrong, with how many photos. Select it to open the Doctor. Every account has it, for its own photos.

See Date & Time Doctor.

To fix photos you pick yourself, select them in the Library and choose Fix dates. Say whether they were taken in another time zone or the camera’s clock was off, check the before and after, and apply it as one fix you can undo. See Fix the dates of photos you choose.

At the top of Missing files and Damaged files, after the number of findings and the scan bar, you’ll see the other queues waiting for you. Counts respect privacy: another account’s Locked items are never counted, and your own only after you unlock.

Queue What’s in it
Duplicate groups Photos that look the same. See Duplicates
Import review Imported iCloud Photos items that need a decision. Shown when you’re looking at one account, not all accounts
Metadata still to read Items whose details haven’t been read yet

Scan again checks every item in your library: is the original there, and does it read back intact?

  • The scan runs in the background, and you can follow it in Activity and the notifications panel.
  • It saves its place after every small batch, so you can pause, resume or cancel it, close the browser or restart the server, and it carries on from where it stopped.
  • A scan that fails is retried once automatically before the failure is reported. The scan bar shows the last scan, a running one, or a failure.
  1. Select findings and choose Locate originals.
  2. In Choose candidate originals, pick where to look: your library storage, your external libraries and, for administrators, the recovery locations set up on the server. Choose Search selected locations. The search runs in the background.
  3. Review each candidate. It shows where it was found, whether its checksum is an exact match and whether it opens correctly. If a copy was found in more than one place, choose one and Save candidate choices.
  4. Choose Relink verified matches to point each item at its verified copy.

Matches are found by their content checksum, never by file name, thumbnail or video length, so only a true copy of the original is ever relinked. A resized, re-encoded or edited copy won’t match.

Where the copy ends up depends on where it was found. A copy in your library storage, or in the item’s own external library, is linked where it is. A copy in a recovery location is copied into your library storage first; recovery locations are only ever read.

Suspected damage and unsupported RAW files wait for review until a check confirms a problem. You act on Confirmed damaged findings:

  • Recover from a verified copy puts back a copy whose checksum matches the original exactly and that opens correctly. Search your library storage and recovery locations, choose a copy, confirm that you’ve reviewed the evidence and select Record verified recovery. The good copy is placed in a hidden Library Care folder in your library storage, and the damaged file is moved beside it, never over anything, so it’s kept for recovery but never imported again as a new item. A damaged file that another item still uses stays where it is.
  • Trash confirmed damage moves damaged items to the trash. You type MOVE CORRUPT MEDIA TO TRASH, enter your PIN if you have one, and the evidence must be from the last day. Each item is checked again as it’s moved, and one that no longer fails is kept.

A RAW file the server can’t read is listed separately. It isn’t damaged; the server just doesn’t support it.

Relinks, recoveries and moves to the trash run in the background with the same pause, cancel and automatic retry as a scan. Each affected row shows a small loader until the job has dealt with it. Every file is read and verified again at the moment of change, and a finding that changed since you reviewed it is reported instead of applied.

To try a relink, recovery or move to the trash again, start it from Library Care, so its review, confirmation and PIN are checked again.

Kept damaged files and recovered copies take disk space, but they don’t count toward your storage quota: an item’s size doesn’t change when it’s recovered. They’re never removed automatically.

An Apple Live Photo is two files, a still photo and a short video. When they’re uploaded or imported separately, for example from a backup, a desktop sync or another service’s export, they can show up as two unrelated items.

Live Photo pairing, under Repair, finds those separated pairs so you can rejoin them in a batch:

  • Pairs are matched mainly on the identifier Apple embeds in both files, so confident matches are exact.
  • Files whose details were stripped are matched by file name and capture time instead. These are shown as lower-confidence matches for you to review before rejoining.
  • Rejoining hides the standalone video and gives you back one playable Live Photo, as if it had been uploaded intact.

The optional extra audio track some Live Photos carry isn’t part of the rejoined pair.

Unused files, among the Tools for the server’s owner, holds stored files that no photo uses any more, such as extra copies left after physical deduplication merged identical files. Nothing there is deleted automatically: Restore puts a file back in the library it was last in, and Empty Unused files deletes them all from the drive for good to get the space back. It asks first, and can’t be undone.

One kind of file is kept back. When a photo’s own file is missing or damaged and a copy of it is waiting in Unused files, that copy may be the last good one, so emptying leaves it there. The page then says how many files could not be deleted and are still waiting. Once the photo is fixed or you’ve decided what to do with it in Damaged and missing files, the copy can be deleted like any other.

Each person reviews their own findings. Missing files and Damaged files are administrator tools; an administrator can also review one other account, or all accounts.

Another account’s Locked items are never listed, counted or changed, and their thumbnails aren’t shown. Background work, like every server job, can still reach them.

To keep a verifiable copy of your originals and everything your library knows about them, make a preservation package. See Preservation packages.

  • Recovery locations are folders Library Care may search for copies, such as a backup drive. Set them with FRAMELEAF_RECOVERY_ROOTS, for example Verified backup=/mnt/backup/photos;/mnt/photos/recovered, and mount them read-only if you can. A candidate must still be a regular file inside its location when it’s recovered; a link that leads outside it is refused.
  • Hidden Library Care folders. Kept damaged files, and recovered copies that couldn’t be committed because the item changed at the same moment, stay in .library-care folders in library storage. A leftover copy is reused if the recovery is tried again. Review these folders yourself; they’re never cleaned up automatically.
  • Integrity checks run every night in the Check files step of the overnight schedule. Missing files looks for files the library expects that aren’t on the drive, Damaged files for files whose contents have changed since Frameleaf stored them, and Files not in a library for files on the drive that are in nobody’s library. The first two only look. When one finds a damaged or missing file, Frameleaf tries to fix it by itself and lists what it did in Damaged and missing files; Repair damaged photos by themselves, under When a check finds a problem, decides whether damaged photos are repaired straight away. See the results in Settings, then Library care, then File checks, where Check now runs a check straight away. See System integrity.
  • Files not in a library reads each photo or video it finds once and sorts it by itself: a photo that went missing is put back, a photo no library has is added, and a second copy of a photo you already have is left on the drive. Nothing is moved, renamed or deleted, and anything it did can be undone. File checks doesn’t offer to delete these files. See Photos found on the drive.
  • The Missing files tool, the health scan and the count of files not in a library can differ, because each looks at something different.