Duplicate file finder for Linux with a GUI and a CLI.
- Exact duplicates: match by any mix of name, size, modified time and content (BLAKE3 hash).
- Duplicate folders: whole directories with identical contents.
- Similar images: perceptual hashing finds resized or re-encoded copies.
- Similar music: matches tracks by artist, title and duration (from tags).
- Clutter:
- empty folders and empty files (marker files like
__init__.pyand dotfi 7F58 les are skipped) - temporary files (
*.tmp,*~,*.part,.DS_Store, editor swap/lock files…) - broken symlinks
- rebuildable build and cache folders:
node_modules, Rusttarget/, Python virtualenvs and caches,~/.cache, anything tagged withCACHEDIR.TAG… - images whose extension doesn't match their content, with one-click rename (undoable)
- file names that break on Windows, USB sticks or cloud sync (
:,?, trailing dots/spaces, reserved names likeCON, invalid UTF-8) - optionally, images and music files that fail to open
- empty folders and empty files (marker files like
- Disk usage: treemap and largest-files list.
- Sync: compare two directories by relative path.
- Merge: two-way or three-way (git-style) text merge with per-hunk conflict resolution.
- Safe cleanup: send to trash, quarantine, move, replace with a hardlink or reflink, or delete. Every action is journaled and can be undone from the History tab or with
tidytwin undo-last. - Protected folders: files in them are never selected or removed. OS and installed-software folders are protected by default.
- Keep rules: auto-select every copy except the oldest, newest, shortest path or first root.
- Ignore groups: hide a duplicate group you want to keep from future scans; it comes back if its files change.
- Scheduled scans: periodic background scans via a systemd user timer; open the reports in the GUI.
cargo deb
sudo apt install ./target/debian/tidytwin_0.2.0-1_amd64.debNeeds cargo-deb (cargo install cargo-deb).
./packaging/build-appimage.sh
./target/TidyTwin-x86_64.AppImageThe script downloads appimagetool on first run. Running an AppImage needs libfuse2 (libfuse2t64 on Ubuntu 24.04+).
cargo build --release
./target/release/tidytwintidytwin start the GUI
tidytwin scan [OPTIONS] PATH... find duplicates, print report
tidytwin schedule hourly|daily|weekly [OPTIONS] PATH...
run the scan periodically
tidytwin unschedule
tidytwin undo-last undo the most recent action batch
tidytwin --version
options:
--match LIST comma list of name,size,mtime,content (default size,content)
--min-size N bytes (default 1)
--exclude S skip paths containing S (repeatable)
--hidden include dot-files
--cross only groups spanning 2+ roots (directory compare)
--largest N also list N largest files (default 50)
--format F json | csv (default json)
--out FILE write report to FILE instead of stdout
--report write report into <data dir>/reports/
--clutter also find empty folders/files, temp files, broken symlinks,
rebuildable build/cache folders, misnamed images, bad names
--broken with --clutter: also open every image/music file to find broken ones (slow)
Example:
tidytwin scan --exclude node_modules --format csv --out dups.csv ~/Pictures ~/BackupThe journal, quarantine, backups and scheduled reports live in $XDG_DATA_HOME/tidytwin (usually ~/.local/share/tidytwin). Quarantined files and backups are purged after the retention period (30 days by default, configurable in settings); use Empty quarantine… in the History tab to clear them right away.