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

# Reframe editor

> Use the Reframe editor in Studio to adjust cropping and zoom, either as a fixed crop or an animated camera move.

## Opening the Reframe editor

The Reframe editor lives inside [Studio](https://docs.overlap.ai/essentials/editing.md). Open a clip and click `Reframe` beside the preview to enter `Edit Mode`.

Landscape clips also show `Reframe` when they have no existing reframe data. They start with the full frame in **Static** mode for the entire video, with no scene groups or keyframes. Adjust position and zoom to apply one crop throughout the video; your changes save as reframe data.

![Reframe editor in Studio showing the preview, timeline, and Scene Mode panel](https://mintcdn.com/overlap-1436d2b7/t31zueaj16t0PssE/assets/reframe-editor/reframe-overview.png?fit=max\&auto=format\&n=t31zueaj16t0PssE\&q=85\&s=a63c9df9fb5546578dd849cddd3136f7)

The clip is split into **scenes**, and each is reframed independently. Whatever scene the playhead is in is the scene the right-side panel edits, so move the playhead to switch scenes.

## Static vs. Pan

`Scene Mode` at the top of the panel decides how the current scene's crop behaves over time.

![Scene Mode toggle set to Pan, with scene info, Add keyframe, and Properties](https://mintcdn.com/overlap-1436d2b7/t31zueaj16t0PssE/assets/reframe-editor/side_pannel.png?fit=max\&auto=format\&n=t31zueaj16t0PssE\&q=85\&s=b732eb8b4dcf2467379d7271b6373c00)

* **Static** — one fixed crop for the whole scene. Set **Position X**, **Position Y**, and **Zoom** once. Best for steady shots; there are no keyframes in this mode.
* **Pan** — an animated camera move driven by **keyframes**, which Overlap smoothly interpolates between. Best when the subject moves or you want a push-in. The `Add keyframe` and keyframe-navigation controls only appear here.

> [!TIP]
>
> Switching a scene from Pan to Static collapses its movement into a fixed crop. Switching back re-enables keyframe editing.

The scene info below the toggle shows **Scene** (current / total), **Duration** (seconds), and **Tile** (the scene's output region as a percentage of the frame).

## Scene layouts

Drag across the scene strip in the timeline to select one or more scenes, then pick a layout from the menu in the timeline controls. It applies to every selected scene at once — including when you pick the layout the selection is already showing, which is how you re-fit scenes that are in the right layout but not filling the frame.

| Layout | What it does |
| - | - |
| **Single** | One crop filling the whole vertical frame. |
| **Split** | Two stacked crops — the usual two-person setup. |
| **Tri Split** | Three evenly stacked crops. |
| **Dual Reaction** | Two crops on top, one across the bottom. |
| **Quad Split** | Four crops in a 2×2 grid. |
| **Padded** | The entire horizontal frame, letterboxed, with blurred bars filling the gaps. |

Changing layout keeps each scene's framing: the crop stays on whoever it was pointed at and is resized to fit its new slot.

> [!TIP]
>
> Some scenes sit in a short band with blurred bars above and below instead of filling the frame. To clear them, select those scenes and pick `Single` — even though the menu already says `Single`. Each crop stays on its subject and expands to fill the full vertical frame.

### Wide shots turned into Single

Some scenes are **Padded** because the original is a wide or panel shot with several people in it — no single vertical crop can hold them all, so Overlap shows the whole frame instead.

Those scenes have no subject to crop towards, so when you convert them to a cropped layout Overlap looks at the video itself: it finds whoever is speaking in each scene and frames the crop on them. You'll see `Finding speakers` beside the save indicator while it works, then a summary of how many scenes were reframed.

Only scenes that actually need it are moved. A padded close-up already fills the frame with its subject, so it's left exactly as it is — the crop is only repositioned when the speaker sits well off-centre, which in practice means the wide shots with people to either side. Scenes where no one could be found also stay centred; drag those crops in the preview to place them yourself.

The whole pass is a single undo step, so `⌘Z` puts everything back.

## Keyframes

Each keyframe pins a crop **Position X**, **Position Y**, and **Zoom** to a single frame. As the clip plays, Overlap animates the crop between them. A scene needs at least two keyframes to move.

**Add a keyframe:** in `Pan` mode, scrub to the frame you want, reframe the crop, and click **Add keyframe** (it's created at the playhead).

**Edit a keyframe:** move the playhead onto it — the `Properties` header then shows which keyframe you're on (e.g. `Keyframe 3 of 6 in scene`). If the playhead isn't on a keyframe, the panel prompts you to move onto one. Adjust each value by **dragging** to scrub or **clicking** to type:

| Property | What it controls |
| - | - |
| **Position X** | Horizontal center of the crop (source pixels). Higher moves right. |
| **Position Y** | Vertical center of the crop (source pixels). Higher moves down. |
| **Zoom** | How tight the crop is. `1×` is widest; larger pushes in. Minimum `1×`. |

Read-only details below show the keyframe's **Frame**, the scene's **Interpolation** (e.g. `Linear`), and **Total keyframes** for the clip.

**Navigate and delete:** use the `‹` / `›` arrows in the `Properties` header to jump between keyframes. Select keyframes to reveal the **Delete** bar at the bottom of the panel.

## Reading the keyframe timeline

The timeline under the preview stacks the scene strip on top and **keyframe diamonds** below.

![Reframe timeline with scene tiles on top and keyframe diamonds below](https://mintcdn.com/overlap-1436d2b7/t31zueaj16t0PssE/assets/reframe-editor/keyframe_trackstack.png?fit=max\&auto=format\&n=t31zueaj16t0PssE\&q=85\&s=22bf3d05cfb8ac6440dd162eaa6fbcb0)

* Each **tile** in the top row is one scene.
* Each **diamond** below is a keyframe; clusters mean several close together.
* The **playhead** selects the scene the panel edits. Use the zoom / `Fit` control (top right) to spread out tightly packed keyframes.
* Right-click a scene tile and choose **Copy Reframe Layout**, then right-click another tile and choose **Paste Reframe Layout** to reuse crop positions, layout, and pan keyframes across that scene's duration.
* When two crop regions touch in the preview, click the small swap arrow between them to switch their positions in the current scene.

## A practical reframing flow

1. Click `Reframe` to enter Edit Mode.
2. For each scene, choose `Static` (fixed crop) or `Pan` (camera move).
3. For Static, set position and zoom once.
4. For Pan, scrub to each key moment, reframe, and click **Add keyframe**.
5. Step through with `‹` / `›` to check the move, then play the clip before exporting.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.