ZeptapDocs
Commands

screenshot

Save the settled screen as a JPEG and print its path and size.

Usage

zeptap screenshot [-o <path>] [--if-changed] [--annotate]

Options

OptionDescription
-o, --out <path>Save to this path. A .png path saves a PNG
--if-changedIf the screen hasn't changed since the last screenshot, print that file's path instead of saving a new one
--annotateDraw each text line's box and its @t number on the image, and print the lines

Also takes the global options.

Details

  • The screenshot is taken after the screen stops moving (up to --settle-ms, default 3000).
  • Files go to ./.zeptap/shots/, numbered and limited to the last 50. See Screenshots.
  • Coordinates for touch commands are pixels in this image, origin top-left. Send the numbers you read; don't rescale them.
  • --if-changed saves tokens in a polling loop: the agent opens the file only when the path changes.
  • --annotate also refreshes the @t refs, so the numbers on the image work with tap.

Examples

$ zeptap screenshot -l 7
screenshot: /Users/you/project/.zeptap/shots/0043.jpg (591x1280 px; tap coordinates are pixels in it)

$ zeptap screenshot -l 7 -o ~/Desktop/home.png
$ zeptap screenshot -l 7 --annotate
$ zeptap screenshot -l 7 --if-changed

MCP tool

screenshot.

On this page