+2
日增长
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
#580Unknown error while attempting to screenshot9 comments · 2022-08-25#716[Errno 8] Exec format error: '/usr/local/bin/geckodriver'7 comments · 2025-11-20#532Feature idea, grab favicon7 comments · 2021-06-09#643 log redirects (http, html or js redirects)4 comments · 2024-02-13#310feature idea - Capture CN & SAN from SSL 3 comments · 2018-02-13#727setup.ps1 has a syntax issue2 comments · 2026-06-24#719messed up pagination2 comments · 2025-12-04#726python3-venv not there on Red Hat Rocky 9.71 comments · 2026-06-01
Latest release
v20230525.1 v20230525.1 2023-05-25Automated build triggered by update Changes: 7ed776489ac785260c8157a7fdbe7b2cd892e8f3 Added signatures This list of changes was auto generated.