jjw24/VirusTotal Scanner Action
Scan files with VirusTotal, view results directly in job output, and automatically pass or fail based on the scan outcome.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| api-key | VirusTotal API key | yes | — |
| scan-paths | Comma- or newline-separated file or directory paths to scan | yes | — |
| no-cache | Skip cache lookup (all files will be resubmitted to VirusTotal) | no | false |
| cache-path | Path to cache file (relative to workspace root) | no | vt_cache.json |
| whitelist-path | Path to whitelist file (relative to workspace root) | no | vt_whitelist.json |
| report-path | Path to write JSON report output (relative to workspace root) | no | vt_report.json |
| request-interval-sec | Minimum seconds between VT API requests | no | 15 |
| analysis-poll-timeout-sec | Maximum seconds to wait for VT analysis to complete | no | 600 |
| download-timeout-sec | Timeout in seconds for file uploads to VT | no | 120 |
| max-report-age-days | Maximum age of a cached VT report in days before forcing a fresh upload (0 = never discard) | no | 30 |
Outputs
| name | description |
|---|---|
| exit-code | Pipeline exit code (0 = all passed, 1 = some failed) |
| report-path | Path to the generated JSON report file |
| passed-count | Number of files that passed the scan |
| failed-count | Number of files that failed the scan |
| total-count | Total number of files scanned |