git404hub

what is site-post-screenshots fr?

kappaemme-git/site-post-screenshots — explained in plain English

Analysis updated 2026-05-18

4JavaScriptAudience · writerComplexity · 2/5Setup · easy

tl;dr

CLI that drives Playwright Chromium to capture desktop, mobile, and side-by-side composite screenshots of any URL, sized for X and social posts.

vibe map

mindmap
  root((site-post-screenshots))
    Inputs
      Website URL
      Output folder
      Viewport flags
      Selector filters
    Outputs
      Desktop PNG
      Mobile PNG
      1600x900 social images
      Side by side composite
    Use Cases
      Make social post previews
      Generate blog hero images
      Capture specific page region
      Hide cookie banners
    Tech Stack
      Node
      Playwright
      Chromium
      JavaScript

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Generate social-ready desktop and mobile screenshots of a launch page

VIBE 2

Capture a specific page section while hiding cookie banners

VIBE 3

Batch-produce composite screenshots for a weekly site review newsletter

VIBE 4

Take delayed screenshots to wait out animations before capture

what's the stack?

NodePlaywrightChromiumJavaScript

how it stacks up fr

kappaemme-git/site-post-screenshotsarata-ae/purupurupngtubercarrycooldude/nova-ide
Stars444
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderate
Complexity2/53/5
Audiencewritergeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Needs an extra npx playwright install chromium on first run if Chromium is not already present.

in plain english

site-post-screenshots is a small command-line tool that turns any live website into a set of polished screenshots ready to drop into a social media post. The author calls it out as targeted specifically at people who write about websites and want consistent, share-ready images without manually opening a browser, resizing the window, and cropping by hand. The headline usage is a single npx command: point it at a URL and an output folder, and the tool produces several PNG files. The default set includes a raw desktop capture, a raw mobile capture, two 1600 by 900 images sized for X (one desktop, one mobile), a 1600 by 1200 desktop image, and a composite that puts the desktop and mobile views side by side. The tool can be installed globally with npm install -g, after which it is available as either site-post-screenshots or the shorter alias site-post-shots. Under the hood it uses Playwright to drive Chromium, so a separate npx playwright install chromium step may be needed the first time if the browser is not yet on the machine. Several command-line options let the author tune the capture. Custom desktop and mobile viewport sizes can be passed with --desktop and --mobile in WxH form. A --delay flag waits before taking the shot, useful for sites with animations or lazy-loaded content. A --selector flag captures only a specific page region, and --hide-selectors takes a comma-separated list of CSS selectors to remove before capture, which the README suggests for hiding cookie banners and chat widgets. The README closes with publishing notes for anyone who wants to fork the project to npm: run npm run check, dry-run a pack to verify what would be uploaded, then npm login and npm publish under the public access flag. A reminder is included that the name on npm may already be taken, in which case the package.json name field needs changing before publishing.

prompts (copy fr)

prompt 1
Wrap site-post-screenshots in a GitHub Action that runs on push and uploads the PNGs as artifacts
prompt 2
Add a --format webp flag to site-post-screenshots and route through sharp for compression
prompt 3
Write a shell loop that runs site-post-screenshots over a list of URLs from a CSV file
prompt 4
Add a watermark step to site-post-screenshots using Jimp before saving the composite image
prompt 5
Build a small Express server that exposes site-post-screenshots as an HTTP endpoint with query params

Frequently asked questions

what is site-post-screenshots fr?

CLI that drives Playwright Chromium to capture desktop, mobile, and side-by-side composite screenshots of any URL, sized for X and social posts.

What language is site-post-screenshots written in?

Mainly JavaScript. The stack also includes Node, Playwright, Chromium.

How hard is site-post-screenshots to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is site-post-screenshots for?

Mainly writer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.