# Duplicates

Source: https://frameleaf.app/docs/using/duplicates/

Reclaim space and clear the clutter. Frameleaf finds photos and videos that look the same, even when they're different files, groups them, and suggests the best copy to keep. Duplicate detection runs with machine learning on your server and is on by default.

Exact copies are handled for you automatically: an identical file is never stored twice in your library, whether it came from the web app, a phone or the command-line tool. This works even when your administrator turns duplicate detection off.

## How duplicates are found

- **Photos** are compared by what they look like, so a resized or re-saved copy is still found.
- **Videos** are compared along their whole length, using the 120 frames Frameleaf already makes for the seek bar's previews. The two videos are lined up by time, so a trimmed copy or one that starts a few seconds later is still found, as are copies at a different resolution or quality. Most of the overlapping frames must match, so videos that only share a title card, an intro or end credits stay apart, and black or blank frames are ignored. See [Video scrubbing and previews](https://frameleaf.app/docs/using/video-previews/#how-previews-help-find-duplicate-videos).

Administrators choose how alike photos must be in **Settings**, then **Library care**, then **Duplicates**. **Find look-alike photos** turns the search on or off, and **How alike they must be** is **Nearly identical**, **Balanced** or **Loosely alike**. Looser choices find more groups, and more of them won't really be duplicates. **Advanced: how alike, in numbers** holds the **Photo distance** behind those choices, from 0.001 to 0.1; a number of your own shows as **Custom**.

## Review duplicates

Open **Library Care** at the bottom of the sidebar, or **Settings**, then **Tools**, and choose **Duplicate review**. Items appear here as soon as they've been processed and placed in a duplicate group.

Identical files don't wait for you: they're merged automatically and listed under **Merged for you**, below the review.

Review is split into two tabs, because the two kinds of duplicate need different amounts of care:

| Tab | What's in it | How it works |
| --- | --- | --- |
| **Same photo** | One moment saved as different files: a RAW and its JPEG, an edited export, a copy from a messaging app. | The best copy is already chosen. Most groups take one click. |
| **Look-alikes** | Different moments that look alike: bursts and retakes taken seconds or minutes apart. | Nothing is chosen for you. Pick the shots you want, or stack them and keep every photo. |

Frameleaf puts a group under **Same photo** when its copies were taken at the same instant (or are the very same file), and under **Look-alikes** when they were taken at different times.

### Same photo

[![The Same photo tab: three copies of one landscape side by side, the RAW original marked Best copy and Keep, the JPEG export and messaging-app copy marked Trash, with File, Folder, Taken, Size, Camera, Location and Albums compared below and the decision bar at the bottom.](https://frameleaf.app/shots/docs/duplicates-same-photo-2026-10.jpg)](https://frameleaf.app/shots/docs/duplicates-same-photo-2026-10.jpg)

Every copy in the group is shown side by side, with the best copy marked **Best copy** and already set to **Keep**. Underneath, a table compares the copies row by row: **File**, **Folder**, **Taken**, **Size** (pixels and file size), **Camera**, **Location**, **Albums** and **Source**, such as **Original format**, **Highest resolution** or **Compressed copy**. Rows where the copies differ are highlighted, so you can see at a glance why one copy is better.

- Click a copy, or press its number, to keep that one instead.
- **Zoom** both copies to the same point and move to pan them together. Videos can be played side by side from the start.
- **Keep 1, trash 2** keeps your choice and sends the rest to the trash.

[![Zoom both in the Same photo tab: the original of a boy fishing and a smaller copy from a messaging app, both zoomed to the same point. The original is marked Best copy and Keep, the copy Trash, and the table below shows 6,000 × 4,000 · 2.5 MB against 2,400 × 1,600 · 399 KB, Highest resolution · Largest file · Most metadata against Lower resolution.](https://frameleaf.app/shots/docs/duplicates-zoom-both-2026-11.jpg)](https://frameleaf.app/shots/docs/duplicates-zoom-both-2026-11.jpg)

Got hundreds of groups? **Keep best copy in all** decides every group in the tab at once. Frameleaf tells you how many copies go to the trash and how much space that frees before you confirm. Any group without one clear best copy is left for you to look at.

### Look-alikes

[![The Look-alikes tab: an 18-frame burst of a falcon on a contact sheet, two frames selected as keepers, a large preview of frame 9, a Burst detected · Stack is recommended label, and Stack burst highlighted in the decision bar.](https://frameleaf.app/shots/docs/duplicates-look-alikes-2026-10.jpg)](https://frameleaf.app/shots/docs/duplicates-look-alikes-2026-10.jpg)

Every photo in the group is shown on a contact sheet, however many there are, with a large preview of the one you point at. Each frame shows how many seconds after the first one it was taken.

- Click the frames you want to keep. **Select all** and **Clear** help with long series.
- **Keep 2, trash 16** keeps the frames you picked and sends the rest to the trash.
- **Stack** keeps every photo and groups them into one stack in your library.

[![A four-frame burst of a mountain lake on the contact sheet, frames +0.3 s and +0.5 s ticked as keepers (2 of 4 selected as keepers), a large preview of frame 3, the Burst detected · Stack is recommended label, and Keep 2, trash 2 next to Stack burst in the decision bar.](https://frameleaf.app/shots/docs/duplicates-burst-keepers-2026-11.jpg)](https://frameleaf.app/shots/docs/duplicates-burst-keepers-2026-11.jpg)

Photos taken within a few seconds of each other are marked **Burst detected · Stack is recommended**, and **Stack burst** becomes the main button. Every burst frame stays a real original when stacked, and you can choose the stack's cover later in your library.

### Decide quickly

Review is built for working through thousands of groups:

- The decision bar stays fixed at the bottom of the window, and its buttons never move between groups. Leave your pointer on **Keep** and click again for the next group.
- Each decision takes effect straight away and moves you on. Routine decisions don't ask for confirmation.
- **Not duplicates** keeps every item and takes the group out of review. **Skip** moves on without deciding.
- **Undo** reverses recent decisions, even after you reload the page. **View trash** opens the trash.

[![After Undo, the group is back in the Same photo tab with its best copy still chosen, and the decision bar reads Decision undone. The group is ready to review again.](https://frameleaf.app/shots/docs/duplicates-undo-2026-11.jpg)](https://frameleaf.app/shots/docs/duplicates-undo-2026-11.jpg)

Keyboard shortcuts (press **?** in the review to see them):

| Key | Action |
| --- | --- |
| **1**–**9** | Choose that copy |
| **Enter** or **E** | Keep the chosen copies |
| **K** | Keep the suggested copy |
| **S** | Stack |
| **A** | Not duplicates (keep every item) |
| **←** / **→** | Previous / next group |
| **Ctrl+Z** or **⌘Z** | Undo |

You're always in control: nothing is removed until you choose an action.

### Best copy

In the **Same photo** tab, Frameleaf picks the best copy to keep:

1. **The native original.** A RAW file first, then HEIC or HEIF, over a re-encoded copy such as a JPEG, even when the JPEG is the bigger file. Re-saved and shared copies are often larger but lower quality.
2. **The largest file**, when every copy is the same kind of file.
3. **The copy with the most metadata.**

Camera originals are always suggested first: RAW, then HEIC, over copies that were saved again. You still decide, and you can change any pick before you confirm.

### When the trash is off

If your administrator has turned the trash off, the copies you don't keep are **deleted permanently**. The buttons say **Delete** instead of **Trash**, and Frameleaf asks you to confirm. Stacking keeps every photo.

With the trash on, the space is only freed once the trash is emptied.

## Whose photos are in a group

Duplicate groups only ever contain your own photos, and only you decide what to keep. If some photos in a group are [Locked](https://frameleaf.app/docs/using/private-content/), unlock to review the whole group.

How many groups are waiting also shows as **Duplicate groups** at the top of **Missing files** and **Damaged files** in [Library Care](https://frameleaf.app/docs/using/library-care/).

## What happens to albums, favourites and tags

Keep one copy and you lose nothing. When you keep **exactly one** item and trash at least one other, the details from the trashed copies are merged into the one you keep:

| Detail | What happens |
| --- | --- |
| Albums | The kept item is added to every album any copy was in. |
| Favourite | If any copy was a favourite, the kept item becomes one. |
| Rating | The highest rating is kept. |
| Description | Descriptions from all copies are combined. |
| Visibility | The most restrictive visibility is applied. |
| Location | Copied only if every copy with a location has the same coordinates. |
| Tags | Tags from all copies are combined. |

If you keep more than one item, nothing is merged. Each keeps its own details and they simply leave the duplicate group.

## Duplicates with partners

A partner's copies are skipped when your library already holds the same file, so partner sharing doesn't give you doubles. Duplicates are still detected separately for each person. See [Sharing](https://frameleaf.app/docs/using/sharing/#partners).

## Saving disk space in a family library

Frameleaf also saves disk space by storing identical files once. When the very same file is added twice, by you or by two people, Frameleaf keeps one file on the drive. Each person still sees the photo in their own library, with their own albums, favourites, descriptions, faces, Locked state and permissions. It's purely a storage saving: every account stays private, and no partner sharing is needed.

It's automatic, for the whole server, and there's nothing to turn on:

- **Only files that are exactly the same are merged.** Frameleaf reads each whole file from the drive, and two files are identical only when every byte matches. The oldest copy is kept.
- **If two people have the file, each keeps their own photo.** Your item stays yours, in your timeline, with its own details and its own XMP sidecar.
- **If your own library has it twice, the two photos become one**, and the other goes to the [Trash](https://frameleaf.app/docs/using/trash/).
- **Any merge can be undone.** **Merged for you**, below the duplicate review, lists each merge with **Undo**. Undo puts both back as they were, and Frameleaf won't merge them again by itself.
- **Deleting your copy never removes the stored file** while someone else's item still uses it.
- **Your storage quota works as before.**

Open **Settings**, then **Library care**, then **Duplicates** to see how things stand: **Identical files**, with how much space is saved, and **Look-alike photos**, with how many groups wait for you. **Check again**, beside **Identical files are stored once**, reads every file again. It changes nothing you can see, and every merge it makes can be undone. Anything it couldn't read is listed under **Problems** and left as it is: nothing is merged on a guess.

The copies that are no longer needed wait in [Unused files](https://frameleaf.app/docs/using/library-care/#unused-files) until the server's owner empties it; that's when the space comes back. Files in folders Frameleaf reads but never changes, such as external libraries, are never merged.

For how it works on the drive, see [Physical deduplication](https://frameleaf.app/docs/admin/physical-deduplication/).
