dupeSweep - Python Package

Find and remove duplicate files safely with undo capability.

Installation

From PyPI (Recommended)

pip install dupesweep

From Source

git clone https://github.com/larryste1/dupesweep.git
cd dupesweep/python
pip install .

Development Installation

pip install -e ".[dev]"

Quick Start

GUI Mode (Default)

dupesweep

CLI Mode

# Scan a directory
dupesweep scan ~/Downloads

# Remove files (with confirmation)
dupesweep remove file1.txt file2.txt

# Undo last operation
dupesweep undo

# Check operation history
dupesweep status

# Show help
dupesweep help

Features

• 🔍 SHA256 Content Hashing - Full file hashing for accurate duplicate detection
• 🛡️ Safe Operations - Files moved to trash with collision-resistant naming
• ↩️ Undo Support - Restore files from any operation with verification
• 📊 Statistics - See wasted space and duplicate counts
• 🖥️ GUI + CLI - Graphical and command-line interfaces
• ⚡ Two-Phase Hashing - Quick hash first, full hash on collision
• 🧹 OS Junk Filtering - Automatically skips .DS_Store, Thumbs.db, etc.

Requirements

• Python: 3.7 or higher
• tkinter: Usually included with Python (for GUI mode)
• No external dependencies!

Usage Examples

Find Duplicates

# Scan home directory
dupesweep scan ~

# Scan specific folder
dupesweep scan /path/to/folder

# Scan with progress indicator
dupesweep scan /large/directory

Remove Duplicates

# Interactive GUI (recommended)
dupesweep

# CLI removal with confirmation
dupesweep remove /path/to/file1.txt /path/to/file2.txt

Undo Operations

# Undo last batch
dupesweep undo

# View operation history
dupesweep status

Testing

# Install test dependencies
pip install ".[dev]"

# Run tests
pytest tests/ -v

# Run with coverage
pytest tests/ --cov=python --cov-report=html

License

MIT License - See LICENSE file for details.

Support

• Issues: https://github.com/larryste1/dupesweep/issues
• Discussions: https://github.com/larryste1/dupesweep/discussions
• Source: https://github.com/larryste1/dupesweep