https://github.com/zebbern/web-shot
📸 | Takes a screenshot of every domain/link provided and saves it in /screenshots Options to choose full page picture with highly customizable options
https://github.com/zebbern/web-shot
bug-bounty custom hacker hacking osint osint-tool osint-website pentest pic-web-scraper picture png python python3 screenshot screenshot-tool tools website website-screenshot website-screenshot-capturer websites
Last synced: 6 months ago
JSON representation
📸 | Takes a screenshot of every domain/link provided and saves it in /screenshots Options to choose full page picture with highly customizable options
- Host: GitHub
- URL: https://github.com/zebbern/web-shot
- Owner: zebbern
- License: mit
- Created: 2025-02-06T21:11:02.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-02-16T22:21:17.000Z (8 months ago)
- Last Synced: 2025-04-13T16:51:09.380Z (6 months ago)
- Topics: bug-bounty, custom, hacker, hacking, osint, osint-tool, osint-website, pentest, pic-web-scraper, picture, png, python, python3, screenshot, screenshot-tool, tools, website, website-screenshot, website-screenshot-capturer, websites
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
📸 | **Takes a screenshot of every domain/link provided and saves it in /screenshots Options to choose full page picture with highly customizable options**
𝐅𝐮𝐥𝐥 𝐏𝐚𝐠𝐞 𝐒𝐜𝐫𝐞𝐞𝐧𝐬𝐡𝐨𝐭 𝐏𝐫𝐞𝐯𝐢𝐞𝐰
𝐇𝐚𝐥𝐟 𝐏𝐚𝐠𝐞 𝐒𝐜𝐫𝐞𝐞𝐧𝐬𝐡𝐨𝐭 𝐏𝐫𝐞𝐯𝐢𝐞𝐰
---
[Features](#features)
[Setup](#setup)
[Usage](#usage)
[Terminal Output For Each Domain](#terminal-output-for-each-processed-website)
[Config File](#config-file)
[Python 3.12+ Pip Fix](#python-312-pip-fix)
## Features
- **Fast & Accurate**: Captures full-page screenshots using Playwright.
- **Highly Configurable**: Customize options via `config.yaml`:
- Viewport size, image format (PNG/JPEG), quality, dark mode.
- Network options: Block images, stylesheets, JavaScript.
- Proxy support and custom headers.
- Naming schemes: Full URL, domain-only, or custom patterns.
- **Concurrency**: Process multiple websites concurrently for speed.
- **Professional Terminal Output**:
- Color-coded status codes (2xx = Green, 3xx = Yellow, 4xx/5xx = Red).
- Clear, customizable output templates.
- **Logging**: Option to log output to a file.
## Setup
**1. Clone Repository**
```
git clone https://github.com/zebbern/web-shot.git
cd web-shots
```
**2. Install Dependesies**
```
pip install playwright pyyaml colorama
playwright install
```
## Usage
1. **Prepare Your Target List**
Create a file named `domains.txt` with one domain per line.
2. **Customize `config.yaml`**
Adjust any settings (e.g., viewport size, dark mode, naming scheme) in the `config.yaml` file.
3. **Run the Script**
Execute the script to start capturing screenshots:
```bash
python webshot.py
```
## Terminal output for each processed website:
```
[1/3] [ 200 ] https://example.com https___github_com_20250310153045.png
[2/3] [ 200 ] https://example.com https___example2_com_20250310153045.png
[3/3] [ 200 ] http://example.com http___test3_com_20250310153045.png
```
## Config File
`config.yaml`
```yaml
general:
input_file: "domains.txt" # File with one domain per line.
output_dir: "screenshots" # Directory to save screenshots.
format: "png" # Image format: "png" or "jpeg".
clear_terminal: true # Clear the terminal when starting.
verbose: false # Verbose output (optional).
log_to_file: false # If true, log output to a file.
log_file: "" # Log file path (e.g., "screenshot.log").
naming_scheme: "custom" # Options: "full_url", "domain", "custom"
custom_name_pattern: "{url}" # Only used if naming_scheme is "custom"
screenshot:
width: 1920 # Viewport width in pixels.
height: 1080 # Viewport height in pixels.
scale_factor: 1 # Device scale factor.
dark_mode: true # Use dark mode for rendering.
user_agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"
full_page: true # Take a full-page screenshot.
delay: 0 # Delay (in seconds) after page load before screenshot.
quality: 80 # JPEG quality (only used if format is "jpeg").
background_color: "" # If set (e.g., "#ffffff"), sets the page background color.
concurrency:
use_concurrent: true # Process domains concurrently.
max_workers: 4 # Maximum number of concurrent browser instances.
timeouts:
navigation_timeout: 15000 # Navigation timeout in milliseconds.
wait_until: "load" # When to consider navigation done ("load", "domcontentloaded", "networkidle").
network:
block_images: false # Block image resources.
block_stylesheets: false # Block CSS resources.
block_javascript: false # Block JavaScript resources.
advanced:
custom_headers: {} # Custom HTTP headers (as a mapping).
proxy: "" # Proxy server (e.g., "http://127.0.0.1:8080").
terminal:
color_success: "GREEN" # Color for 2xx status codes.
color_warning: "YELLOW" # Color for 3xx status codes.
color_error: "RED" # Color for 4xx/5xx status codes.
color_default: "WHITE" # Default color.
output_template: "[{current}/{total}] [{status}] {url} {filename}" # Template for terminal output.
```
## Python 3.12+ Pip Fix:
### Create and Activate a Virtual Environment | Fix if `pip install` is not working or `installation` is not found.
#### For Linux/macOS:
```
python3 -m venv venv && source venv/bin/activate
```
#### For Windows:
```
python -m venv venv && .\venv\Scripts\activate
```