A small personal project: a desktop app that looks up file hashes and URLs against the VirusTotal API and shows a short summary (verdict, detection ratio, analysis stats, and related fields).
This is not a production tool—just something I built for my own use and learning.
- Windows (the packaged build is a Windows executable)
- A VirusTotal API key, set as the environment variable
VirusTotal_API_Key
- Obtain a VirusTotal API key and set
VirusTotal_API_Keyin your user or system environment variables. - Run
dist/pyThreat-intel-app.exe(orpyThreat-intel-app.exeif you have a copy at the project root).
The app opens a simple window with two panels: file hash lookup and URL lookup. Enter a SHA256 hash or URL and click Submit.
-
Install Python (the project was developed with a recent Python 3 release).
-
Set the
VirusTotal_API_Keyenvironment variable as above. -
Install dependencies:
pip install PySimpleGUI vt-py
-
From the project directory:
python pyThreat-intel-app.py
If you change the source and want a new .exe, install PyInstaller and run:
pyinstaller pyThreat-intel-app.specThe output is written under dist/.
- API lookups are subject to VirusTotal rate limits and account permissions.
- The console may print status messages when the app starts or when a URL check runs; the main interface is the GUI window.