Recording with AgentEyes

4 min read

AgentEyes records your screen and audio from named presets, keeps the results in a recording library, and can turn any recording into a transcript and a shareable write-up. It also snips screenshots from any app, with or without a recording running. This page covers what you can do today from the tray app; to script the same things, see the CLI reference.

Presets: pick one and record

A preset is a named capture profile, in the spirit of OBS scenes. A preset decides which monitor or region to capture, whether it records video, audio, or a single screenshot, how the audio is handled, and whether a webcam is filmed alongside the screen. You set a preset up once, then choose it and hit record.

Source. A whole monitor, or a region you draw.
Audio. Your microphone, the system (loopback) audio, or the two mixed together. Mic only is the default, because it captures the room correctly timed; mixing in the system audio is a deliberate choice. Noise suppression and voice leveling are applied to the mic unless you turn them off, and a noise gate is on for system and mixed audio.
Mode. Video, audio, or a screenshot.
Camera. Optional - see below.

Film your camera alongside the screen

A preset can name a webcam and a frame rate, and AgentEyes records it to its own camera.mp4 beside the screen video. How the camera is framed over the screen - a circle or a rectangle, which corner it sits in, how big it is, and which part of the camera frame the circle takes - is chosen in the preset editor before you record, against a live picture from the camera.

Note

The camera is always recorded whole, whatever framing you picked, so the framing is a decision you can change afterwards. Change it and run agenteyes compose on the recording folder to render the video again - see the CLI reference. A recording with no camera is unaffected.

Snip a screenshot from any app

Two global shortcuts take a screenshot without any recording running: PrintScreen lets you drag a rectangle, and Ctrl+PrintScreen takes a whole monitor. Each snip is saved as a PNG and copied to the clipboard, and the Capture view in the app lists them so you can find one again.

Where they land. The Windows Screenshots folder by default (including when OneDrive has redirected it), or any folder you set instead.
Rebindable. Both shortcuts are set in the Capture view and the new binding survives a restart - useful if Windows has claimed PrintScreen for its own tool.

The recording library

Recordings are saved under %USERPROFILE%\Videos\AgentEyes\, one folder per recording. The tray app lists your recent recordings so you can find, play, and act on them. Each recording folder holds the captured video or audio, the camera track if there was one, any screenshots you took mid-recording, and - once you build it - the transcript.

Note

AgentEyes today is a record-when-you-choose tool: you pick a preset and start. The always-on rolling buffer - a recorder that is always capturing so you can reach back and keep a moment after the fact - is the product's larger goal and is still on the roadmap, not something you can rely on yet.

What happens after you stop

Stopping is not the end of the work. Finishing the audio mix, rendering the camera into the video, making the thumbnail, transcribing and titling all run as one named sequence after the stop, so the app answers straight away and the recording keeps finishing behind it.

Each step records what it did in the recording's own folder, so an interrupted sequence - you closed the app, the machine restarted - picks up at the step it reached the next time AgentEyes runs, instead of starting over or being abandoned.

Turn a recording into a write-up

The walkthrough builder takes a recording and produces two things: a transcript of what was said, and a shareable HTML write-up that pairs the transcript with screenshots from the recording. The raw capture becomes something you can drop into a ticket, a document, or a message without editing video.

Note

Building the transcript uses DevThrottle's hosted transcription through your signed-in account: the recording's audio is sent to DevThrottle to be transcribed, and the transcript comes back. The video file is not part of that request.

Tip

AgentEyes has its own Dictionary view for the terms transcription keeps getting wrong - your product names, your people, your jargon. Every term you list is applied to a recording's transcript by plain find and replace before the transcript is written and before the title is generated, so the transcript, the walkthrough and the title all get it right. It is AgentEyes' own list, kept on this machine; it is not the DevThrottle dictionary and the two are not shared.

Where to go next

To bring an existing video into the library, see Import a video. To caption a recording in another language, see Multilingual subtitles. To do any of this from a script, see the CLI reference and the Control API.