0 purchases
Description:
vtkvd 0.5.0
vt-kvd
About
Installing
vt-kvd itself
From PyPI
From sources
Dependencies
libmagic
Configuration
Running
User agent
Scanning directories
Platforms
3rd-party
Requirements
Resources
About
A VirusTotal GUI client.
The application functionality is rather basic at the moment:
getting files hashes and fetching existing reports from VirusTotal
displaying results in a table
openning a link to the full report
uploading files for scanning isn't implemented
Installing
vt-kvd itself
From PyPI
$ pip install vt-kvd
From sources
$ cd /path/to/repository/
$ pip install ./
or:
$ cd /path/to/repository/
$ python -m build
$ pip install ./dist/vt_kvd-0.5.0-py3-none-any.whl
Dependencies
libmagic
All the dependencies are automatically installed with pip. But python-magic Python module expects libmagic to be present in the system. So if you will be scanning directories instead of individual files, then you will need to install this library using your system package manager:
Mac OS (Homebrew): brew install libmagic
GNU/Linux (APT): sudo apt install libmagic1
Windows: the easiest will be to use alternative package instead of python-magic, because that one bundles required libmagic binary (and actually you can probably use that package on non-Windows platforms too):
$ pip uninstall python-magic
$ pip install python-magic-bin
Configuration
Config file ~/.config/vt-kvd/config.toml:
[API]
key = "YOUR-VIRUSTOTAL-API-KEY"
If the main config file is missing, it will try to fallback to vt-cli's config at ~/.vt.toml:
apikey="YOUR-VIRUSTOTAL-API-KEY"
Running
$ vt-kvd --help
User agent
The application uses platform module to compose the agent string which is sent to VirusTotal API on every request. The full value can look like this:
vt-kvd/0.5.0 macOS-12.6.1-x86_64-i386-64bit
It is not (yet?) configurable, but you should probably be aware of its existence anyway.
Scanning directories
It is possible to check not a single file but a directory. In that case in order to skip the files that are of no interest the application will scan the directory for suitable files by guessing their types based on magic numbers. This is not an absolutely reliable way, so it is recommended that you check the files of interest individually by explicitly providing their full paths one by one.
Another thing to consider is that VirusTotal API has a quota for standard free public accounts, and you can quickly exceed that quota by scanning directories instead of individual files.
Scanning directories is disabled by default. If you would like to enable it, launch the application with --enable-dir-scan. That will also require you to have libmagic binary installed in the system.
Platforms
Tested on:
Mac OS:
12.6.1, Intel
Windows:
10 21H1
11 21H2
GNU/Linux:
Ubuntu 22.04
3rd-party
Requirements
Python 3.8 or later
Dear PyGui - application window and UI controls
pandas - processing results
for detecting executables and libraries, either of these two:
python-magic (with libmagic to be installed separately from your system package manager)
installed by default
python-magic-bin (with bundled libmagic)
needs to be manually installed instead of the other one (which needs to be uninstalled)
vt-py - VirusTotal API library
Resources
JetBrains Mono font
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Files In This Product:
Customer Reviews
There are no reviews.
