https://github.com/tddschn/virustotal-tddschn
https://github.com/tddschn/virustotal-tddschn
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/tddschn/virustotal-tddschn
- Owner: tddschn
- License: mit
- Created: 2022-06-01T16:18:29.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2023-05-09T01:21:28.000Z (about 3 years ago)
- Last Synced: 2025-03-28T19:38:30.054Z (about 1 year ago)
- Language: Python
- Size: 120 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VirusTotal Utility Library and Command Line Tools
- [VirusTotal Utility Library and Command Line Tools](#virustotal-utility-library-and-command-line-tools)
- [Installation](#installation)
- [pipx](#pipx)
- [pip](#pip)
- [Utilities](#utilities)
- [vtpy](#vtpy)
- [Features](#features)
- [Homebrew integration](#homebrew-integration)
- [macOS specific features](#macos-specific-features)
- [Usage](#usage)
- [Develop](#develop)
## Installation
### pipx
This is the recommended installation method.
```
$ pipx install virustotal-tddschn
```
### [pip](https://pypi.org/project/virustotal-tddschn/)
```
$ pip install virustotal-tddschn
```
## Utilities
### vtpy
#### Features
##### Homebrew integration
- `--brew` & `--cask`: Parsing Homebrew's DSL `formula` and `cask` files, extracting the package checksum with matching CPU arch
Click to expand example
```
$ vtpy -w inkscape -B
File path: /usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask/Casks/inkscape.rb
SHA256 checksum: 8117d5d864358c9f626ce574d07d2f121ad96fc96a535cc3fddaba3c74bd3279
VirusTotal URL: https://www.virustotal.com/gui/search/8117d5d864358c9f626ce574d07d2f121ad96fc96a535cc3fddaba3c74bd3279
```
- `--brew-cache`: Locating the `brew`-downloaded package in `brew`'s cache
Click to expand example
```
$ vtpy -c google-chrome -b firefox -B
File path: /Users/tscp/Library/Caches/Homebrew/downloads/88881e66883c4776fff9b3019b48a26795020439a33ddbedd3bd4620283aecd2--googlechrome.dmg
SHA256 checksum: 201739d3cf941d33daf605351160f22bdd5877070267e2b42f37efa661378772
VirusTotal URL: https://www.virustotal.com/gui/search/201739d3cf941d33daf605351160f22bdd5877070267e2b42f37efa661378772
```
##### macOS specific features
- `--mac`: Locating binaries inside macOS app bundles (the `.app` directories).
Click to expand example
```
$ vtpy -m /Applications/kitty.app -B
File path: /Applications/kitty.app/Contents/MacOS/kitty
SHA256 checksum: ca6aabac5bd9cd9dde7e3c713eae2031aabec08129218817aecbccb5408b3b0b
VirusTotal URL: https://www.virustotal.com/gui/search/ca6aabac5bd9cd9dde7e3c713eae2031aabec08129218817aecbccb5408b3b0b
```
#### Usage
```
$ vtpy --help
usage: vtpy [-h] [--hash HASH] [-f FILE] [-b browser] [-B] [-ldl] [-w BREW] [-C] [-c BREW] [-m APP] [-F PATH] [-V]
Search file or Homebrew package checksum on VirusTotal
options:
-h, --help show this help message and exit
--hash HASH The hash to search (default: None)
-f FILE, --file FILE The file to hash and check (default: None)
-b browser, --browser browser
Browser to open URLs (default: chrome)
-B, --no-browser Do not open URLs in a browser (default: False)
-ldl, --latest-download
Use the latest downloaded file (default: False)
-w BREW, --brew BREW Use the checksum in Homebrew formula or cask file (default: None)
-C, --cask Use cask (default: None)
-c BREW, --brew-cache BREW
Use brew downloaded cache (default: None)
-m APP, --mac APP Path to app bundle (default: None)
-F PATH, --brew-file PATH
Use the checksum in the brew formula or cask file (default: None)
-V, --version show program's version number and exit
```
## Develop
```
$ git clone https://github.com/tddschn/virustotal-tddschn.git
$ cd virustotal-tddschn
$ poetry install
```