Docs/AgentEyes/Overview
AgentEyes

AgentEyes: a screen and audio recorder for Windows

4 min read

AgentEyes is a screen and audio recorder for Windows that lives in your tray. It records your screen, your microphone and - if you want one - your webcam, and turns a recording into a searchable transcript and a shareable write-up. It is its own download, separate from DevThrottle: you do not need an account to record, and the steps that use hosted AI work through your DevThrottle account, so one account covers both.

How recording and transcription work

It is worth being precise about where your recordings go, because AgentEyes uses both your machine and DevThrottle's hosted AI:

  • On your machine. Recording, the recording library, rendering the camera into the video, and burning subtitles into a video all run on your own PC, and you do not need a DevThrottle account to record.
  • Sent to DevThrottle's hosted AI. Turning a recording into a transcript, translating a transcript, and generating a recording's title and description use DevThrottle's hosted AI through your signed-in account. For those steps, the recording's audio (to transcribe) or text (to translate) is sent to DevThrottle. See Import a video and Multilingual subtitles for exactly what is sent and when.

Visible and controllable

An always-on recorder only works if you stay in control of it, so two things are built in rather than buried in a settings page:

  • Visible. A recording indicator is on whenever it is capturing. There is no stealth mode, ever - you always know when it is running.
  • Controllable. One action stops everything, from the window, the recording indicator, or the tray.

What it does today

  • Records with a click. OBS-style named presets pick a monitor or a region, choose the audio, and capture screen, audio, or a single screenshot. See Recording.
  • Films you as well as the screen. A preset can name a webcam and a frame rate, and you choose how the camera sits over the screen - shape, corner and size - before you record. See Recording.
  • Turns a recording into an artifact. The walkthrough builder takes a recording and produces a transcript plus a shareable HTML write-up you can drop into a ticket, a doc, or a message.
  • Snips a screenshot from anywhere. PrintScreen grabs a region and Ctrl+PrintScreen the whole screen, each one saved as a PNG and copied to the clipboard, with a Capture gallery listing them. Both shortcuts are rebindable. See Recording.
  • Imports an outside video. Bring a Teams meeting recording or any common video file into the library and get a transcript back. See Import a video.
  • Adds subtitles in another language. Translate a transcript with the timing preserved and burn the captions into a new video. See Multilingual subtitles.
  • Runs your own tools on a finished recording. A post-recording plugin is a folder you drop in and switch on; enabled plugins run as their own process once a recording is finalized and transcribed, with the recording folder as the surface they read and write.
  • Keeps itself current. It checks for a new release, installs it in the background and restarts into it - waiting until a recording has finished. You can turn the check off in Settings.

Two ways to run it

AgentEyes is a tray app (AgentEyesApp.exe) and a command-line tool (agenteyes.exe) that share one engine. Beyond the tray window, a local REST Control API lets a script or an agent drive the recorder headlessly.

  • From the window. Pick a preset and record, then find, play and act on what you captured in the recording library. No DevThrottle account is needed to record. (Transcription, translation, and AI titles do use your DevThrottle account, since they run on the hosted AI.)
  • From a script. The CLI and the Control API automate every part of it.

Where recordings live

Recordings land in %USERPROFILE%\Videos\AgentEyes\. Configuration, presets, the dictionary, plugins, and logs live in %LOCALAPPDATA%\AgentEyes\. Each recording is its own folder holding the video or audio, any screenshots, and the transcript.

Tip
You do not have to leave the tray to use most of this. If you would rather script it, start with the CLI reference.

Where to go next

Start with Recording to make your first capture, or jump straight to Import a video and Multilingual subtitles.