Skip to content

smartlegionlab/smart-file-duplicate-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Smart File Duplicate Manager v1.2.2

Smart File Duplicate Manager is an app for finding and managing duplicate files. It's written on Python using PyQt6.


GitHub release (latest by date) GitHub top language GitHub GitHub stars GitHub forks Platform


⚠️ Disclaimer

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

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

Full legal disclaimer: See DISCLAIMER.md


Features

Duplicate Search

  • Scan the 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 based on the following strategy:
  • Oldest / Newest
  • Smallest / Largest
  • Shortest / Longest Path
  • All other files in the group are automatically marked as duplicates
  • 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 are moved to the destination folder in a subfolder with the date and time. A JSON log with all information about the moved files is saved in the folder.
  • 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:
  • Left — scan settings
  • Center — list of duplicate groups with statistics
  • Right — group details and file list with checkboxes
  • Search by file name
  • Progress bar and status bar
  • Confirmation of all important actions
  • Hotkeys for basic operations
  • Dark theme

Installation and Run

# 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

# Running
python app.py

System Requirements

  • Python 3.8 or higher
  • Windows / Linux / macOS

Dependencies

  • PyQt6 — GUI
  • xxhash — fast hashing (optional)

Usage

  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.

Hotkeys

Action Keys
Select Scan Folder Ctrl+Shift+O
Select Duplicates Folder Ctrl+Shift+D
Start scan Ctrl+R
Cancel scan Ctrl+Shift+C
Reset Ctrl+X
Exit Ctrl+Q
Select all duplicates Ctrl+A
Deselect all Ctrl+Shift+A
Test mode Ctrl+T
Show statistics Ctrl+I
Clear search Ctrl+L
Move selected files Ctrl+M
Restore files Ctrl+Shift+R
Open duplicates folder Ctrl+Shift+F
Keyboard Shortcuts Ctrl+/
About Ctrl+H
Documentation F1
Report Issue Ctrl+Shift+I
License Ctrl+Alt+L

👤 Author

Alexander Suvorov

If you find this tool useful, please consider giving it a star on GitHub!


License

BSD 3-Clause License. See the LICENSE file for more details.


Made with ❤️ for the open-source community


🖼️ Screenshot

Smart File Duplicate Manager

About

Smart File Duplicate Manager is an app for finding and managing duplicate files. It's written in Python using PyQt6.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages