# Cap setup (/docs/context-capture/video-import-cap)





Cap setup [#cap-setup]

[Cap](https://github.com/CapSoftware/cap) is an open-source screen recorder. We recommend it for SageOx because you get full control over export settings and recordings stay local until you're ready to share.

Why Cap [#why-cap]

| Feature        | Cap                                 | Loom                 |
| -------------- | ----------------------------------- | -------------------- |
| Export control | Full resolution/fps/quality control | Limited options      |
| Local storage  | Files stay on your machine          | Uploads immediately  |
| Cost           | Free                                | Free tier has limits |
| Editing        | Trim, cut, annotate before export   | Basic trimming only  |

For quick, one-off recordings, Loom works fine. For regular walkthroughs where you want consistent quality and file sizes, Cap is better.

Recommended export settings [#recommended-export-settings]

After recording, open Cap's export dialog and configure these settings:

<img alt="Cap export settings showing MP4 format, 720p resolution, 15fps, Social quality" src={__img0} placeholder="blur" />

| Setting        | Value  | Why                                             |
| -------------- | ------ | ----------------------------------------------- |
| **Format**     | MP4    | Universal compatibility, best compression       |
| **Resolution** | 720p   | Sufficient for UI walkthroughs, fast to process |
| **Frame Rate** | 15 fps | Smooth enough for demos, half the data of 30fps |
| **Quality**    | Social | Best size-to-quality ratio for AI extraction    |

Expected file sizes [#expected-file-sizes]

These settings produce predictable file sizes:

| Duration | Size     | Use case               |
| -------- | -------- | ---------------------- |
| 1 min    | \~8 MB   | Quick bug demo         |
| 5 min    | \~40 MB  | Feature walkthrough    |
| 10 min   | \~80 MB  | Detailed design review |
| 30 min   | \~240 MB | Full meeting recording |

<Callout type="info">
  **Why smaller matters.** Every byte you save speeds up four things: upload time, transcription, keyframe extraction, and AI coworker image processing. At 720p, your AI coworker sees everything it needs. At 4K, it's just more pixels to process with no benefit.
</Callout>

Recording tips [#recording-tips]

**Narrate as you go**
Transcript quality drives extraction quality. Silent recordings produce no searchable context. Talk through what you're doing and why.

**Keep it focused**
5-10 minutes is the sweet spot. A tight walkthrough beats an hour-long ramble. If you need more time, split into multiple recordings by topic.

**Clean your desktop**
Fewer distractions means better keyframe extraction. Close Slack, hide your bookmarks bar, and full-screen the app you're demoing.

**Use descriptive titles**
Your AI coworkers search by title. "Sprint 12 Checkout Flow Redesign" beats "Recording 47".

Import your recording [#import-your-recording]

After exporting from Cap, upload to SageOx:

1. Go to your team's **Media** section at [sageox.ai](https://sageox.ai)
2. Click **Upload**
3. Drag and drop your exported MP4 file
4. Add a descriptive title

Processing starts automatically. Transcription, keyframe extraction, and summarization run in the background.

What's next [#whats-next]

* [Upload via Web](/docs/context-capture/video-import-web) — detailed upload guide
* [Video Import](/docs/context-capture/video-import) — all import options and supported formats
* [Discussions](/docs/context-capture/discussions) — where imported recordings live
* [SageOx + Figma](/docs/cookbooks/figma) — record Figma walkthroughs with Cap