User Guide

Theatre

Preview and export your final merged video

The Theatre tab is where you preview and share your final video. It displays the merged video that combines all your scene motion clips with the generated music track.

Video Player

When a merged video is available, it displays in a full video player sized to your sequence's aspect ratio. The player is centered in the viewport and constrained to fit the screen height.

Download Menu

The Download button (top-right corner of the player) opens a menu with:

  • Download MP4 — Downloads the render of the current cut, named after your sequence title (e.g., My_Sequence_openstory.mp4)
  • Copy link — Copies the render's URL to your clipboard

Until the current cut has been rendered, the menu offers Render MP4 on server instead of Download.

Publish to social

If your team has added an Upload-Post key in Settings → API Keys, the Download menu also offers Publish to social… once the current cut has been rendered. Pick an Upload-Post profile, the platforms to post to (only the accounts connected to that profile are listed), a caption and an optional description. YouTube uploads default to private; TikTok uses your account's default unless you pick "Only me".

You review exactly what will be posted before anything is sent, then follow each platform's result — a link to the post, or the reason it failed. Publishing exactly the same post again is detected and not sent twice. If Upload-Post doesn't confirm a post, the dialog keeps checking on it — even after you close and reopen it — rather than letting you send it again.

Video States

Completed

The full video player is shown with playback controls and the share menu.

Merging

A spinner with "Merging video segments..." text. The page polls every 2 seconds for status updates.

Failed

An error message is displayed with the failure reason and a Retry Merge button.

Pending

When no merged video exists yet:

"No merged video yet. The merged video will be generated automatically once all motion segments are complete."

A Generate Now button is available if you want to trigger the merge manually.

Aspect Ratio Sizing

The theatre player automatically sizes based on your sequence's aspect ratio:

RatioBehavior
16:9Full width, standard widescreen
9:16Narrow, tall — optimized for mobile preview
1:1Square, centered

All ratios are constrained to calc(100dvh - 15rem) maximum height to fit within the viewport alongside the header and navigation tabs.