Screen Recording and Voice Notes
Screen recordings can be attached to Agivar messages. They are most useful in Teach Mode, where you demonstrate a workflow once, but they can also be sent in Task Mode as context. While recording, a floating control bar lets you pause, continue, finish, and add text or voice annotations.
In this guide, "voice recording" means voice annotations: you speak during the screen recording, and Agivar turns your speech into timestamped text notes that help the AI understand the video.
Start Recording
- If you are teaching a workflow, start a new conversation and switch to Teach Mode first.
- Click Record in the input bar.
- Choose Start screen recording from the menu, or open Select recording file and click Start recording in the selector.
- On first use, grant the required system permissions for screen recording, accessibility, input monitoring, and microphone access.
- A floating control bar appears near the bottom-right of the screen and shows
REC 00:00/10:00.
Recordings capture the primary monitor, mouse/keyboard actions, and any annotations you submit. With multiple monitors, put the workflow on the primary display.
Place a screenshot of the "recording selector + Start recording card" here (static/img/recording-selector-start.png).
The Floating Control Bar
| Control | What it does |
|---|---|
| Six-dot handle / empty area | Drag the control bar. When released, it snaps back into the visible screen area if needed. |
REC, red dot, timer | Shows elapsed time and the recording limit. During pause, the red dot stops blinking and the timer freezes. |
| Green waveform button | Start / stop voice annotation. Windows shortcut: Alt+D; macOS: Cmd+Shift+D. Recognized text appears in the annotation history. |
| Annotate button | Opens the text annotation box. Windows shortcut: Alt+I; macOS: Cmd+Shift+I. Enter sends, Shift+Enter inserts a newline, Esc closes. |
| History number | Shows / hides annotation history. The arrow in the title only expands or collapses the history content. Sent notes can be edited or deleted. |
| Pause / Continue | Pauses frame and input capture; paused time does not count toward the recording length. Continue resumes from the previous timestamp. |
| End | Stops the recording and starts background processing. |
Hover a button to see its tooltip. If voice annotation is active when you pause, Agivar saves the current draft first; when you continue, voice annotation resumes automatically.
Place a screenshot of the "floating recorder bar with waveform, annotate, history, pause, and end marked" here (static/img/recording-bar-annotated.png).
Is the Bar Captured?
By default, no. The recorder bar, annotation box, task progress overlay, and similar floating widgets are excluded from AI screenshots and screen recordings, so the captured video contains what is behind them.
If you enable Streamer Mode under Settings → Advanced, these floating widgets become visible to recordings and AI screenshots. Turn it off to restore the default hidden behavior.
Add Text or Voice Notes
Text Annotations
Use text annotations for short notes, such as:
- "Wait for the page to fully load before clicking here."
- "Pick the second option because we only handle paid orders."
- "The user enters the password and CAPTCHA here."
Click Annotate, or use the shortcut to open the input box: Alt+I on Windows, Cmd+Shift+I on macOS. The note is attached to the current recording timestamp and is used when Agivar generates the operation description.
Voice Annotations
Use voice annotations when you want to talk through a longer workflow:
- Click the green waveform button, or use the shortcut: Alt+D on Windows, Cmd+Shift+D on macOS.
- Speak normally while demonstrating.
- Agivar shows live transcription drafts in the annotation history and automatically splits them into notes after pauses.
- Click the waveform button again, or use the same shortcut again to stop.
The first time you use voice annotation, your system may ask for microphone permission. If permission is denied or the microphone is unavailable, screen recording can continue without voice notes.
The microphone in the main input bar turns speech into chat text. The green waveform in the recording bar turns speech into recording annotations.
After You Click End
When you click End, the control bar closes and a recording attachment card appears above the input bar while background processing runs.
- You can keep typing and add other attachments.
- The Send button is disabled until processing finishes.
- The card shows processing progress, elapsed time, and estimated remaining time.
- Click the thumbnail to preview playback with play, pause, and replay controls.
- If you do not want to send this recording in the current message, click
Xon the attachment card. Background processing continues, and you can find it later from Select recording file.
To discard it completely, delete it from Select recording file or the recording management view. Processed recordings can be attached again to future messages.
Place a screenshot of the "recording attachment card while processing" here (static/img/recording-processing-card.png).
Tips
- Record one complete workflow at a time, with a clear start and end.
- Move a little slower, leaving short pauses between key steps.
- Use text or voice notes to explain why a step matters.
- Do not record passwords, CAPTCHAs, private keys, or other sensitive content; add a note like "the user handles this step" instead.
- Preview before sending.
- The maximum recording length is 10 minutes; Agivar ends the recording automatically at the limit.