PageShot

Capture screenshots of web pages from specified URL using Rust. Customize viewport dimensions and save the resulting image in PNG format. You can customize the viewport dimensions and save the resulting image in PNG format.

Features

• Capture screenshots from any URL.
• Customize viewport width and height.
• Full-page screenshots that capture entire scrollable content.
• Multiple output formats: PNG, JPEG, WebP.
• Quality control for JPEG and WebP formats.
• Device scale factor / pixel ratio control (Retina/HiDPI support, 1.0 to 4.0).
• Simple command-line interface.

Installation

To build and run PageShot, make sure you have Rust and Cargo installed. Clone this repository and use Cargo to build the project:

cargo install pageshot

Usage

Run the compiled binary with the desired URL, viewport dimensions, and output file name:

pageshot -u https://example.com --width 1920 --height 1080 -o example.png

# Capture full-page screenshot (entire scrollable content)
pageshot -u https://example.com -f -o example_fullpage.png

# JPEG format with quality control (smaller file size)
pageshot -u https://example.com --format jpeg --quality 85 -o example.jpg

# WebP format for best compression
pageshot -u https://example.com --format webp --quality 90 -o example.webp

# Full-page JPEG with lower quality for smaller file size
pageshot -u https://example.com -f --format jpeg --quality 70 -o fullpage.jpg

# Retina/HiDPI 2x resolution screenshot (doubles pixel dimensions)
pageshot -u https://example.com --width 800 --height 600 --scale 2.0 -o retina_2x.png

# Ultra HD 3x resolution for maximum clarity
pageshot -u https://example.com --scale 3.0 -o ultra_hd_3x.png

# Silent mode for scripts (no output, only exit code)
pageshot -u https://example.com -s -o screenshot.png

Arguments

• -u, --url <URL>: The URL of the web page to capture.
• --width <WIDTH>: The width of the viewport (default: 1920).
• --height <HEIGHT>: The height of the viewport (default: 1080).
• -o, --output <FILE>: The name of the output file (default: screenshot.png).
• -f, --full-page: Capture the entire scrollable page content, not just the viewport.
• --format <FORMAT>: Output format - png, jpeg, or webp (default: png).
• --quality <QUALITY>: Quality for JPEG/WebP, 0-100 where higher is better (default: 85).
• --scale <SCALE>: Device scale factor / pixel ratio (default: 1.0). Use 2.0 for Retina 2x, 3.0 for 3x.
• -s, --silent: Suppress success message. Useful for scripts and automation.

Format Recommendations

• PNG: Lossless quality, best for documentation and pixel-perfect captures. Larger file size.
• JPEG: Good for general web captures. Use quality 70-85 for balanced size/quality, 90-100 for high quality.
• WebP: Modern format with best compression. Recommended for sharing and storage efficiency.

Scale Factor / Device Pixel Ratio

The --scale parameter controls the device pixel ratio, similar to Retina and HiDPI displays:

• 1.0 (default): Standard resolution. An 800×600 viewport produces an 800×600 pixel image.
• 2.0 (Retina): 2x resolution. An 800×600 viewport produces a 1600×1200 pixel image (4× more pixels).
• 3.0 (Ultra HD): 3x resolution. An 800×600 viewport produces a 2400×1800 pixel image (9× more pixels).

Use Cases:

• Scale 1.0: Fast captures, smaller file sizes, adequate for most uses
• Scale 2.0: High-quality captures for print or detailed analysis, matches macOS Retina displays
• Scale 3.0: Maximum detail for zooming or professional use, matches iOS device displays

Note: Higher scale factors produce larger file sizes but capture text and images with much greater clarity.

License

This project is licensed under the MIT License. See the LICENSE file for details.