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

# Clips & Highlights

> Find the best moments in any audio and export them as video clips.

Two tools, one workflow: **highlights** finds the moments, **clip\_export** extracts them as MP4 files.

***

## Find highlights automatically

Give Augent a transcribed file and it picks the most interesting moments by content density:

```
Find the 5 best moments from this podcast: ~/Downloads/podcast.mp4
```

Augent uses chapter detection to find topic boundaries, then ranks segments by quotability and insight density. No query needed.

***

## Find highlights by topic

Describe what you're looking for and Augent finds every relevant moment using semantic search:

```
Find every moment someone recommends a product in ~/Downloads/podcast.mp4
```

This is focused mode. It matches by meaning, not keywords — "product recommendations" will find moments where someone says "you have to try this" even without the word "product."

**More ideas:**

* `"heated debate"`: the most contentious moments
* `"life advice"`: personal wisdom and life lessons
* `"funny moments"`: humor and jokes
* `"[person name]"`: every mention of a specific person
* `"pricing strategy"`: business strategy discussions
* `"controversial take"`: hot takes and unpopular opinions

***

## Export highlights as clips

Add `clip: true` to any highlights call to export each moment as a separate MP4 video:

```
Find the 3 funniest moments in ~/Downloads/podcast.mp4 and export them as clips
```

Each clip is saved to `~/Desktop` as a separate MP4 file with padding around the moment. Only the relevant segment is downloaded — not the full video.

***

## Export a specific clip

If you already know the timestamps, use `clip_export` directly:

```
Export a clip from https://youtube.com/watch?v=xxx from 2:00 to 3:00
```

Only the requested segment is downloaded. A 60-second clip from a 3-hour video takes seconds.

You can also specify a custom output directory and filename:

```
Export a clip from https://youtube.com/watch?v=xxx from 0:00 to 0:30, save it as "intro" in ~/Videos/clips
```

***

## Adjusting padding

When exporting clips around keyword matches or highlights, the default padding is **15 seconds** before and after. If the clip feels too short or too long, just ask:

```
Give me 30 seconds of padding around each highlight
```

Re-exporting a clip with the same filename automatically overwrites the previous file.

***

## Typical workflow

1. **Download** audio from a URL
2. **Search or highlight** to find moments: by keyword, meaning, or automatically
3. **Export clips** around matches

```
Download this podcast: https://youtube.com/watch?v=xxx
Find every moment they discuss funding challenges and export clips with 20 seconds of padding
```

One prompt, from URL to MP4 clips on your Desktop.

***

## Web UI

Clip export is also available visually in the [Web UI](/web-ui/overview). Click the film icon on any search result to create a region on the waveform, fine-tune with nudge buttons, preview the selection, and export — all without leaving the browser.

***

## Tool reference

For full parameter details, see the tool reference pages:

* [highlights](/tools/highlights): auto and focused mode parameters, response format
* [clip\_export](/tools/clip-export): URL, start/end, output parameters