Picture-in-picture

One canvas. Two sources. No timeline dragging.

Tell your agent which video should fill the frame and which should sit on top. Moviestar gives it named slots, visual previews, and geometry controls so it can build and verify the composition itself.

The workflow

From two recordings to one composed frame

The agent works with names and intent—main, inset, top-left, circle—while moviestar resolves the pixels and renders them deterministically.

01

Preview the layout

Before editing, the agent asks moviestar for a sample of the picture-in-picture preset. The preview shows the canvas, the main and inset slots, and their resolved regions.

preview the preset
$ moviestar layouts preview picture-in-picture --canvas short
02

Choose what goes where

The main source fills the canvas while the second source plays at the same time in the inset. Each slot gets an explicit source range, and the agent chooses which source supplies the audio.

build one picture-in-picture scene
$ moviestar scenes set --canvas short --scene demo=picture-in-picture \
  --slot demo:main=screen --from 0:00 --to 0:30 \
  --slot demo:inset=host --from 0:00 --to 0:30 \
  --audio-from demo=host
03

Make the inset yours

New insets start as a medium circle with a white border in the bottom-right. The agent can change the size, position, shape, border, framing, or add a bounded bounce—without touching the source footage.

resize, move, style, and animate the inset
$ moviestar scenes geometry demo:inset --size small --at top-left --shape rounded --radius 0.15 --border "4px white"
moviestar scenes geometry demo:inset --motion bounce --speed medium
04

Check it, then render

Screenshots and preview clips use the same resolved composition as the final export, so the agent can catch a covered button, awkward crop, or misplaced inset before the full render.

verify and export
$ moviestar screenshot --at 0:05
moviestar export picture-in-picture.mp4

Keep going

The inset is part of the edit plan, not baked into your footage.

Move it later, switch its shape, add camera motion underneath it, or undo the change. The original recordings stay untouched.

Explore the docs