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

# Cropping

> Detect the visible content in a screen recording and crop to it.

Detect the visible content at a selected frame and apply the recommended crop to a clip's screen recording. Tella adjusts existing masks and custom-layout geometry to fit the crop.

<Note>
  **All times are milliseconds on the clip's playback timeline** — the video as watched, with cuts applied. It is the same timeline as `get_transcript`, thumbnails, and previews, so nothing needs converting. A start at or past the end of the clip is rejected with a `400`.
</Note>

## auto\_crop

Automatically crop a clip's screen recording based on the content visible at a selected frame. The result includes the applied crop, confidence, detected aspect ratio, and the resolved source frame.

<ParamField path="videoId" type="string" required>
  Video ID
</ParamField>

<ParamField path="clipId" type="string" required>
  Clip ID
</ParamField>

<ParamField path="inpointMs" type="integer">
  Frame time in ms. Defaults to 0.
</ParamField>


## Related topics

- [Crop screen recordings](/docs/help/editing/crop-screen-recordings.md)
- [Custom layouts](/docs/help/editing/custom-layouts.md)
- [Auto layouts](/docs/help/editing/use-auto-layouts.md)
- [Product Changelog](/docs/changelog.md)
- [Mac App](/docs/changelog/mac-app.md)