https://github.com/moldabekov/virusgotal
👾 VirusTotal zero dependency command line client. Hassle free file/URL scanning from CLI
https://github.com/moldabekov/virusgotal
checker cli command-line go golang malware-analysis virustotal
Last synced: about 1 year ago
JSON representation
👾 VirusTotal zero dependency command line client. Hassle free file/URL scanning from CLI
- Host: GitHub
- URL: https://github.com/moldabekov/virusgotal
- Owner: moldabekov
- License: mit
- Created: 2018-01-15T11:49:14.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-10-17T10:17:26.000Z (over 6 years ago)
- Last Synced: 2024-06-20T12:05:57.516Z (almost 2 years ago)
- Topics: checker, cli, command-line, go, golang, malware-analysis, virustotal
- Language: Go
- Homepage: https://github.com/moldabekov/virusgotal
- Size: 51.8 KB
- Stars: 69
- Watchers: 6
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Scan any file & URL from your terminal!
virusgotal is a simple CLI client to a famous VirusTotal service. No more hassle with URL and file scans ever.
Download
# Virusgotal
Yes, it is yet another wrapper. However it's a crossplatform CLI tool which runs on Linux/macOS/Windows/\*BSD and even on Android.
It's also requires **zero** runtime dependency.
## Installation
**Option 1.** The easiest way is to [grab package](https://github.com/moldabekov/virusgotal/releases) from [Github Releases](https://github.com/moldabekov/virusgotal/releases) page and place it (*preferably*) in your $PATH.
For more convenient usage rename `virusgotal-$OS-$ARCH` to `virusgotal`.
**Option 2.** If you want to build it manually then you are welcome:
```
go get -u github.com/moldabekov/virusgotal
go install -u github.com/moldabekov/virusgotal
```
*NOTE: make sure you have included $GOPATH/bin to $PATH*
You will need VirusTotal API key. You can obtain it from your profile at VT.
After obtaining it export the key to env variable:
`export VT_API_KEY=`
## Usage
At the moment `virusgotal` supports files/URLs scan and search results by file hash (SHA1/SHA256/MD5).
Syntax:
* To scan a file:
`virusgotal file `
* To rescan a file:
`virusgotal file --force`
* To wait for file scan results in a loop:
`virusgotal file --wait`
* To get JSON formatted result:
`virusgotal file --json`
* To scan a URL:
`virusgotal url `
* To rescan a URL:
`virusgotal url --force`
* To wait for URL scan results in a loop:
`virusgotal url --wait`
* To get JSON formatted result:
`virusgotal url --json`
* To lookup a file hash in VirusTotal database:
`virusgotal hash `
* Get JSON formatted result:
`virustotal hash --json`
You also can combine options: `virusgotal file --wait --json --force `
## Contribution
All kinds of contribution are welcome! Please send your PRs, bug reports, ideas, suggestions.
## License
MIT License