GitHub - jdefrancesco/dskDitto: Ultra fast and easy duplicate file finder. Awesome TUI/GUI to manage results.

dskDitto The ultra-fast, parallel duplicate-file detector with interactive menus that make clearing unnecessary duplicates hassle free! Features

Blazingly fast duplicate scanning — Parallel processing finds duplicates across large disks instantly. Interactive TUI by default — Browse, compare, and manage duplicates with an intuitive terminal interface powered by Bubble Tea. Optional GUI — Use the experimental Raylib GUI for a graphical alternative to the TUI. Safe deletion & symlink conversion — Remove duplicates or replace them with symlinks, with confirmation dialogs to prevent accidents. Smart single-file search — Hash a specific file and instantly find all its duplicates across your filesystem. Flexible hashing — Choose between SHA-256 (default) or BLAKE3 for content verification. Fine-grained filtering — Skip files by size, depth, hidden files, symlinks, virtual filesystems, and filesystem boundaries. Export results — Save findings to CSV, JSON, or plain text for reporting or automation. Unix hard-link aware — Treats hard-linked files intelligently to avoid false duplicates.

Install Install straight from source using Go 1.22+: go install github.com/jdefrancesco/dskDitto/cmd/dskDitto@latest This drops the CLI/TUI binary at $(go env GOPATH)/bin/dskDitto (or ~/go/bin by default). The default install does not build the optional Raylib GUI. To install a GUI-capable binary, make sure Raylib and CGo are available, then build with the gui tag: go install -tags gui github.com/jdefrancesco/dskDitto/cmd/dskDitto@latest Usage dskDitto [options] PATH ... Common flags:

Flag Description

--version Print the current version and exit

--no-banner Skip the startup banner

--gui Review results in the experimental Raylib GUI instead of the default TUI; requires a GUI build

--profile <file> Write a CPU profile to the given file

--time-only Exit immediately after the scan, printing only the elapsed time

--min-size <bytes> Ignore files smaller than the provided size

--max-size <bytes> Skip files larger than the provided size (default 4 GiB;

use 0 for no limit)

--all-sizes Scan files of any size; clearer equivalent to --max-size 0

--hidden Include dot files and dot-directories

--exclude <path> Exclude a path from scanning (repeatable; excludes descendants)

--no-symlinks Skip symbolic links

--empty Include zero-byte files

--include-vfs Include virtual filesystem directories such as /proc or /dev

--one-file-system Do not descend into directories on a different filesystem device; --xdev is a short alias

--dir-concurrency <int> Limit concurrent directory reads; values <= 0 use automatic tuning

--no-cache On supported platforms, ask the OS not to populate the filesystem cache while hashing

--current Restrict the scan to only the specified paths (no recursion)

--depth <levels> Limit recursion to <levels> directories below the starting paths

--dups <count> Only show groups that contain at least <count> files

--text, --bullet Render duplicates without launching the TUI

--remove <keep> Operate on duplicates, keeping the first <keep> entries per group

--link With --remove, convert extra duplicates to symlinks instead of deleting them

--file <path> Only report duplicates of the given file; with --name-only, match by that file's exact name

--name-only Shallow mode: group files by exact file name, ignoring content and size

--file-shallow <path> Shallow mode: only report files with the same exact name as <path>

--fuzzy Content-based near-duplicate mode (file similarity, not filename similarity)

--fuzzy-threshold <pct> Minimum similarity percentage in fuzzy mode (default 75)

--fuzzy-same-ext In fuzzy mode, only compare files that share the same extension

--hash <algo> Select hash algorithm: sha256 (default) or blake3

--csv-out <file> Write duplicate groups to CSV

--json-out <file> Write duplicate groups to JSON

--fs-detect <path> Print the filesystem type that contains <path>

--color-safe Use a high-compatibility TUI theme that avoids custom colors (best for problematic terminal themes)

--no-confirm Skip interactive confirmation codes for TUI/GUI delete and link actions

Press Ctrl+C at any time to abort a scan. When duplicates are removed or converted through the TUI or GUI, a confirmation dialog prevents accidental mass changes unless --no-confirm is set. Duplicate removal and symlink conversion dskDitto never deletes or rewrites anything unless you explicitly ask it to with --remove.

Dry / interactive modes: by default (or with --text / --bullet) the tool only reports duplicates. Delete extras: use --remove <keep> to delete all but <keep> files in each duplicate group. Convert extras to symlinks: combine --remove <keep> --link to replace extra duplicates with symlinks pointing at one kept file per group.

In the TUI you can also convert the currently marked files into symlinks: mark the duplicates you want to replace, then press L and enter the confirmation code. Each group’s symlinks will point at one unmarked file in that group. Power users can pass --no-confirm to skip the confirmation code in the TUI and GUI. On Unix-like systems, multiple hard links to the same underlying file are treated as a single entry during scanning: dskDitto hashes the content once and does not report those hard-link paths as separate space-wasting duplicates. When using --link, the on-disk layout after the operation looks like this for a group of 3 identical files and --remove 1 --link: /path/to/keep/file.txt # original file kept /path/to/dup/file-copy.txt -> /path/to/keep/file.txt (symlink) /another/location/file.txt -> /path/to/keep/file.txt (symlink)

In the TUI, files that are symlinks are annotated with a [symlink] suffix so you can see which entries were converted. Single-file duplicate search Use --file /path/to/original.ext to hash a specific file first, then scan the provided directories for other files with identical content.