cutycapt
Convert webpage into image or document
SYNOPSIS
cutycapt [--help] [--version] --url=<URL> [--out=<FILE>] [options]
PARAMETERS
--url=URL
URL of the web page to capture (required)
--out=FILE
Output image file; defaults to stdout
--width=W
Viewport width in pixels (default: 1024)
--height=H
Viewport height in pixels (default: 768)
--min-width=W
Minimum width for page scaling
--min-height=H
Minimum height for page scaling
--delay=T
Delay in seconds before capture (default: 0)
--pad=WxH
Padding around the capture in pixels
--scale=FACTOR
Scale factor for the output image
--dpi=D
DPI for the output image
--format=png|jpg|bmp|tiff
Output image format (default: png)
--quality=0-100
JPEG quality (default: 95)
--bgcolor=COLOR
#RRGGBB background color
--user-stylesheet=FILE
Custom CSS stylesheet file
--user-agent=STRING
Custom User-Agent header
--javascript=off
Disable JavaScript execution
--js-can-open-windows=on|off
Allow JS to open new windows
--print-background=on|off
Print CSS backgrounds (default: off)
--verbose
Enable verbose logging
--help
Show usage help
--version
Show version information
DESCRIPTION
Cutycapt is a lightweight, command-line utility that leverages QtWebKit to render and capture screenshots of web pages as image files. It allows users to automate the process of taking snapshots of websites, useful for testing, documentation, monitoring, or generating thumbnails.
By specifying a URL, output file, dimensions, and other parameters, cutycapt loads the page in a headless WebKit browser, waits for JavaScript execution if needed, and saves the viewport as PNG, JPEG, BMP, or TIFF. It supports custom user agents, stylesheets, delays for dynamic content, and background printing options.
Ideal for scripts and cron jobs, it outputs to stdout by default or a file. However, relying on the aging Qt4 WebKit engine, it may struggle with modern web standards like HTML5 video, WebGL, or complex CSS3/JS frameworks.
CAVEATS
Uses deprecated Qt4 WebKit; poor support for modern JS/CSS. Unmaintained since 2011; security risks from old engine. Install Qt4 dev libs required.
INSTALLATION
On Debian/Ubuntu: sudo apt install cutycapt. Requires Qt4 WebKit; compile from GitHub source if unavailable.
Aliases: cuty.
EXAMPLE USAGE
cutycapt --url=http://example.com --out=example.png --width=800 --delay=3
Captures example.com after 3s delay at 800px width.
HISTORY
Created by Arun Shankar in 2009 as a simple WebKit snapshot tool. Reached version 0.2.0 in 2011. Abandoned due to Qt4 deprecation; forks exist but inactive.
SEE ALSO
wkhtmltoimage(1), webkit2png(1), convert(1)


