# Library Care

Source: https://frameleaf.app/docs/using/library-care/

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](https://frameleaf.app/docs/using/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](https://frameleaf.app/docs/admin/jobs/#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?".

## What an administrator sees

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**](https://frameleaf.app/docs/using/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](#live-photos), [Missing files](#missing-files), [Damaged files](#damaged-files) and, for the server's owner, [Unused files](#unused-files) |

**File checks** has the three [integrity checks](#for-administrators), **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](https://frameleaf.app/docs/using/photos-found-on-the-drive/). **Duplicates** shows **Identical files**, which are stored once (see [Physical deduplication](https://frameleaf.app/docs/admin/physical-deduplication/)), and **Look-alike photos**, which you review yourself in [Duplicate review](https://frameleaf.app/docs/using/duplicates/).

## What everyone else sees

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**](https://frameleaf.app/docs/using/tidy-up/) and **Duplicates**, and **Tools** has [Live Photo pairing](#live-photos). 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](https://frameleaf.app/docs/using/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.

## Tools

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

| Group | Tools |
| --- | --- |
| **Organize** | [Duplicate review](https://frameleaf.app/docs/using/duplicates/), [Large files](https://frameleaf.app/docs/using/trash/#large-files), Fix locations |
| **Repair** | [Live Photo pairing](#live-photos), and for administrators [Missing files](#missing-files) and [Damaged files](#damaged-files) |
| **Import** | iCloud Photos. See [iCloud Photos](https://frameleaf.app/docs/migrate/icloud-photos/) |
| **Automate** | [Workflows](https://frameleaf.app/docs/admin/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.](https://frameleaf.app/shots/docs/library-care-2026-11.jpg)](https://frameleaf.app/shots/docs/library-care-2026-11.jpg)

*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

**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

**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](https://frameleaf.app/docs/using/tidy-your-albums/#find-it-again-in-library-care).

## Tidy up

**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](https://frameleaf.app/docs/using/tidy-up/).

## Date & Time Doctor

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](https://frameleaf.app/docs/using/date-and-time-doctor/).

### Fix the dates of photos you choose

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](https://frameleaf.app/docs/using/date-and-time-doctor/#fix-the-dates-of-photos-you-choose).

## Other queues

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](https://frameleaf.app/docs/using/private-content/) 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](https://frameleaf.app/docs/using/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

**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](https://frameleaf.app/docs/using/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.

## Missing files

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](#for-administrators) 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.

:::note
"Missing" doesn't always mean deleted. The storage may have moved, be offline or have the wrong permissions, or the path may have changed. Check those first.
:::

## Damaged files

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](https://frameleaf.app/docs/using/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.

### Space used by recovery

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.

## Live Photos

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

**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](https://frameleaf.app/docs/admin/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](https://frameleaf.app/docs/using/damaged-and-missing-files/), the copy can be deleted like any other.

## Who sees what

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.

## Preservation packages

To keep a verifiable copy of your originals and everything your library knows about them, make a preservation package. See [Preservation packages](https://frameleaf.app/docs/using/preservation/).

## For administrators

- **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](https://frameleaf.app/docs/admin/jobs/#nightly-tasks). **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](https://frameleaf.app/docs/using/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](https://frameleaf.app/docs/admin/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](https://frameleaf.app/docs/using/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.
