RedSiege /EyeWitness

EyeWitness is designed to take screenshots of websites, provide some server header info, and identify default credentials if possible.

★ 5,894⑂ 906👁 139⑃ 246● 471▤ 102
PythonGPL-3.0Created 2014-02-26
Download: v20230525.1EyeWitness-20230525.1 ↓20230525.12023-05-25
+2
Daily
5,894
stars
906
forks
139
watchers
246
prs
471
issues
102
releases

README

EyeWitness - Web Screenshot Tool

EyeWitness is designed to take screenshots of websites, provide server header info, and identify default credentials if known. Now powered by Chromium browser for better reliability and easier installation.

 🚀 Key Features
- Cross-platform support - Windows, Linux, and macOS
- Chromium-powered - Reliable headless screenshots with Google Chrome/Chromium
- Adaptive resource management - Automatically adjusts to system capabilities
- Configuration file support - Save your preferred settings
- URL validation - Pre-flight checks to ensure URLs are valid
- Progress tracking with ETA - Know exactly when your scan will complete
- Enhanced error handling - Specific error types with actionable guidance
- Multiple input formats - Text files, Nmap XML, Nessus XML
- Isolated virtual environment - Zero system conflicts and PEP 668 bypass

 🔒 Virtual Environment Architecture

EyeWitness now uses Python virtual environments for all installations, providing:

 ✅ Key Benefits
- No system conflicts - All Python packages installed in isolated environment
- No PEP 668 issues - Completely bypasses "externally-managed-environment" errors on Kali/modern Linux
- Cross-platform consistency - Same approach on Windows, Linux, and macOS
- Easy cleanup - Delete eyewitness-venv/ directory to remove everything
- Production ready - Automatic error handling and rollback on failures

 🚀 How It Works
1. Setup creates virtual environment - eyewitness-venv/ directory with isolated Python
2. Activate the virtual environment - Simple command to enter the isolated environment
3. All packages installed in isolation - Zero impact on your system Python
4. Run EyeWitness normally - Standard Python commands work within the virtual environment

 📁 File Structure After Installation

EyeWitness/
├── eyewitness-venv/           🔒 Virtual environment (isolated Python packages)
│   ├── bin/activate           Linux/macOS activation script
│   └── Scripts/activate.bat   Windows activation script
├── Python/
│   └── EyeWitness.py          📜 Main script (runs in virtual environment)
└── setup/                     Setup scripts and requirements


 📦 Installation Options

 🔥 NEW: EyeWitness now uses Python virtual environments for zero conflicts and bulletproof installation across all platforms!

 Note: Docker support is currently in development. Please use native installation options below for now.

 🪟 Windows Installation
Automated setup with Python virtual environment:

powershell
 1. Open PowerShell as Administrator
 2. Navigate to EyeWitness directory
cd path\to\EyeWitness\setup

 3. Run the setup script (creates virtual environment)
.\setup.ps1

 4. Test installation by activating virtual environment
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com


What gets installed:
- 🔒 Isolated Python virtual environment (eyewitness-venv/)
- Python dependencies in virtual environment (selenium, etc.)
- Google Chrome browser 

Top issues

Latest release

v20230525.1 v20230525.1 2023-05-25
Automated build triggered by update

 Changes:

 7ed776489ac785260c8157a7fdbe7b2cd892e8f3 Added signatures

This list of changes was auto generated.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON