📧 Очиститель дубликатов писем

Мощный Python-инструмент для поиска и удаления дубликатов писем в различных почтовых клиентах. Доступен в виде веб-интерфейса, десктопного приложения и командной строки.

🚀 Версия

Текущая версия:

✨ Что нового в 2.5.2

• 🚀 Обновление до версии 2.5.2
• 🐛 Исправлено отображение номера версии в диалоговом окне “О программе”
• 📚 Обновлена документация в соответствии с последними изменениями

✨ Что нового в 2.5.1

• 🐛 Исправлена ошибка импорта QAction в PySide6 GUI
• 🌐 Добавлены полные английские переводы
• 📄 Включен файл лицензии GPL-3.0
• 🔄 Улучшена обработка ошибок при инициализации графического интерфейса
• ⬆️ Обновлены зависимости для большей стабильности

✨ Возможности

🔍 Поиск дубликатов

• Несколько критериев поиска:
  • Строгий: Полное сравнение
  • Только содержимое: Анализ тела письма
  • Заголовки: Сравнение по метаданным
  • Тема+Отправитель: Целевая идентификация

📊 Анализ писем

• Расширенная аналитика:
  • Анализ отправителей: Топ отправителей и доменов
  • Временной анализ: Визуализация писем по времени
  • Анализ вложений: Типы, размеры и частота файлов
  • Анализ цепочек: Просмотр и управление обсуждениями
  • Анализ дубликатов: Подробная информация о найденных дубликатах
  • Экспорт отчетов в различных форматах (TXT, HTML, JSON)

🖥️ Поддерживаемые интерфейсы

• Веб-интерфейс - Современный адаптивный дизайн с тёмной/светлой темой
• Десктопное приложение - Нативное приложение на PySide6
• Командная строка - Мощный инструмент для автоматизации

🌓 Улучшенный пользовательский опыт

• Современный веб-интерфейс с тёмной/светлой темой
• Интерактивный предпросмотр в реальном времени
• Полноценная система справки
• Режим отладки с детальным логированием
• Демо-режим для тестирования и обучения

🔒 Совместимость с почтовыми клиентами

Поддерживаются:

• Mozilla Thunderbird
• Apple Mail
• Microsoft Outlook
• Форматы mbox/maildir

🏗️ Технические особенности

• Современный веб-интерфейс на Flask
• Управление базой данных через SQLAlchemy
• Полноценная система справки с динамическим контентом
• Модульная архитектура с чётким разделением ответственности
• Кросс-платформенная совместимость
• Расширенная обработка ошибок и логирование

🛠️ Требования

• Python 3.8+
• pip
• Поддерживаемые ОС: Windows, macOS, Linux

🚀 Быстрый старт

💰 Поддержка проекта

Если вам нравится этот инструмент, рассмотрите возможность поддержки его разработки:

• Поддержать через PayPal
• Стать спонсором на Patreon
• :money_with_wings: Monero (XMR):

  47Jc6MC47WJVFhiQFYwHyBNQP5BEsjUPG6tc8R37FwcTY8K5Y3LvFzveSXoGiaDQSxDrnCUBJ5WBj6Fgmsfix8VPD4w3gXF
  

📦 Установка

1. Клонируйте репозиторий:

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

2. Установите зависимости:

   pip install -r requirements.txt
   

Запуск приложения

Веб-интерфейс

python app.py

Откройте в браузере: http://localhost:5000

Десктопное приложение

python email_cleaner_gui.py

Демонстрация в командной строке

python email_duplicate_cleaner.py --demo

🤝 Участие в разработке

Хотите внести свой вклад? Ознакомьтесь с нашим Руководством по участию!

📄 Лицензия

Этот проект распространяется под лицензией MIT.

🐛 Проблемы

Нашли ошибку? Сообщите о проблеме

📊 Методы обнаружения

• strict: ID письма + Дата + От кого + Тема + Содержимое
• content: Только содержимое
• headers: ID письма + Дата + От кого + Тема
• subject-sender: Только тема и отправитель

Функции безопасности

• Всегда сохраняет хотя бы одну копию каждого письма
• По умолчанию сохраняет самое старое письмо
• Исходные письма можно восстановить из корзины
• Демо-режим для безопасного тестирования

Структура проекта

• email_cleaner_web.py: Веб-интерфейс
• email_cleaner_gui.py: Графический интерфейс
• email_duplicate_cleaner.py: Основная функциональность и CLI
• static/: Ресурсы веб-интерфейса (CSS, JS)
• templates/: HTML-шаблоны

Рабочие процессы

• Демо-режим: Работает с тестовыми письмами
• Справка: Показывает информацию об использовании
• Режим GUI: Запускает графический интерфейс
• Веб-режим: Запускает веб-сервер

Структура графического интерфейса

• Графический интерфейс (email_cleaner_gui.py): Удобный интерфейс на Tkinter для выбора почтовых клиентов, сканирования папок и управления дубликатами.
• Интерфейс командной строки (email_cleaner_cli.py): Консольный интерфейс для работы в терминале.
• Веб-интерфейс (app.py): Веб-приложение на Flask, доступное из любого браузера.

Вспомогательные модули (struttura/)

В каталоге struttura/ находятся вспомогательные модули для графического интерфейса, включая диалоговые окна и меню.

• menu.py: Управление созданием и функциональностью главного меню.
• about.py, help.py, sponsor.py: Определяют диалоговые окна “О программе”, “Помощь” и “Поддержать”.
• log_viewer.py: Просмотрщик логов приложения.