Read & review

Recording, styling and effects let an agent make a video. screenify read lets it look at one — so it can check its own work before handing it to you, instead of guessing.

screenify read --list --json                                          # what can be read, and each reader's options
screenify read frame --project ~/Desktop/demo.mp4 --at 8 --json       # one frame of a video you exported
screenify read transcript --project demo.screenify --json             # what is said, with times
screenify read timeline --project demo.screenify --json               # what is on the timeline, second by second
screenify read events --project demo.screenify --json                 # what a web recording clicked, typed and visited

AI apps without a terminal (Claude Desktop, Cursor, …) get the same thing through one tool of the MCP server: read_project, with kind set to frame, transcript, timeline or events.

What it can read

Pass options with --arg key=value (repeatable). --at and --out are shortcuts for the two most common ones.

Look at the video you just exported

frame reads either a .screenify project or an exported video file. When an agent has just exported a video with styling flags — a 3D device, an environment, a wallpaper — read the exported file: those flags apply to that export only and are not saved back into the project, so the project alone would not show them.

screenify read frame --project ~/Desktop/launch.mp4 --at 12 --json              # a preview image, sized for AI vision
screenify read frame --project launch.screenify --at 3 --out ~/Desktop/a.png --json  # full resolution, from the project

Reading a project renders the frame with the project's own settings — exactly what a plain screenify export of it would show. A recording that was never styled gets a random wallpaper when exported, so for those the result carries a warning to read the exported file instead.

Times are timeline seconds

Every time you pass in and every time you get back is a second of the finished video — after cuts, speed changes and intro or outro spaces. A web recording's clicks are mapped the same way, so an agent can put a title exactly on the moment something was clicked. A click that happened in a part that was cut is still listed, marked as not in the video.

"Not available" is an answer

Every read returns either the data or a short explanation of why there is nothing to read and what to do next:

{ "available": false, "kind": "transcript",
  "reason": "No captions and no AI-voiceover script in this project",
  "action": "Open the project in Screenify Studio → Captions → Generate (or add an AI voiceover from a script), then read again." }

That is a normal result, not an error. transcript reads the captions and scripts already in the project — it does not transcribe audio by itself, so a recording with speech but no captions needs Captions → Generate in the app first.

Review before you share

review checks a finished demo against rules you can measure, and returns {pass, failures, warnings} plus a contact sheet — one image with a frame every few seconds and the middle of every title and graphic.

screenify read review --project ~/Desktop/demo.mp4 --json

It also lists the pages the recording visited, so you can check none of them shows anything private. Pass the exported video to review exactly what you will share — the command line remembers which project and settings each export came from. demo build runs this for every file it makes. Through MCP it is read_project with kind: "review".

Reading never changes anything

Readers only read. Your project, its settings and its media stay exactly as they were — reading a frame renders from a private copy, never from the project itself.

Things worth asking for

• "Look at the video you just exported — anything that looks off before I post it?"
• "What does the narrator say between 20 and 40 seconds?"
• "Which zooms are already in this project?"
• "Add a title 'See pricing' right when I clicked Pricing in my web demo."
• "Save a full-resolution still of second 3 to my Desktop."