Setting up a duplicates scan

Pick folders, press Find Duplicates, and the defaults apply. This page is for changing them — how to carve folders back out of what you picked, and every control in Scan parameters, what it defaults to, and what you give up by changing it.

Excluded folders

Under Selected folders, on the setup screen itself, is a second list: Excluded folders. It carves specific folders out of the ones you picked, and what it carves out is not opened, hashed or counted.

While it is empty it reads Nothing is excluded — all of each selected folder is scanned, with an Exclude a folder… button beside it. Once there is one, the line is replaced by a strip of tiles — struck-through name, parent folder underneath, so Archive and Archive are told apart — and a + tile to add the next.

An exclusion has to sit inside something you selected, and DuoBolt says so at the moment you pick rather than silently keeping a rule that can never fire:

• Picking a folder you selected as a scan root is refused — excluding it would cancel it out and leave nothing to scan there. Remove it from Selected folders instead, or exclude a subfolder of it.
• Picking a folder outside every selected root is refused too, because it would not change what gets scanned. Add the folder that contains it first.

Exclusions live with the scan you set up: Duplicates and Similars keep their own lists, and both are saved into the setup that Scan History replays.

Excluded, skipped, or protected?

Three different things, and the difference is what happens to the files:

• Excluded folders — this section. Specific folders, chosen by hand, that the scan never enters.
• Skip folders — rules rather than a list: by name, by folder extension, or the built-in NAS and Library sets. One rule prunes every folder that matches it, anywhere in the scan.
• Protected folders — the opposite end. Those folders are scanned and their files appear in the results; what they can never be is selected for removal.

Exclude a folder when its contents are noise. Protect it when its contents matter and you want to see them without any risk of losing them.

---

The info card

Before you scan, the Filters row under the folder lists summarizes the setup in chips: the size range, the file types, and only the settings that deviate from the defaults. A chip opens Scan parameters at the page that holds it. If it says nothing about symlinks, symlinks are at their default.

The status line reads Ready to scan 3 folders, or No folders selected.

---

Scan parameters

The dialog has three pages, chosen on its left rail: Files holds what a file must be to enter the scan (size range, extension filter, ignore options), Folders where the walk does not go (skip folders), and Advanced how it is read (symlinks, performance, cloud files). Each filter chip on the setup screen opens the dialog at the page that holds it.

File size range

Two handles over a fixed ladder, from 1 KiB to Unlimited. It defaults to 64 KiB and up.

That default is the one worth knowing about: everything smaller — small text files, config files, and every zero-byte file — is outside the scan entirely. Drag the lower handle to 1 KiB if that is what you want to find.

An upper bound is occasionally useful in the other direction: cap it to exclude the video files you already know about and let the scan finish sooner.

File extension filter

A dropdown — Include or Exclude — and a token field: Type extensions (e.g. jpg, mp3, pdf). The two are exclusive; choosing one clears the other.

With Include set, a scan restricted to jpg, heic, raf does not stat the rest of the disk.

Caution

With an include list set, files with no extension at all are skipped.

Ignore

Toggle	What it skips	Default
System files	.DS_Store, Thumbs.db, desktop.ini, etc.	On
Hidden files	Files starting with . or flagged hidden	On
Hidden folders	.git, .svn, .cache, etc.	On

Turning these off is how you get the widest possible scan — and a lot of noise you almost certainly do not want to clean.

Skip folders

Library containers (on) — skips ~/Library/Containers and ~/Library/Group Containers.

NAS & system folders (on) — skips the snapshot, recycle and thumbnail folders that Synology, QNAP and TrueNAS keep inside shares. Its help text gives the reason: snapshot copies are identical to your files, so scanning them invents duplicates.

Names — a token field, e.g. node_modules, .git.

Extensions — a token field, e.g. app, bundle. This is the one that handles packages and bundles: a folder whose extension matches is pruned along with everything inside it. On macOS, app, photoslibrary, aplibrary and imovielibrary are the common ones — they look like single files in Finder but are large directory trees full of internal near-copies.

Everything here is a rule, matched against every folder in the scan. To keep one particular folder out — this Backups, not every folder named Backups — use Excluded folders on the setup screen instead.

Symlinks

Follow symlinks (off) — may increase scan time and duplicate count.

Collapse symlinks (on) — treat symlinks as originals in duplicate detection. With it on, a file reached by several links is admitted once. This is also what keeps hardlinks from appearing as duplicates of themselves; see what DuoBolt does not claim.

Performance

Two-stage scan (on) — faster duplicate detection by hashing files in two passes. It changes speed only, never results.

Detect APFS clones (on, macOS) — avoid counting files that share storage on APFS as recoverable duplicates. Explained in full under APFS clones.

Cloud files

Download cloud-only files (off) — download files kept only in iCloud, Dropbox or OneDrive to compare them. Off, a file that lives only in the cloud is left where it is and not compared. The results say how many were left out — 38 cloud-only files not checked — and offer to download them and scan again.

---

Resetting

Each page shows on the rail how many of its parameters differ from their defaults, and each changed parameter is marked on its page with a bar beside it. The footer counts them all — Reset 1 change, Reset 3 changes — and puts every one back; it appears only when something is actually non-default. A slider also carries its own reset button. If a page shows no count, nothing on it has been touched.

---

Running it again

You do not have to rebuild a setup you have used before. Scan History keeps every scan with its full configuration — folders, size range, extensions, options — and Run again repeats it exactly. See history and restore.

Next

Reading the results — filters, sorts, bulk rules, and the two numbers in the footer.

On a NAS

DuoBolt for NAS — mounts, caching, and what to exclude on a share.