Skip to content

WitnessMe

Web inventory tool using headless Chrome

PythonGitHub

Description

WitnessMe is a web inventory tool that takes screenshots of webpages using headless Chrome/Chromium via Pyppeteer. It features automatic technology detection, JavaScript rendering, and outputs organized screenshot galleries. Useful for visual triage of large-scale recon results.

Installation

BASH
pip3 install witnessme

# Or from source
git clone https://github.com/byt3bl33d3r/WitnessMe.git
cd WitnessMe && pip3 install .

Basic Usage

BASH
# Screenshot single target
witnessme screenshot https://target.com

# Screenshot list of URLs
witnessme screenshot -f urls.txt

# Specify output directory
witnessme screenshot -f urls.txt -o ./screenshots/

Advanced Usage

BASH
# Custom threads
witnessme screenshot -f urls.txt -t 25

# Custom timeout
witnessme screenshot -f urls.txt --timeout 30

# Screenshot a CIDR range
witnessme screenshot 10.0.0.0/24

# Start web UI to view results
witnessme gallery ./screenshots/

# With authentication headers
witnessme screenshot -f urls.txt --header "Authorization: Bearer TOKEN"

Common Workflows

BASH
# Full recon pipeline with screenshots
subfinder -d target.com -silent | httpx -silent > alive.txt
witnessme screenshot -f alive.txt -t 20 -o target_screenshots/

# Visual triage — launch gallery to review
witnessme gallery ./target_screenshots/
# Opens web browser with sortable screenshot gallery