> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload a Walkthrough Video

> Record your screen while you operate and speak — superun reads both your actions and narration.

## What It Is

**Upload a walkthrough video** lets you record your screen on the project page while talking through what you want. When you stop, the recording is attached to the input box and uploaded automatically, and your narration is transcribed into text in the input box — superun understands both the on-screen actions and your spoken intent.

It is useful when something is easier to show than to type.

***

## Requirements

| Requirement     | Description                                                               |
| --------------- | ------------------------------------------------------------------------- |
| Where           | The attachment menu of the project-page input area (split preview layout) |
| Device          | Desktop (browser or desktop app)                                          |
| Browser         | Must support screen recording; the entry is hidden otherwise              |
| Screen sharing  | You must allow superun to view the current tab                            |
| Microphone      | Optional; if denied, recording continues without sound                    |
| Home input area | Not supported yet — use it on the project page                            |

***

## How to Use It

### Step 1: Start Recording

1. Click the attachment button beside the input box on the project page.
2. Choose **Upload a walkthrough video** from the menu.
3. The first time, a three-step guide appears; click **Agree & start recording** to begin. Later uses start right away.

### Step 2: Grant Permissions

The browser first asks for screen-sharing permission — only the current tab is recorded, and you cannot switch to another window or screen during recording. It then asks for microphone permission. With the microphone on you can talk while you operate; if you decline, recording continues silently.

### Step 3: Operate and Talk

While recording, a floating bar appears at the bottom-left of the preview panel with a red REC dot, a timer, a microphone waveform, and a live transcript of your narration.

On the preview tab you can turn on **Brush markup** to circle things directly on the page — click around, outline what you mean, and say it out loud.

### Step 4: Stop and Send

Click **Stop** on the floating bar (or the browser's own "Stop sharing") to finish. A single recording lasts up to 5 minutes; the timer turns red during the last 30 seconds and recording stops automatically at the limit.

After stopping, you will see "Recording added — uploading…", the video appears in the attachment area, and your narration appears as text in the input box. Review and send — superun combines the video and the text to understand your request.

***

## Recording Details and Limits

| Item             | Description                                                         |
| ---------------- | ------------------------------------------------------------------- |
| What is recorded | The current tab plus microphone audio; system audio is not recorded |
| Duration         | Up to 5 minutes per recording; stops automatically at the limit     |

***

## Uploading an Existing Video

You can also upload an existing video through the attachment button: **mp4, mov, webm** formats, up to **15 MB** and **5 minutes** per file, with at most 10 attachments per message.

***

## Recommended Uses

* Reproduce a bug: walk through the broken flow while explaining what is wrong.
* Describe a change: point at the page and say "change this to…", with Brush markup circling the spot.
* Demonstrate the interaction you want, so superun sees the intended flow directly.
* Replace a long written spec with "show and tell" when typing is too slow.

***

## FAQ

<AccordionGroup>
  <Accordion title="I don't see Upload a walkthrough video in the attachment menu.">
    The entry appears only on the project page in split preview layout, and requires a browser that supports screen recording. Use a modern desktop browser such as Chrome; the Home input area does not support it yet.
  </Accordion>

  <Accordion title="Can I record another window or the whole screen?">
    No. To protect privacy and stay focused on the project, only the current tab is recorded, and the sharing target cannot be switched during recording.
  </Accordion>

  <Accordion title="My recording has no sound.">
    Microphone permission is requested when recording starts. If it is denied or no microphone is available, recording continues without sound, and the floating bar shows a microphone-off icon.
  </Accordion>

  <Accordion title="What if I need more than 5 minutes?">
    Recording stops automatically at 5 minutes and the file is attached. For longer content, record multiple clips and send them in separate messages.
  </Accordion>
</AccordionGroup>