Need pixel-perfect product visuals without manual effort? Simon Willison’s latest note on shot-scraper and video workflows highlights a fast path: automate screenshots—and even short browser demos—using a lightweight CLI built on Playwright.
What is shot-scraper?
shot-scraper is a command-line tool that drives a real browser (via Microsoft’s Playwright) to capture consistent, reproducible screenshots. It’s ideal for docs, release notes, and marketing visuals.
Why it matters
Manual screenshots are slow and inconsistent. Automating them makes visuals repeatable across versions, CI, and teams—so you can refresh images in minutes, not hours.
Quick start (3 minutes)
- Install: pipx install shot-scraper (or use pip in a virtualenv).
- Set up browsers: shot-scraper install (downloads Playwright browsers).
- Grab a page: shot-scraper https://example.com –output homepage.png
- Capture a specific element: shot-scraper https://example.com –selector “.cta-button” –output cta.png
Tip: For more options (viewport size, dark mode, waiting for elements, etc.), see the official CLI reference.
Short demo videos
Want motion? Willison’s post covers approaches to generate short browser walkthroughs using shot-scraper with Playwright. For robust recording options, consult Playwright’s video capture docs and combine them with your favorite editor (or ffmpeg) for trimming.
Make it reliable
- Stabilize timing: wait for a selector or a short delay before capture.
- Pin versions: keep Playwright and fonts consistent across machines/CI.
- Control environment: set a fixed viewport, theme (light/dark), and locale.
- Test determinism: re-run scripts on CI to catch layout regressions early.
Great use cases
- Docs and tutorials with consistent UI shots
- Release notes and changelogs with before/after diffs
- Marketing visuals for landing pages and app stores
- Visual regression checks in CI pipelines
Takeaway: Use shot-scraper for repeatable, high-quality visuals—and reach for Playwright’s video features when you need short demo clips.
Enjoy bite-sized AI and tooling tips? Subscribe to our newsletter for weekly nuggets.
