Skip to content

Latest commit

 

History

History
176 lines (126 loc) · 7.46 KB

File metadata and controls

176 lines (126 loc) · 7.46 KB

README_EN.md

English | Русский

VT Download Monitor

VT Download Monitor Logo

Release Python Windows Portable VirusTotal Auto Update License

Automatic browser download monitoring with VirusTotal file checking — now in a convenient application format.

Download v1.2.0
Version 1.2.0 (Latest Release)
vt_download_monitor_v1.2.0.zip


📋 Version History

🚀 v1.0.0 — First Stable Release

📦 Core Features

  • Automatic downloads folder monitoring — real-time tracking of new files
  • Smart filtering — only potentially dangerous file types are checked (.exe, .msi, .zip, .rar, etc.)
  • VirusTotal API integration — instant file scanning through the largest threat database
  • Local cache — repeated checks are performed instantly without API calls
  • Automatic quarantine — malicious files are automatically isolated
  • Detailed logging — all scan history is saved in an Excel file with clickable links

🎛️ User Interface

  • System tray — minimalistic control through Windows tray icon
  • Context menu — quick access to all program functions
  • Modern notifications — Windows pop-up notifications with click support
  • Graphical settings — convenient configuration window with sensitive data protection
  • Protected console — log window cannot be accidentally closed

🔧 Technical Features

  • Portable version — no installation required, works from any folder
  • Cross-platform foundation — built on Python with source code launch capability
  • Secure architecture — separation of executable file and settings
  • API limit management — automatic queue when VirusTotal limits are exceeded
  • Whitelist system — ability to add trusted files

📊 Monitoring and Reporting

  • Excel reports — structured history of all scans
  • Result caching — acceleration of repeated checks
  • Audio notifications — audio confirmations of events
  • Direct links — quick jump to full VirusTotal reports

🔍 v1.1.0 — Enhanced Security

  • Archive checking — ZIP, 7Z, TAR and other formats are automatically unpacked and checked by content
  • Flexible threat sensitivity settings — through tray menu you can specify detection thresholds
  • Safe downloading — files larger than 64 MB are not sent automatically to avoid wasting API quota
  • Reliable error logging — all errors are recorded in data/error.log
  • Clear notifications — for incorrect API key or large file, immediate hints are shown
  • Convenient console control — console window can be shown/hidden from tray menu

🛡️ v1.2.0 — Advanced Protection

Threat Protection with Automatic Quarantine

  • Automatic moving of suspicious files to quarantine upon threat detection
  • Safe storage — files are renamed to .quarantine (cannot be accidentally executed)
  • Double protection — files are placed in a hidden quarantine folder with system attributes

Quarantine Management

  • New menu item "Manage Quarantine" in the system tray
  • File restoration — safe return to downloads folder with unique names
  • Threat removal — complete deletion of files from quarantine
  • Metadata protectionquarantine_info.json file is protected from accidental deletion

Enhanced Scanning Logic

  • Flexible thresholds — configurable danger levels (critical, warning, suspicious)
  • Smart isolation — files with threat or warning status are automatically isolated
  • Full information — scanning data is saved for each file in quarantine

Usability and Reliability

  • Console window hidden on autostart — program runs completely in background
  • Protection against accidental closure — close button (X) in console window is disabled
  • Reliable saving of all settings — parameters are correctly saved and restored after restart

Export and Integration

  • Improved scan log export — opens the file itself (scan_log.csv or scan_log.html), not just folder
  • Manual file scan function via context menu in tray

Localization

  • Bilingual interface — English and Russian languages support
  • Cross-links — switching between language versions of releases
  • Localization of all system notifications — Windows Toast notifications in selected language

🚀 How to Get Started?

** Running from source code**

  1. Install libraries: pip install -r requirements.txt
  2. Run: python src/main.py
  3. Through the tray icon (near the clock) select Settings and enter your API key and downloads folder.

⚙️ Configuration and Management

The application runs in the background. Right-click on the shield icon in the system tray:

  • ⚙️ Settings — graphical window for entering API key and selecting folder. Key is hidden with asterisks.
  • 📊 Scan Log — instantly opens an Excel spreadsheet with all scan history.
  • 🚫 Open Quarantine — quick jump to the folder with isolated threats.
  • 🛡️ Manage Quarantine — view, restore or delete quarantined files.
  • 🖥️ Show/Hide Console — real-time log window (close button is blocked).
  • 🔍 Check file on VirusTotal — quick jump to the website.
  • 🔄 Check for Updates — check for new versions.

Key Features

  • Smart filter — only dangerous file types are checked (.exe, .msi, .zip, .7z, etc.)
  • Clickable notifications — when clicked, opens the VirusTotal report
  • Safe console — window cannot be closed with the "X" button
  • Update system — program notifies about new versions at startup and on request
  • Multi-language support — English and Russian interfaces
  • Advanced quarantine — automatic isolation and management of threats

🏷️ Version Information

Current version: 1.2.0
The program automatically checks for updates at startup and through the tray menu.

Previous versions:

  • v1.1.0 — Enhanced security with archive checking
  • v1.0.0 — First stable release with core features

Support the Project

Support via YooMoney


⚠️ Important Notes

  • API Key: Get a free key on VirusTotal.
  • Limits: Free API — 4 requests/minute. Files are queued.

📄 License

The project is distributed under the MIT license.


🐞 Found a bug?

Report via Issues.


⚠️ Disclaimer

The program is provided "as is". The author is not responsible for consequences of use.
This project is not affiliated with VirusTotal or Google.