guide · sync

Synchronize two folders on Windows, with a preview

Two folders should hold the same files: your work folder and the copy on a USB stick, a project and its backup on the NAS. Diffoniq compares them first, then shows a list of every copy, rename and deletion it would make. Nothing happens until you click Execute, and then exactly that list is carried out.

The short version: open both folders in Diffoniq, choose File → Synchronize..., pick Mirror or Update and the direction, read the list, click Execute. For a nightly run, the same plan comes from the command line with /sync.

1. Compare the two folders

Press Ctrl+O, choose the two folders and confirm; or select both in File Explorer and use the right-click entry. Diffoniq lists the files that differ, the files on one side only, and files it recognized as renamed or moved. How to read that list: Compare two folders on Windows.

Diffoniq folder comparison of W:\work against W:\stick: new.txt only on the left, changed.txt different, old-only.txt only on the right, report-2026-q3.txt matched with report-q3.txt in the docs folder, touched.txt and same.txt identical
Before the sync. One changed file, one new, one only on the stick, one renamed. touched.txt has a newer date on the stick but the same content, so it counts as identical.

The synchronization works from this comparison, so it needs all subfolders. That is how Diffoniq is set up out of the box; if you have switched off Look in Subfolders or limited its depth, the Execute button stays disabled and the dialog says why. A sync built from a partial scan could delete folders whose contents were never looked at.

2. Check the plan

Choose File → Synchronize.... The dialog builds its plan from the comparison already on screen, without reading the folders again. Three choices; mode and direction change the list at once:

The Synchronize Folders dialog in Mirror mode, left to right, from W:\work to W:\stick, listing one rename, a copynew, a copy and one deletion, with the summary line and the Execute button
Mirror, left to right. The renamed report is renamed on the stick instead of copied again.

Every line of the list is one operation: copynew for a file the target does not have, copy for a changed one, rename, delete, and skip with its reason. The summary line counts them. A pair whose content check is still running in the background is listed as skipped, never copied blindly: let the comparison finish and open the dialog again.

3. Mirror or update

Mirror (copy + delete)Update (copy only)
New and changed filescopied to the targetcopied to the target
Files only in the targetdeleted (Recycle Bin)left alone
Renamed or moved filesrenamed in the target, not copied againcopied under the new name; the old one stays
Afterwardsthe target is the same as the sourcethe target has everything the source has, and possibly more

Use Mirror for a backup that should look exactly like the original. Use Update when the target collects files and nothing there may disappear. There is no two-way mode: each run goes in one direction.

4. Execute

Execute carries out the listed operations, one after the other, with a progress dialog. You can cancel between two operations; what is done stays done, the rest is not run. Afterwards Diffoniq reads both folders again, so the comparison shows the result.

Which files count as changed? The same ones the comparison shows as different. With the factory settings Diffoniq ignores timestamps and checks files of equal size by their content, so a file that was only touched is not copied again. Settings such as Ignore Case or the Exclude fields apply as well.

5. Every night, from the command line

The same synchronization runs without a window. DiffoniqC.exe next to Diffoniq.exe waits for the result, prints the log and returns an exit code. Without --execute nothing is touched: the run only lists its plan.

DiffoniqC.exe /sync D:\work E:\stick\work --mirror --content

On the two folders from above, the plan reads (paths shortened):

mode=mirror criterion=content execute=no (dry-run) permanent=no (recycle bin) gitignore=no
plan: 0 mkdir, 1 rename, 1 copy-new, 1 copy-changed, 1 delete, 0 skip (17 bytes to copy)
  rename  "docs\report-q3.txt" -> "docs\report-2026-q3.txt"
  copynew "new.txt" (8 bytes)
  copy    "changed.txt" (9 bytes)
  delete  "old-only.txt"
dry-run: no changes were made (--execute to apply)

When the plan is right, add --execute. Run again afterwards, and it reports no differences - nothing to do with exit code 0.

Exit codeMeaning
0no differences, nothing to do
1differences found; with --execute: synchronized
2finished with errors, for example a locked file; the rest was done
3invalid arguments, or stopped before the first operation

Why --content? Without it, the command line decides by size and timestamp: a file whose date changed counts as changed and is copied, even if its content is the same. In the run above without --content, touched.txt was listed for copying as well. With --content, files of equal size are compared by content, and repeat runs take the result from Diffoniq’s hash cache. The window’s timestamp settings do not carry over to the command line; with --content it plans the same list as the window with its factory settings, in Mirror and in Update.

To run it every night at 02:30 with the Windows Task Scheduler:

schtasks /create /tn "Nightly backup sync" /sc daily /st 02:30 ^
  /tr "\"C:\Program Files\Diffoniq\Diffoniq.exe\" /sync D:\work \\nas\backup\work --mirror --execute --log D:\logs\work-sync.log"

That is the installer’s path; the portable version runs from the folder you unpacked it to. Run the same command once without --execute and read the log before you arm the task. The plan can also be written as JSON for a script (--format json --out plan.json). In Git Bash, write --sync instead of /sync. All switches: Folder Synchronization in the help, and more on scripts in Compare folders from the command line.

Good to know

Without Diffoniq

Windows has robocopy in the command prompt: robocopy source target /MIR mirrors a folder, and /L lists what it would do. There is no preview window, deleted files do not go to the Recycle Bin, and a renamed file is copied again under its new name while the old one is deleted; we checked that on the same two folders. FreeFileSync is a free tool built for synchronizing; our comparison page shows how it differs from Diffoniq, with the date we checked.

Questions

Can Diffoniq synchronize in both directions at once? No. Each run goes one way: left to right or right to left, as Mirror or as Update.

Where do deleted files go? To the Recycle Bin, unless you tick Permanent or use --permanent. On a network drive, a USB stick or a memory card they are deleted for good.

I renamed a large file. Is it copied again? In Mirror mode, no: Diffoniq recognizes it and renames the copy in the target. In Update mode it is copied under the new name.

Can I see what will happen before anything changes? Yes. The dialog shows the full list before Execute; the command line changes nothing without --execute.

Does it need a licence? Not during the 30-day trial; synchronizing works fully there.

Try it on your own folders

Diffoniq runs on Windows 10 and 11, 64-bit. Every feature is available for 30 days before you decide.

Windows is a trademark of Microsoft Corporation. FreeFileSync is a trademark of its respective owner. Diffoniq is not affiliated with any of them.