Capture screenshots from a video or browsing recording

Request access

Docs Agent is available to all plans, but we grant access on request. Contact support@ekline.io to request access.

Screenshots make a guide easier to follow, but capturing them by hand is slow. You replay a recording, pause at the right moment, crop the frame, and save it somewhere your docs can reach.

Docs Agent does this for you. Point it at a second of a video and it extracts that frame as a PNG, commits it to your repository, and adds the markdown reference in the page you are writing. This guide shows you how, using either a video you upload or the recording the agent captures while it browses.

Before you begin

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.

An uploaded video must meet these limits:

Requirement	Value
Formats	MP4, WebM, MOV, AVI, MPEG, OGG
Maximum size	500 MB

Step 1: Give the agent a source

Choose the source that matches where your moment lives.

Uploaded video

1. Log in to your EkLine dashboard and click Docs Agent in the left navigation.

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

3. Wait for processing to finish. 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 processing completes.

Browsing recording

Some tasks lead the agent to open a browser — for example, when you ask it to document a page in your product. The agent records what it visits and keeps the recording with the session, so you can pull a frame from it afterward.

1. Ask the agent to visit the pages you want to illustrate. For example:

   Open our pricing page and document the plan tiers.

2. Watch the Live browser panel in the bottom-right corner of the editor to see the pages it visits.

3. Wait for the agent to finish browsing. The panel header changes to Recording, and the recording is available for the rest of the session.

To reach pages behind a sign-in, set up a sandbox first.

Step 2: Find the moment you want

The agent already has a timestamped reading of the video, so you can ask it where something appears 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?

Tip

If you already know the timestamp, skip to the next step and name it directly.

Step 3: Ask for the frame

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

Insert into a page

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.

Several frames

Extract frames at 12, 47, and 90 seconds and place each
one next to the step it illustrates in
docs/billing/change-plan.md.

From a browsing recording

Extract the frame from the browsing recording where the
pricing table is fully visible, and add it to the
overview page with a caption.

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

Frames land on the nearest keyframe

The agent seeks to the timestamp you give and captures the closest available frame, which can be slightly earlier than the exact second. If the captured image is a moment early, ask for a second or two later.

Step 4: Check the image in the editor

Select the image file in the editor panel. The draft 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.

Step 5: Publish as a pull request

1. Enable View All Changes in the toolbar to see a diff of what the agent created.

2. Click Raise PR. The agent prefills a prompt in the chat — press Enter to send it, or edit the prompt 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.

Verify

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.

Troubleshooting

Issue	Solution
The agent says it cannot read the video	Check 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 early	The agent captures the nearest available frame. Ask for a timestamp one or two seconds later.
The frame from a browsing recording looks low resolution	A 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 session	Recordings 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 page	Name the heading or step you want it after, then ask the agent to move it.

Next steps

• Create documentation from a demo video — Turn a whole walkthrough into a written guide.
• Browse authenticated pages with a sandbox — Let the agent sign in to your product and capture pages directly.
• Create documentation — Generate guides, READMEs, and references from your codebase and other sources.