Skip to content

Capture screenshots from a video or browsing recording

Docs Agent turns a moment in a video into a documentation screenshot. Point it at a second of a video and it extracts that frame as a PNG, saves it with your documentation files, and adds the markdown reference in the page you are writing. The video can be one you upload or the recording the agent makes while it browses.

You need:

  • An EkLine account with Docs Agent enabled.
  • A repository connected to EkLine where the documentation lives.
  • A source that contains the moment you want to capture, either an uploaded video or a session in which the agent browsed.
  • For a browsing recording, the Sandbox tab under Settings > Docs Agent. If you don’t see it, contact support@ekline.io.

An uploaded video must meet these limits:

RequirementValue
FormatsMP4, WebM, MOV, AVI, MPEG
Maximum size500 MB

Choose the source that matches where your moment lives.

  1. Sign in to the EkLine app and click New session in the sidebar. If the composer shows Docs and Marketing, select Docs.

  2. Click the attachment icon in the chat panel and select your video file.

  3. Wait for the upload to finish. When you send your message, the agent transcribes the video and reads what happens on screen, which takes a few minutes for a longer recording.

The video appears as an attachment in the chat panel once the upload completes.

Ask the agent where something appears in the video instead of scrubbing through the recording yourself.

Which second of this video shows the billing settings
page with the plan selector open?

The agent answers with a timestamp. Ask follow-up questions if several moments look similar:

Is the success message visible at that point, or does it
appear later?

Name the second you want and where the image belongs. Telling the agent what the screen shows helps it write useful alt text.

Extract the frame at 47 seconds and insert it into
docs/billing/change-plan.md after the "Open billing
settings" step. Write alt text describing the plan
selector.

The agent extracts the frame, saves it as a PNG in your repository, and adds the markdown reference in the page you named.

Select the image’s tab in the editor panel. The image renders inline, with the filename and a status badge below it. Click the preview to open the image larger.

Check that:

  • The frame shows the screen or action you meant to capture.
  • The image sits next to the step it illustrates.
  • The alt text describes what the screen shows.

If the frame is wrong, reply in the chat with a corrected timestamp:

That frame is too early. The dialog is still opening.
Extract the frame at 50 seconds instead.
  1. Enable View All Changes in the toolbar to see a diff of what the agent created.

  2. Click Raise PR. The chat box fills with Open a pull request for and your repository’s name. Press Enter to send it, or edit it first to add instructions.

The agent opens the pull request and replies in the chat with a link. Extracted images commit alongside your documentation changes, so the page and its screenshots land in the same pull request.

Confirm the capture worked:

  • The image file appears in the editor panel and previews inline.
  • The page you named has a markdown reference to the new image.
  • The pull request includes both the page and the PNG file.
IssueSolution
The agent says it cannot read the videoCheck that the file finished processing and is under 500 MB in a supported format. Re-upload it if processing failed.
The captured frame is a moment too earlyThe screen was still changing at that second. Ask for a timestamp one or two seconds later.
The frame from a browsing recording looks low resolutionA recording captures the browser viewport at the recording’s resolution. For a crisp image, ask the agent to capture the page directly with a sandbox instead.
The agent cannot find a recording for the sessionRecordings exist only for sessions in which the agent browsed. Ask it to visit the page first, then request the frame.
The image reference points at the wrong place in the pageName the heading or step you want it after, then ask the agent to move it.

Built on Potluck Docs, our open source template.