sootsim screenshot

Capture the canvas from the currently connected sootsim session — full-screen by default, or cropped to a logical rect via —area / —id / —text. Falls back to a fresh headless chromium when no bridge is running.

terminal

sootsim screenshot [options]

Options

flagdescription
--output <path>output file path (default: /tmp/sootsim-inspect.png)
--area <x,y,w,h>crop to a logical sootsim rect
--id <testID>crop to the bounding box of a node by testID
--text <text>crop to the bounding box of a node by text content
--gallerycrawl and capture multiple screens into an HTML gallery
--themescapture light and dark variants where possible

Examples

terminal

sootsim screenshot --output app.png
sootsim screenshot --area 0,200,393,400
sootsim screenshot --id loginButton --output button.png
sootsim screenshot --gallery --themes

Gallery mode exists so you do not have to hand-curate every target screen. It is especially useful for:

  • visual smoke coverage after renderer changes
  • theme reviews
  • design QA passes across multiple entry points

If you only need one artifact, use --output and keep the capture narrow.