sootsim screenshot

capture the canvas (full or cropped) as PNG

sootsim screenshot

Capture the canvas from the currently connected sim — 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). aliases: -o, —out, —file, —path
--area <x,y,w,h>crop to a logical sootsim rect. aliases: —rect, —crop
--id <testID>crop to the bounding box of a node by testID. alias: —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
--no-shellexclude the simulated iOS chrome (status bar, keyboard, toasts) — capture tenant surfaces only
--shell-onlycapture only the shell chrome, no tenant content

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
sootsim screenshot --no-shell --output tenant-only.png

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.

Ready to build?

Run your React Native app in the browser. No simulators, no native toolchain, no waiting.

npm i -g sootsim