Skip to content

README.md

Latest commit

 

History

History
127 lines (86 loc) · 8.29 KB

README.md

File metadata and controls

127 lines (86 loc) · 8.29 KB

✅ README.md

VT Download Monitor

VT Download Monitor Logo

Автоматический мониторинг загрузок браузера с проверкой файлов через VirusTotal — теперь в удобном формате приложения.

🔍 Что делает программа?

Программа следит за вашей папкой загрузок в реальном времени. Как только появляется новый исполняемый файл или архив:

  1. Вычисляет SHA256-хеш файла.
  2. Проверяет его в базе VirusTotal (без повторной загрузки, если файл уже известен).
  3. Уведомляет вас звуком и современным всплывающим окном Windows о результате.
  4. Изолирует угрозы: если файл признан опасным, он автоматически перемещается в папку quarantine.
  5. Ведет отчет: записывает все проверки в Excel-таблицу с прямыми ссылками на полные отчеты.

🚀 Как начать пользоваться?

Способ 1: Использование готового EXE (Рекомендуется)

Это портативная версия, не требующая установки Python и библиотек.

  1. Распакуйте архив vt_download_monitor.zip.
  2. Запустите vt_download_monitor.exe.
  3. Через иконку в трее (возле часов) выберите Настройки и укажите свой API-ключ и папку загрузок.
  4. Важно: Файл config.py должен всегда находиться рядом с .exe.

Способ 2: Запуск из исходного кода

  1. Установите библиотеки: pip install -r requirements.txt.
  2. Запустите: python main.py.

⚙️ Настройка и управление

Приложение работает в фоновом режиме. Нажмите правой кнопкой мыши на иконку щита в системном трее:

  • ⚙️ Настройки — графическое окно для ввода API-ключа и выбора папки. Ключ скрыт звездочками.
  • 📊 Лог проверок — мгновенно открывает Excel-таблицу со всей историей сканирований.
  • 📂 Открыть Карантин — быстрый переход к папке с изолированными угрозами.
  • 🖥️ Показать/Скрыть консоль — окно логов в реальном времени (кнопка закрытия заблокирована для защиты от случайного выключения).
  • 🌐 VirusTotal — быстрый переход на сайт.
  • 🔄 Проверить обновления — проверка наличия новых версий программы. При запуске приложения также выполняется автоматическая проверка обновлений.

✨ Ключевые особенности

  • Абсолютная портативность: Весь движок Python спрятан в папке _internal.
  • Умный фильтр: Проверяются только опасные типы файлов (.exe, .msi, .zip, .rar и др.). Фотографии и документы игнорируются.
  • Кликабельные уведомления: При нажатии на всплывающее уведомление в браузере откроется подробный отчет VirusTotal.
  • Безопасная консоль: Окно консоли нельзя закрыть «крестиком», чтобы случайно не прервать мониторинг. Выключение только через меню «Выход».
  • Система обновлений: Программа автоматически сообщает о доступных обновлениях при запуске и по запросу через меню трея.

📁 Структура папок (Portable)

vt_download_monitor/
├── vt_download_monitor.exe  # Основной файл запуска
├── config.py                # Внешний файл настроек (API, пути)
├── VT.ico                   # Иконка приложения
├── _internal/               # Системные компоненты (не изменять)
└── data/                    # Генерируется автоматически
    ├── scan_log.xlsx        # Ваш журнал в Excel
    ├── vt_cache.json        # База для мгновенных повторных проверок
    └── whitelist.json       # Ваш белый список доверенных файлов

🏷️ Информация о версии

Текущая версия: 1.0.0 (Release)
Планируется регулярное обновление программы с добавлением новых функций и улучшений. О наличии обновлений программа сообщит вам:

  • При запуске (автоматическая проверка)
  • При выборе пункта «Проверить обновления» в меню трея

☕ Поддержать проект

Если программа оказалась вам полезной, вы можете поддержать её развитие:

Поддержать через YooMoney

Ваша поддержка помогает быстрее выпускать обновления и добавлять новые функции!

⚠️ Важные примечания

  1. API Key: Бесплатный ключ можно получить после регистрации на VirusTotal.
  2. Запуск: При первом запуске EXE Windows может вывести предупреждение SmartScreen. Нажмите «Подробнее» -> «Выполнить в любом случае».
  3. Лимиты: Бесплатный API ограничен 4 запросами в минуту. Программа автоматически ставит файлы в очередь.

🛡️ Берегите свои данные. Этот монитор — ваш надежный помощник в борьбе с сетевыми угрозами.

🐞 Нашли ошибку или есть идея?

Сообщите об этом через Issues.
Проект поддерживается в свободное время — спасибо за понимание!

⚠️ Отказ от ответственности

Этот инструмент предоставляется «как есть», без каких-либо гарантий.
Автор не несёт ответственности за:

  • Ложные срабатывания или пропуск угроз,
  • Повреждение данных,
  • Блокировку безопасных файлов,
  • Любые последствия использования программы.

Проверка через VirusTotal зависит от стороннего сервиса.
Используйте программу на свой страх и риск.

⚠️ Важно

Этот проект не связан с VirusTotal, Google или любыми их дочерними компаниями.
Используется только публичный API VirusTotal в соответствии с условиями использования.