8000 GitHub - fagostini/tidytwin: Duplicate file finder with GUI and CLI · GitHub
[go: up one dir, main page]

Skip to content
fagostiniPublic

About

Duplicate file finder with GUI and CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TidyTwin

Duplicate file finder for Linux with a GUI and a CLI.

Features

  • 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__.py< 7F68 /code> and dotfiles are skipped)
    • temporary files (*.tmp, *~, *.part, .DS_Store, editor swap/lock files…)
    • broken symlinks
    • rebuildable build and cache folders: node_modules, Rust target/, Python virtualenvs and caches, ~/.cache, anything tagged with CACHEDIR.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 like CON, invalid UTF-8)
    • optionally, images and music files that fail to open
  • 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.

Install

Debian / Ubuntu

cargo deb
sudo apt install ./target/debian/tidytwin_0.2.0-1_amd64.deb

Needs cargo-deb (cargo install cargo-deb).

AppImage (any distro)

./packaging/build-appimage.sh
./target/TidyTwin-x86_64.AppImage

The script downloads appimagetool on first run. Running an AppImage needs libfuse2 (libfuse2t64 on Ubuntu 24.04+).

From source

cargo build --release
./target/release/tidytwin

CLI

tidytwin                                    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 ~/Backup

Data

The 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.

About

Duplicate file finder with GUI and CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0