Duplicates
Duplicate review: find copies, keep the best and stack bursts Watch on YouTube
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
Section titled “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.
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
Section titled “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
Section titled “Same photo”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.
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
Section titled “Look-alikes”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.
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
Section titled “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.
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
Section titled “Best copy”In the Same photo tab, Frameleaf picks the best copy to keep:
- 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.
- The largest file, when every copy is the same kind of file.
- 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
Section titled “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
Section titled “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, 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.
What happens to albums, favourites and tags
Section titled “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
Section titled “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.
Saving disk space in a family library
Section titled “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.
- 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 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.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.





