What Is dupeGuru and What Does It Do?

Updated

dupeGuru is a cross-platform GUI tool for finding duplicate files on your computer. It scans either filenames or file contents, runs on Linux, macOS, and Windows, and adds specialized Music and Picture modes for tag-based and fuzzy image matching. It fits you if you want a visual, configurable way to locate duplicates before deciding what to delete, move, or copy — and you're comfortable installing a desktop application rather than using a command-line tool.

What dupeGuru actually does

The core job is simple: point it at folders, run a scan, and get a list of files it considers duplicates. Two scan approaches are available:

  • Filename scan — matches names, and uses a fuzzy matching algorithm so it can flag filenames that are similar but not identical.
  • Content scan — compares file contents rather than names.

That fuzzy filename matching is the feature that separates it from a strict "same name, same size" checker. It's designed to surface near-matches, which is useful when files have been renamed, copied, or exported with slight variations.

Modes for specific file types

Beyond the general scan, dupeGuru ships with two purpose-built modes:

Mode What it scans Why you'd use it
Music mode Tags Shows music-specific information in the results window, so you can compare tracks by metadata rather than filename alone
Picture mode Pictures, fuzzily Finds images that are similar but not exactly the same

Picture mode is the one to reach for when you suspect you have resized, re-compressed, or lightly edited copies of the same image — cases where a byte-for-byte comparison would miss the relationship.

Platform support

dupeGuru is cross-platform and runs on Linux, macOS, and Windows. The downloads page lists builds for Windows (x64 and x32), Ubuntu (x32, x64), macOS (10.12+), plus source archives in zip and tar.gz form.

Under the hood it's mostly Python 3, with a notable design choice: the same core Python code is paired with different GUI toolkits per platform. On macOS the UI layer is Objective-C using Cocoa; on Linux and Windows it's Python using Qt5. For you as a user, that mostly means the app looks and behaves natively on each system rather than being a single cross-platform skin.

The interface is available in English, French, German, Chinese (Simplified), Czech, Italian, Armenian, Russian, Ukrainian, Brazilian Portuguese, and Vietnamese.

Safety and result handling

Deleting the wrong file is the main risk with any duplicate finder, so it's worth knowing how dupeGuru guards against it. Two mechanisms are built in:

  • A reference directory system — you designate which location is the reference, so the tool knows which copies are the ones to keep.
  • A grouping system — duplicates are presented in groups, which makes it harder to act on a file you didn't mean to touch.

Once you've reviewed results, you're not limited to deletion. You can delete duplicates, or move or copy them elsewhere. Results can also be filtered and sorted in multiple ways, which matters most on low-threshold scans where false positives are more likely — sorting and filtering is how you weed those out before acting.

Is it the right tool for you?

dupeGuru is a reasonable fit if:

  • You want a GUI rather than scripting your own duplicate search.
  • You need cross-platform coverage across Linux, macOS, and Windows.
  • You care about similar filenames or similar images, not just exact matches.
  • You want to tune the matching engine — the help file's Preference page documents the scanning engine settings you can adjust to target exactly the kind of duplicates you want.

It's a weaker fit if you only ever need exact byte-for-byte matches on a single folder, where a simpler or built-in tool may be enough.

Getting started

  1. Go to the downloads section and pick the build for your platform — Windows (x64 or x32), Ubuntu (x32 or x64), or macOS (10.12+). Source archives are available if you'd rather build it.
  2. Install and launch the app.
  3. Choose a scan mode: standard (filename or content), Music, or Picture.
  4. Add the folders you want scanned and, where relevant, set your reference directory.
  5. Run the scan. Results appear grouped, and you can filter and sort them.
  6. Review the groups, then delete, move, or copy the duplicates you've confirmed.

If a scan returns too many near-matches, adjust the matching engine settings in Preferences and re-run rather than acting on a noisy first pass.