# Photos found on the drive

Source: https://frameleaf.app/docs/using/photos-found-on-the-drive/

Sometimes a photo's file is on the drive but no library lists it. Usually an upload was cut off, or a file was renamed or moved outside Frameleaf. Each night Frameleaf looks through its folders for these files, reads each one once and sorts it by itself. **Photos found on the drive** shows you what it found as pictures, what it did with each one, and lets you undo it.

Nothing is moved, renamed or deleted to do this. A file that hasn't changed is never read twice.

This page is for administrators.

## Open Photos found on the drive

Open **Library Care** at the bottom of the sidebar, then **File checks**. When the **Files not in a library** check has found something, its list says how many files weren't in a library and what became of them. Select **See the photos**.

**See found photos**, beside **Put found photos back by themselves** in File checks, opens the same page. It's also in search: type **Photos found on the drive**.

The top of the page says where things stand:

- **Every file on the drive is in a library** when nothing has been found.
- **Looking for files that aren't in a library** or **Sorting files found on the drive** while a check is running. Photos show up as they are sorted.
- **12 photos are back in the library**, for example, with how many files need a decision from you.
- **Nothing needs you** when every file was sorted and nothing is waiting.

## What Frameleaf does with each file

Frameleaf reads each photo or video once and compares its contents with the photos in every library. Each file ends up in one of four lists.

| List | What it means |
| --- | --- |
| **Put back** | The file's contents match a photo your library listed as missing. The file was on the drive all along, under another name or in another folder. The photo is joined to its file again, and its albums, people and edits are kept |
| **Added** | No library had this photo. It was added to the library of the account whose folder it was in. The file was left where it was |
| **Spare copies** | The file has the same contents as a photo that is already in a library. It is left on the drive until you delete it |
| **Needs you** | Frameleaf won't guess with these. They wait for a decision from you |

Choose a list with **Show** at the top: **Needs you**, **Put back**, **Added** or **Spare copies**. Each shows how many files it holds. The files are shown as a grid of pictures. **Show more** loads the next ones.

## See what happened to a file

Select a picture to see that file's history. It lists what the file is now, whose library it is in, where it was found and its size. Under **What happened**, every step is listed in order, for example:

1. **Found a file not in a library**: the nightly file check found it in Frameleaf's folders.
2. **Read it once**: its contents are remembered, so it isn't read again unless it changes.
3. **Put it back**: its contents match a photo that was missing. Your library uses this file now. Nothing was copied, moved or renamed.

**Open in library** shows a photo that was put back or added in its place in the library.

## Undo

Anything Frameleaf did by itself can be undone from the file's history.

- **Undo**, on a photo that was put back, lists the photo as missing again. The file stays where it was found.
- **Take out of library**, on a photo that was added, takes the photo out of the library. The file stays on the drive, where it was found.

Either way, the file is not sorted again unless you ask. The line that confirms the Undo has a **Sort it again** button, and so does the file's history. Frameleaf then treats the file as if it had just been found.

## Needs you

**Needs you** groups the files that wait, and asks for one decision per group, not one per photo. **See all** shows every picture in a group.

| Group | Why it waits | What you can do |
| --- | --- | --- |
| **Files in a folder no account uses** | The folder belongs to no account on this server, so Frameleaf can't tell whose photos these are | Under **Whose library these photos go to**, choose an account, then select **Add photos** (the button counts them) |
| **Files that would put someone over their storage limit** | No library has them, but the account has no room for them | **Add them anyway** adds them this once. **Change the account's limit** (the button names the account) opens that account, where you can raise its limit |
| **Files waiting to be sorted** | **Put found photos back by themselves** is switched off, so these were read and are waiting | **Sort files now** (the button counts them) puts back, adds or sets aside each one, as Frameleaf would have done by itself |
| **Files that won't open** | They are named like photos, but they can't be read, so Frameleaf can't tell what they are | They are kept on the drive. Select **Download them** to get them all in one archive, or open one and select **Download** |

After a decision, the page says how many photos are in the library now, how many were spare copies and how many still wait.

## Spare copies

A spare copy is a second copy of a photo that is already in a library. Frameleaf does nothing with spare copies until you say so. You can leave them where they are.

To free the space:

- **One copy.** Select its picture, then **Delete this copy…**, then **Delete the copy**.
- **All of them.** Select **Delete spare copies…** under the list (the button counts them). Frameleaf says how much space this frees and asks you to confirm.

Each copy is deleted only after the photo it copies is read again and opens. If that photo can't be checked, the copy is kept, and the page tells you how many were kept. Only the spare copy is deleted. The photo in the library, its albums and its edits are not touched.

:::caution
Deleted copies do not go to Trash, so this can't be undone.
:::

## Other people's photos

You never see another account's pictures on this page. In place of the picture there is a lock and whose photo it is, for example **Sam's photo**. The file's history says **Only Sam sees this photo**, and has no **Undo**.

What was done with that photo can be undone by an administrator signed in as that person.

## Tidied without asking

Two kinds of file are tidied without asking. They are never listed for review. When there are any, **Tidied without asking** says how many.

- **Previews for photos that are gone.** These are small copies Frameleaf made for photos that have since been deleted. They can always be made again from an original, so they are cleared. The page says how much space was freed. An original is never cleared.
- **Edit-detail files beside their photos.** An XMP file holds a photo's rating, keywords and edits. An XMP file beside a photo of the same name, such as `photo.jpg.xmp` or `photo.xmp` beside `photo.jpg`, is joined to that photo. If two files in the folder share that name, such as `photo.jpg` and `photo.mov`, a `photo.xmp` is left alone. Nothing is moved. See [XMP sidecars](https://frameleaf.app/docs/using/xmp-sidecars/).

## What Frameleaf does by itself

Two switches at the bottom of the page decide what Frameleaf does by itself. Both are on to begin with. Frameleaf acts after each night's file checks, and as soon as a file is found. As with other settings, a change waits until you select **Save changes**.

| Switch | On | Off |
| --- | --- | --- |
| **Put found photos back by themselves** | A photo that went missing is joined to its file again, and a photo no library has is added. Either can be undone | Found photos wait in **Needs you**, and nothing joins the library until you choose |
| **Clear previews for photos that are gone** | Previews Frameleaf made for photos that are gone are cleared. Only files Frameleaf made itself | Those previews are left on the drive |

**Put found photos back by themselves** is also in **File checks**, under **When a check finds a problem**.

## Good to know

- **An original is never deleted to tidy the drive.** Spare copies and files that won't open stay where they are until you delete them yourself.
- Each file is read once and remembered, so the drive isn't read again for the same answer.
- To stop looking for these files altogether, turn off the check's **Look for …** switch in **File checks**, under **What is checked**. Photos left off the library then won't be noticed.
- **Check now**, beside **Files not in a library** in File checks, looks straight away instead of waiting for tonight.

## Related

- [Library Care](https://frameleaf.app/docs/using/library-care/): the rest of Library care.
- [Damaged and missing files](https://frameleaf.app/docs/using/damaged-and-missing-files/): what Frameleaf does when a photo's file is damaged or missing.
- [System integrity](https://frameleaf.app/docs/admin/system-integrity/): what the nightly file checks look at.
- [Library care settings](https://frameleaf.app/docs/admin/system-settings/#photos-found-on-the-drive): every setting, with its name in the configuration file.
