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