LinuxCommandLibrary

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)

Copied to clipboard