commands // 2026-01-05 // ID: REF-Gowitness Command List

Gowitness Command List


Gowitness Command Guide

Gowitness is a website screenshot utility written in Golang. Useful for visual reconnaissance of large lists of subdomains.

Top 10 Useful Commands

1. Single Site

gowitness single --url http://example.com

Explanation: Screenshots one URL.

2. File Input

gowitness file -f urls.txt

Explanation: Screenshots every URL in the list.

3. Nmap Input

gowitness nmap -f scan.xml

Explanation: Parses an Nmap XML result and screenshots open web ports.

4. Threads

gowitness file -f urls.txt --threads 10

Explanation: Screenshots in parallel.

5. Server Mode

gowitness server

Explanation: Starts a web server to view the report gallery.

6. Resolution

gowitness single -u http://example.com --resolution 1920x1080

Explanation: Sets capture resolution.

7. Timeout

gowitness file -f urls.txt --timeout 10

Explanation: Sets timeout (seconds) per page.

8. Delay

gowitness file -f urls.txt --delay 5

Explanation: Waits 5 seconds before taking screenshot (waiting for animations/loading).

9. Database Name

gowitness file -f urls.txt --db scan.db

Explanation: Specify SQlite db file name.

10. Full Page

# (Older versions supported full page, modern usage relies on resolution)

Explanation: Gowitness focuses on viewport, ensure resolution is high for "full" feel.

The Most Powerful Command

gowitness file -f alive_subdomains.txt --threads 20 --resolution 1280x1024; gowitness server

Explanation: Rapidly screenshot hundreds of hosts and then immediately spin up a local gallery to "scroll" through the targets visually.