📧 Email Duplicate Cleaner

A comprehensive Python tool designed to scan, identify, and remove duplicate emails across multiple email clients. Featuring web, desktop, and command-line interfaces.

🚀 Version

Current Version:

✨ What’s New in 2.5.2

• 🚀 Updated to version 2.5.2
• 🐛 Fixed version number display in the about dialog
• 📚 Updated documentation to reflect the latest changes

✨ What’s New in 2.5.1

• 🐛 Fixed QAction import error in PySide6 GUI
• 🌐 Added complete English translations
• 📄 Included GPL-3.0 license file
• 🔄 Improved error handling in GUI initialization
• ⬆️ Updated dependencies for better stability

✨ Features

🔍 Duplicate Detection

• Multiple detection criteria:
  • Strict: Comprehensive comparison
  • Content Only: Message body analysis
  • Headers: Metadata-based matching
  • Subject+Sender: Focused identification

📊 Email Analysis

• Advanced email analytics:
  • Sender analysis: Identify top senders and domains
  • Timeline analysis: Visualize email patterns over time
  • Attachment analysis: File types, sizes, and frequencies
  • Thread analysis: View and manage conversation threads
  • Duplicate analysis: Detailed duplicate detection insights
  • Exportable reports in multiple formats (Text, HTML, JSON)

🖥️ Multi-Interface Support

• Web Interface - Modern, responsive design with dark/light mode
• Desktop GUI - Native desktop experience with PySide6
• Command-Line Interface - Powerful automation and scripting support

🌓 Enhanced User Experience

• Modern web interface with dark/light mode
• Interactive preview with real-time updates
• Comprehensive help system
• Debug mode with detailed logging
• Demo mode for testing and learning

🔒 Email Client Compatibility

Supports:

• Mozilla Thunderbird
• Apple Mail
• Microsoft Outlook
• Generic mbox/maildir formats

🏗️ Technical Highlights

• Modern web interface built with Flask
• SQLAlchemy for database management
• Comprehensive help system with dynamic content
• Modular architecture with clear separation of concerns
• Cross-platform compatibility
• Extensive error handling and logging

🛠️ Prerequisites

• Python 3.8+
• pip
• Supported OS: Windows, macOS, Linux

🚀 Quick Start

💰 Support This Project

If you find this tool useful, please consider supporting its development:

• Support via PayPal
• Become a Patron
• :money_with_wings: Monero (XMR):

  47Jc6MC47WJVFhiQFYwHyBNQP5BEsjUPG6tc8R37FwcTY8K5Y3LvFzveSXoGiaDQSxDrnCUBJ5WBj6Fgmsfix8VPD4w3gXF
  

📦 Installation

1. Clone the repository:

   git clone https://github.com/Nsfr750/EmailDuplicateCleaner.git
   cd EmailDuplicateCleaner
   

2. Install dependencies:

   pip install -r requirements.txt
   

Running the Application

Web Interface

python app.py

Access at http://localhost:5000

Desktop GUI

python email_cleaner_gui.py

Command Line Demo

python email_duplicate_cleaner.py --demo

🤝 Contributing

Interested in contributing? Check out our Contributing Guidelines!

📄 License

This project is licensed under the MIT License.

🐛 Issues

Found a bug? Open an issue

📊 Detection Methods

• strict: Message-ID + Date + From + Subject + Content
• content: Content only
• headers: Message-ID + Date + From + Subject
• subject-sender: Subject + From fields only

Safety Features

• Always preserves at least one copy of each email
• Keeps oldest email by default
• Original emails recoverable from trash
• Demo mode for safe testing

Project Structure

• email_cleaner_web.py: Web interface
• email_cleaner_gui.py: Desktop GUI
• email_duplicate_cleaner.py: Core functionality and CLI
• static/: Web assets (CSS, JS)
• templates/: HTML templates

Workflows

• Demo Mode: Runs with test emails
• Help: Shows usage information
• GUI Mode: Launches desktop interface
• Web Mode: Starts web server

GUI Structure

• GUI (email_cleaner_gui.py): A user-friendly graphical interface built with Tkinter. It provides an intuitive way to select email clients, scan folders, and manage duplicates.
• CLI (email_cleaner_cli.py): A command-line interface for users who prefer working in the terminal.
• Web (app.py): A web-based interface built with Flask, accessible from any browser.

Auxiliary Modules (struttura/)

The struttura/ directory contains all the auxiliary modules that support the GUI, such as dialog windows and the menu.

• menu.py: Manages the creation and functionality of the main menu bar, keeping the main GUI file clean and focused on its core layout.
• about.py, help.py, sponsor.py: Define the About, Help, and Sponsor dialog windows, each encapsulated in its own class.
• log_viewer.py: A simple log viewer to display application logs.

GUI Features

• Intuitive Interface: A clean and easy-to-use graphical interface for managing email accounts and scanning for duplicates.
• Multi-selection: Use Shift+Arrow Keys and Ctrl+Arrow Keys to select multiple mailboxes and folders.
• Multi-language Support: Available in English and Italian.