Smart File Duplicate Manager

Duplicate Search

• Scan selected folder and all subfolders
• Compare files by size, then by hash (xxHash, or MD5 if none)
• Multi-threaded scanning (uses all available processor cores)
• Filters by file size and extension

Duplicate Management

• Automatically determines the primary file in each group (Oldest/Newest, Smallest/Largest, Shortest/Longest Path)
• Manually select files in each group (checkboxes)
• Ability to change the primary file in a group
• Globally select all duplicates / deselect all

File Actions

• Move — duplicates moved to destination folder with timestamp and JSON log
• Test Mode — simulates actions without actually moving

Restore

• View all previously moved files from JSON logs
• Selective file restore to their original folders
• Automatic log update and deletion of empty folders

Interface

• Three main panels: scan settings, duplicate groups, group details
• Search by file name
• Progress bar and status bar
• Confirmation of all important actions
• Hotkeys for basic operations
• Dark theme

System Requirements: Python 3.8+, Windows / Linux / macOS

# Cloning the repository
git clone https://github.com/smartlegionlab/smart-file-duplicate-manager.git
cd smart-file-duplicate-manager

python -m venv venv
source venv/bin/activate

# Installing dependencies
pip install -r requirements.txt

sudo apt install libxcb-cursor0

# Running
python app.py

Dependencies: PyQt6 — GUI · xxhash — fast hashing (optional)

1. In the left panel, specify the scan folder and the duplicates folder
2. If necessary, adjust filters and select a strategy
3. Click "Start Scan"
4. After scanning is complete, select the desired files (or use "Select All")
5. To restore previously moved files, use the "Tools" → "Restore Files" menu

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks.

Full legal disclaimer: See DISCLAIMER.md

License: BSD 3-Clause License