Skip to content

Usage

Jump to bottom
FullStackHero edited this page Aug 3, 2025 · 2 revisions

🚀 Usage Guide

This section explains how to use the VirusTotal File Scanner via its graphical user interface (GUI) and optionally via the command line (CLI), including the full scan workflow.

🖥️ Using the Graphical User Interface

1. Launch the Application

From terminal or file explorer:

python app.py

Make sure your pyarmor_runtime.pyd and config.py or .env file are present.

2. Select a File to Scan

  • Use the file dialog or drag & drop a file into the window
  • Supported file types: any (including .exe, .pdf, .zip, .docx, etc.)

3. Start the Scan

Click the "Scan" button.
The app will:

  • Hash the file (SHA256, SHA1, MD5)
  • Check VirusTotal using the API
  • Display the scan result in the main panel

4. Interpret the Results

You'll see:

  • Detection ratio (e.g., 3/70)
  • Link to the VirusTotal report
  • File metadata: size, type, timestamp
  • Optional: threat classification (malware, trojan, etc.)

5. Export the Report

Click "Export" to save results as .json or .csv, based on your configuration.

⚙️ Optional Features

  • Toggle language: English/German
  • Theme switch: Light / Dark / High Contrast
  • Hash-only mode toggle
  • Log viewer panel (if enabled)
  • Multi-file drag & drop (if enabled)

🧪 Using the CLI (Optional)

For batch scans or automation, you can run:

python cli_scan.py yourfile.zip

Output will be printed to console or written to file, depending on configuration.

🔐 Security Reminder

Your files are not uploaded unless you configure full upload mode. By default, only hashes are checked against the VirusTotal database.

🆘 Help

If something doesn't work, verify:

  • API key is valid
  • Internet connection is active
  • pyarmor_runtime.pyd is present
  • File is not locked or in use
Clone this wiki locally