Flavio's app supportAll guides · Sign in

← All guides

How to use Website Screenshot Runner

Website Screenshot Runner

Capture a list of web pages as full-page PNG screenshots at several widths, with readable file names and a report of what failed.

Bought Website Screenshot Runner? Sign in with the email you bought it with to download the latest version or ask me a question.

On this page

Install

Website Screenshot Runner requires macOS 14 Sonoma or later, on Apple silicon or Intel. Download the ZIP from the order page or your Creem receipt. Unzip it and move the app to Applications.

The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose Website Screenshot Runner → Check for Updates….

The first time you open the app, the start screen lists four steps and a button for the next one that’s missing: Import a List…, Use Phone, Tablet, Laptop, Desktop, Choose Where to Save…, then Preview. Every setting lives in the sidebar and is kept between launches.

Website Screenshot Runner's start screen, with the sidebar's empty Pages box, the width chips 390, 768, 1280 and 1440, Wait until the page stops loading ticked, and the four steps Paste or import the web addresses, Turn on the widths you review at (ticked), Choose where to save the screenshots and Preview the file names, then click Capture, above an Import a List… button

Pages

Type or paste one web address per line in the Pages box. Under it, pills count the pages and the lines that will be skipped.

The Lists menu has:

The app captures only the addresses on your list. It doesn’t follow links, log in or keep cookies.

Widths

Each width is a chip. Click a chip to turn it on or off, and right-click it to remove it. Type in Add a width, like 1024 and click Add to add one, or several separated by commas (375, 414). Widths are in CSS pixels.

The Presets menu has four built-in sets:

PresetWidths
Phone, tablet, laptop, desktop390, 768, 1280, 1440
Phones360, 390, 430
Tablets768, 820, 1024
Desktops1280, 1440, 1920

Save These Widths as a Preset… adds your own, and Delete a Preset removes one.

When the page is ready

Wait until the page stops loading is on by default. After the load event, the app waits until no request (fetch, XHR, an image or another file) has run for half a second, up to 10 seconds. Turn it off to capture right after the load event.

The extra wait stepper adds 0 to 30 seconds, in half-second steps, after the page is ready. Use it for pages that animate in.

Before capturing, the app scrolls through the page once so images that load on scroll show up, then waits again.

Hide before capturing

Write one CSS selector per line, like #cookie-banner or .chat-widget. Every element that matches is hidden before the capture. A selector that isn’t valid CSS hides nothing, and the results say so.

Image

Save in

Choose the folder under Save in. Each run creates its own new folder inside it, named like Screenshots 2026-11-20 at 10.07.24. If that name exists, the new folder gets ” (2)”. Nothing is ever replaced.

Preview and capture

Click Preview (Command-R). If something is missing, the line under the button says what comes next.

The preview shows the number of pages, widths and screenshots. Skipped lines come first, in orange, with their reason. Every page has a checkbox to leave it out of this run, and shows the file name it gets at each width. Click Capture N Screenshots to start, or Back to change the settings.

The Preview screen with 4 of 4 pages, 4 widths, 16 screenshots and 2 lines skipped, the skipped lines 6 (duplicate of line 3) and 7 (contains spaces), the file names of each page at each width, and the buttons Back and Capture 16 Screenshots

While it runs, the window shows “Capturing 3 of 16”, a progress bar, and a pill per width for each page: waiting, capturing, the captured size, or failed. Stop ends the run and keeps the screenshots already saved.

Results

The done screen shows how many screenshots were saved and the name of the run folder.

The buttons are Edit the List, Retry Failed (only the failed pages at the failed widths, into a new folder), Run Again (the same list and settings, into a new folder) and Show in Finder.

The run folder

A run folder contains:

Why a page fails

SentenceWhat to do
The server answered 404 Not Found, so there’s no page to capture.Check the address, or remove the page from the list
The server answered 403: this page needs a login or isn’t public.The app captures public pages only
No website answers at this name. Check the address for typos.Fix the address
The page didn’t finish loading in 30 seconds.Try again later, or check the server
The website’s security certificate isn’t valid…The site’s HTTPS setup has a problem
Nothing came back from this address…WebKit blocks some ports, like 9 and 25
WebKit stopped while drawing this page…Try again, or lower the height limit

A server error like 500 gets its own sentence with the status code.

How a capture works

Each page and width loads in its own offscreen WebKit view, the engine Safari uses, with no cookies or saved data shared between pages. The view is the chosen width and 900 px tall. After the page is ready, the app scrolls one screen at a time and joins the screens into one PNG.

After the first screen, elements that stay fixed while you scroll (a sticky header, a chat bubble) are hidden, so they appear once instead of on every screen. A bar fixed to the bottom of the window appears at the bottom of the first screen. Sections sized in vh units use the 900 px height.

Limits:

Command line

The app includes a command line tool at Website Screenshot Runner.app/Contents/Helpers/website-screenshot-runner. It uses the same capture engine and writes the same run folders.

Capture a list at four widths, hiding a cookie banner:

website-screenshot-runner capture --list pages.txt --widths 390,768,1280,1440 --hide '#cookie-banner' --out ~/Desktop/Screenshots

Capture one page at 2× with an extra wait, and print the report as JSON:

website-screenshot-runner capture https://flaviocopes.com --delay 2 --max-height 10000 --scale 2 --out ~/Desktop/Screenshots --json

Check a list and see the file names without loading anything:

website-screenshot-runner plan --list pages.txt --widths 390,1280

Run a past run’s list and settings again, into a new folder next to it:

website-screenshot-runner rerun "$HOME/Desktop/Screenshots/Screenshots 2026-11-20 at 14.05.33"

Other capture options are --no-network-idle, --viewport-height (400 to 2000) and --timeout. website-screenshot-runner presets lists the built-in presets, and capabilities --json describes the tool for coding agents. The tool exits with 1 when a screenshot failed, and 2 when nothing could start.

Privacy

Pages load on your Mac and the PNGs are written to the folder you chose. The app uses the internet to load the pages on your list and to check for and download updates.

Website Screenshot Runner is $20, a one-time purchase.