Installation

Installing gowitness is really easy, and you have a few options to do so.

After installing Google Chrome or Chromium for your Operating System:

• Use go install github.com/sensepost/gowitness@latest if you have the go binary in your $PATH
• Download prebuilt binaries from the releases page.
• Compiling from source.
• Via docker.

Once installed, you should be able to use the gowitness command.

$ gowitness
A commandline web screenshot and information gathering tool by @leonjza

Usage:
  gowitness [command]

Available Commands:
  file        screenshot URLs sourced from a file or stdin
  help        Help about any command
  nmap        Screenshot services from an Nmap XML file
  report      Work with gowitness reports
  scan        Scan a CIDR range and take screenshots along the way
  server      Starts a webservice that takes screenshots
  single      Take a screenshot of a single URL
  version     Prints the version of gowitness

Flags:
  -D, --db-path string           destination for the gowitness database (default "gowitness.sqlite3")
      --debug                    enable debug logging
      --disable-db               disable all database operations
      --disable-logging          disable all logging
  -F, --fullpage                 take fullpage screenshots
  -h, --help                     help for gowitness
  -X, --resolution-x int         screenshot resolution x (default 1440)
  -Y, --resolution-y int         screenshot resolution y (default 900)
  -P, --screenshot-path string   store path for screenshots (use . for pwd) (default "screenshots")
      --timeout int              preflight check timeout (default 10)
      --user-agent string        user agent string to use (default "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.102 Safari/537.36")

Use "gowitness [command] --help" for more information about a command.

building from source

The Makefile contains a number of targets to help you build gowitness from source. The general flow to build is:

• Ensure that you have at least Golang version 1.17.
• Ensure that you have the relevant toolchain installed if you want to cross-compile. (The Makefile uses docker containers to achieve this for release builds)
• Clone this repository and cd into it.
• Build binaries with the make command. You can specify a specific target for make, such as make linux too.