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:
| Ratio | Behavior |
|---|---|
| 16:9 | Full width, standard widescreen |
| 9:16 | Narrow, tall — optimized for mobile preview |
| 1:1 | Square, centered |
All ratios are constrained to calc(100dvh - 15rem) maximum height to fit within the viewport alongside the header and navigation tabs.