Installation

💾 Installation Guide

This page provides a complete step-by-step guide for installing and configuring the VirusTotal File Scanner application.

---

✅ Requirements

• Windows 10/11 (64-bit)
• Python 3.8 or higher
• Internet connection for VirusTotal API access
• A free VirusTotal API key

---

📥 Step-by-Step Installation

1. Clone the Repository

git clone https://github.com/bylickilabs/VirusTotal-File-Scanner.git
cd VirusTotal-File-Scanner

2. Create a Virtual Environment (recommended)

python -m venv venv
source venv/bin/activate        # macOS/Linux
venv\Scripts\activate         # Windows

3. Install Required Dependencies

pip install -r requirements.txt

Dependencies include:

• requests – for API communication
• python-dotenv – for environment-based config
• PySimpleGUI – for the graphical interface
• tqdm, babel, and others

4. Add Your VirusTotal API Key

Edit config.py or create a .env file:

VT_API_KEY=your-api-key-here

💡 You can get your key by creating a free VirusTotal account.

---

🔐 Runtime Protection

The core logic of the app is encrypted using PyArmor.
To run the application:

• Ensure the folder pyarmor_runtime_000000/ exists
• It must contain:
  • __init__.py
  • pyarmor_runtime.pyd ← This file is critical

---

▶️ Running the App

Launch the application from terminal:

python app.py

If app.py is encrypted, ensure pyarmor_runtime.pyd is in place.

---

🧪 Test Your Setup

Run the following script to check runtime dependencies:

python verify_runtime.py

This will check for pyarmor_runtime.pyd and print a success/fail message.

---

🆘 Having Trouble?

Check:

• Is your API key correct?
• Do you have internet access?
• Is the PyArmor runtime present?