# Highlights

> Named ranges inside a clip: marking them, editing them in the clip window, the AI's drafts, and the two cuts that change a file.

A highlight is a named in-point and out-point inside a clip. It lives in the index, not in the file. A clip can have as many as you like. The AI marks a few when it tags a clip; treat those as a first draft.

## Where highlights show

- On a card, as one thin bar per highlight above the name. Hover playback loops the first one.
- In the inspector, as a list with name, range and a bar. Drag a row out of the app to get the highlight as a file.
- In Quick Look and the clip window, as rows under the filmstrip. Click one and playback jumps to its start.

## Edit a clip

Highlights are edited in the clip window. Double-click a card to open it, then click Edit or press ⌘E. From the grid, ⌘E on one selected clip opens its window already editing, and Edit Highlights… in the context menu does the same.

Edit is one mode for the whole window: the properties in the inspector and the rows on the timeline go into one Save (⌘S) or one Cancel. Cancel has no shortcut on purpose.

## Add and shape a highlight

1. Park the playhead on the moment. Click or drag on the filmstrip.
2. Click Add Highlight, or press ⇧⌘H. A row appears at the playhead, a quarter of the clip long at most.
3. Drag the row's edges to set the in and out points. Edges snap to the playhead, to other rows' edges and to the clip's ends. Hold ⌥ to drag freely.
4. Type a name in the row. The name becomes the filename when the highlight is exported.
5. Save.

The trash button on a row removes it, after a question. Removing a highlight never touches the footage.

While a handle is dragged the viewer shows the frame under it. With skimming on (S), hovering a strip previews that frame without moving the playhead.

## The AI's highlights

Tagging drafts up to twelve highlights per clip, in clip order, each with a short title. They are the moments an editor would use: a clean rep, a reaction, a strong frame. A New clip becomes a Draft when they land. Open the clip, tighten or drop what is wrong, and mark it Ready.

## Trim the file

The filmstrip grows the clip's own end handles in edit mode. Pull one in and the footage outside dims. Save then asks "Trim to this range?".

- The original file is cut to the kept range. The cut is lossless and lands on keyframes, so it can start a fraction before the handle.
- Highlights inside the range survive, shifted. Highlights across an edge are shortened. Highlights wholly outside are removed. The sheet counts them.
- The footage outside cannot be recovered.

A trim has to keep at least half a second. The sheet offers Tag with AI again for the shorter clip.

## Split at Playhead

In edit mode, the scissors under the rows cut the clip in two at the playhead. The sheet says what it makes: two clips, before and after the cut, each with the name, description, status, tags and values of the original, and the highlights that fall on its side. A highlight across the cut becomes one on each side.

The cut lands on the nearest keyframe and cannot be undone. Each side needs at least half a second. The second clip opens in its own window. The sheet offers Tag both clips with AI.

Split is off while the clip's handles are moved in. Put them back first.

## From the terminal

`betterlibrary highlights add <clip> --in 12 --out 18 --name "Clean rep"` marks a range. `highlights export <id>… --to <folder>` cuts them out as files. See [The command line](https://docs.usebetterapps.com/betterlibrary/cli) and [Exporting](https://docs.usebetterapps.com/betterlibrary/exporting).
