❓ Frequently Asked Questions (FAQ)

Here you'll find answers to the most common questions related to the VirusTotal File Scanner. If your question isn't listed, please open a new Discussion.

---

🔐 Why is pyarmor_runtime.pyd required?

Because app.py is encrypted using PyArmor. This binary runtime file decrypts and executes the protected logic at runtime. Without it, the app cannot run.

---

🔑 How do I get a VirusTotal API key?

You can sign up for free at virustotal.com
After registration, go to your profile and copy the API key under "API Key".

---

📦 What happens if I lose config.py?

The application may still run with .env, but without a valid configuration file or environment variable, scans will fail due to a missing API key.

---

🧪 Is this a virus scanner?

No, this is a file hash analysis tool. It does not detect malware locally but checks file hashes via the VirusTotal API using cloud-based detection engines.

---

🚫 Are files uploaded to VirusTotal?

No, by default the app only sends hashes. You may optionally enable file uploads in future versions, depending on privacy settings and VT limits.

---

🛠 What happens if my file is not known to VirusTotal?

You'll receive a warning. You may choose to manually upload it on the VT website or wait until it becomes known in the community.

---

🔁 Can I scan multiple files at once?

Yes, drag & drop of multiple files is supported (if enabled). CLI-based batch scans may follow in future updates.

---

📊 Can I view scan history?

In the current version, scan results can be exported manually. Automatic history logging is planned as a future feature.

---

🌐 Is internet access required?

Yes, because all scans query VirusTotal’s online API. Offline mode for hash-only comparison is planned (via local whitelist).

---

🧩 Can I contribute?

Yes! Pull requests are welcome. See the Contributing Guidelines for details.