Storyboard

Visualize, edit, and manage your project's shot-by-shot breakdown with the Storyboard. Review screenplay changes and resolve conflicts with the integrated diff workflow.

Overview

The Storyboard is the visual backbone of your production, displaying every shot in your project organized by scene. It provides a comprehensive view of your screenplay broken down into individual shots, each with its associated media (keyframes, audio, video). The Storyboard also handles screenplay changes through a powerful diff resolution workflow.

Key Concepts

• Shot: A single visual unit in your production, containing direction, speaker, dialog, and a keyframe image
• Scene: A grouping of related shots that share a location or narrative moment
• Keyframe: The visual representation image for a shot (also called "first frame")
• Storyboard View: The visual grid display of all shots organized by scene
• Diff View: A specialized view for resolving changes after your agent re-breaks-down the screenplay
• Media Status: Indicates whether a shot's keyframe has been generated, is pending, or needs regeneration

When to Use the Storyboard

The Storyboard is where you:

• Review your project structure: See all shots organized by scene at a glance
• Edit individual shots: Modify direction, speaker, dialog, and camera angle
• Review and certify what your agent composed: Approve or reject the shots and scenes your connected agent lands
• Delete shots: Remove unwanted shots from your production
• Resolve screenplay changes: Review and approve/reject changes after re-breaking down the screenplay
• Navigate to editors: Access the Keyframe, Dialog, and Video editors for specific shots

---

Accessing the Storyboard

From the Project Dashboard

1. Navigate to your project
2. Click the Storyboard tab in the main navigation

Navigation

• Use the Jump to Shot input in the header to quickly navigate to a specific shot number
• Click Go to jump to the entered shot

---

Generating Your First Storyboard

When you first visit the Storyboard tab for a new project, you'll see the No Storyboard Found page. This is your starting point for creating a visual breakdown of your screenplay.

Compose with Your Agent

The primary way to create a storyboard is to have your connected AI agent break down an existing screenplay:

1. Make sure you have a saved screenplay in the Screenplay tab
2. Connect Your Agent if you haven't already
3. Ask your agent to break down the screenplay into shots
4. The agent composes cited shots — organized by scene, with camera direction and a first-frame keyframe for each — and traces every shot back to the screenplay passage it came from
5. Open the Storyboard tab to review what the agent proposed

Alternative: Create an Empty Storyboard

If you prefer to build your storyboard manually:

1. Click New Storyboard from the empty storyboard page
2. An empty storyboard is created with no shots
3. Add shots manually using the shot management tools

---

Understanding the Interface

The Storyboard has several key areas:

Header

The header at the top of the Storyboard provides:

Scene Headers

Each scene is displayed with a collapsible header containing:

Shot Cards

Each shot is displayed as a card with the following sections:

Shot Action Buttons

Each shot card includes these action buttons:

Drag and Drop

Shots can be reordered by dragging. Each shot's keyframe image has a drag handle icon in the top-right corner. Click and hold the drag handle, then drag the shot to a new position within the same scene or to a different scene. Shot numbers update automatically to reflect the new order.

Media Status Badges

Each shot displays a status badge indicating the state of its keyframe generation:

---

Shot and Scene Management

Editing Scene Properties

To edit a scene's properties:

1. Click the Edit button on the scene header
2. The Scene Edit dialog opens with editable fields:
   • Location Name: The scene's setting
   • Interior/Exterior: Whether the scene is indoors or outdoors
   • Time of Day: When the scene takes place
   • Lighting Style: The lighting approach for the scene
   • Weather: Weather conditions
3. Click Save to apply changes

The scene header updates immediately to reflect your changes.

Editing a Shot

To edit an existing shot:

1. Click the Edit Shot button (pencil icon) on the shot card
2. The Shot Edit dialog opens with editable fields:
   • Speaker: The character speaking in this shot
   • Dialog: The spoken lines
   • Camera Angle: Select from available camera options (shot size, framing, movement)
   • Direction: Describe the action in the shot
3. Make your changes
4. Click Save to apply changes

Adding a New Shot

To insert a shot between existing shots:

1. Hover between two shot cards — a narrow zone appears between them
2. Click the Add button (plus icon) that expands on hover
3. A new empty shot is inserted at that position
4. Subsequent shots are renumbered automatically

Merging Shots

To combine two adjacent shots into one:

1. Hover between the two shots you want to merge
2. Click the Merge button (merge icon) that appears next to the Add button
3. Confirm the merge in the dialog
4. The dialog and direction from both shots are concatenated
5. The second shot is removed and remaining shots are renumbered

Uploading a Keyframe Image

To manually upload an image for a shot:

1. Click the Upload image button on the shot card
2. Select an image file from your computer
3. The image replaces the current keyframe for that shot

Downloading a Keyframe Image

When a shot has a keyframe image:

1. Click the Download image button (only visible when an image exists)
2. The image downloads to your computer

Deleting a Shot

To remove a shot:

1. Click the Delete shot button (trash icon)
2. Confirm the deletion in the dialog

---

Screenplay Changes and Diff Resolution

When your agent breaks down the screenplay again after you've made edits, the system detects changes and displays a diff view showing how your storyboard will be affected. This workflow ensures you maintain control over how screenplay edits translate to shot changes.

How Diff Detection Works

1. You edit and save your screenplay in the Screenplay tab
2. You ask your connected agent to break down the screenplay again
3. The agent compares the new breakdown against your existing storyboard
4. If changes are detected, the Diff View appears
5. You review and resolve each change
6. Once all changes are resolved, the storyboard is updated

When Diff View Appears

The Diff View is displayed when:

• Shot content has changed (dialog, direction, camera)
• Shots have been added to the screenplay
• Shots have been removed from the screenplay
• Shots have been moved to different positions

The Diff View is NOT displayed when:

• The screenplay hasn't changed since the last breakdown
• Changes have already been resolved

Change Categories

The diff system categorizes changes into four types:

Understanding the Diff View Interface

The Diff View displays:

Before/After Comparison

For changed shots, you see a side-by-side comparison:

Changed Fields Indicators

The system highlights exactly what changed in each shot:

• Dialog changes are marked with a text icon
• Direction changes are marked with an action icon
• Camera changes are marked with a camera icon
• Scene changes are marked with a location icon

---

Resolving Changes

Individual Shot Resolution

To resolve a single shot change:

1. Find the shot in the Diff View
2. Review the before/after comparison
3. Click Approve to accept the change, or Reject to discard it

What happens when you approve:

What happens when you reject:

Scene-Level Resolution

For faster bulk resolution, you can approve or reject all shots in a scene at once:

1. Find the scene header in the Diff View
2. Click Approve All in Scene or Reject All in Scene
3. All unresolved shots in that scene are processed

Notes:

• Only unresolved shots are affected (already-resolved shots are skipped)
• Each shot is processed according to its change type

Project-Level Resolution

To resolve all changes at once across the entire project:

1. Click Approve All Changes or Reject All Changes in the Diff View header
2. All unresolved shots across all scenes are processed

Completing Resolution

When you resolve the last remaining shot:

1. The system automatically saves the resolved state
2. The Diff View closes
3. You return to the normal Storyboard view
4. No new diff is triggered

---

Media Preservation and Invalidation

The diff system intelligently handles your existing media based on the type of change.

Media Preservation (Moved Shots)

When a shot is moved but its content remains unchanged:

• Keyframe is preserved
• Audio is preserved
• Video is preserved

The media follows the shot to its new position automatically.

Media Invalidation (Changed Shots)

When shot content changes, the system determines which media needs regeneration:

Regenerating Invalidated Media

To update invalidated media:

1. Navigate to the appropriate editor (Keyframe, Dialog, or Video) using the shot's action buttons
2. Generate new media using the updated shot content
3. The invalidation marker is removed once new media is generated

---

Navigating to Editors

From the Storyboard, you can quickly access specialized editors:

Keyframe Editor

Click Edit in Keyframe on a shot card to:

• Create and compose keyframes for the shot
• Use the multi-layer composition tools
• See Keyframe Editor guide

Dialog Editor

Click the Dialog tab in the project navigation to:

• Generate voice audio for shots
• Select voices and adjust settings
• See Dialog Editor guide

Video Editor

Click the Videos tab in the project navigation to:

• Generate video from keyframes
• Compare multiple video variations
• See Video Editor guide

---

Integration with Screenplay and Assets

The Storyboard connects the screenplay and asset workflows together through your connected agent.

From Screenplay to Storyboard

1. Write and save your screenplay in the Screenplay tab
2. Ask your agent to break down the screenplay into shots
3. If a storyboard already exists, changes go through the Diff View for review (see the Screenplay Changes and Diff Resolution section below)

From Assets to Keyframes

1. Ask your agent to break down the screenplay to extract assets into the Asset Manager
2. Ask your agent to generate reference images for characters, locations, and props — or generate them yourself in the Image Editor
3. Ask your agent to compose keyframes — it uses your asset reference images and each shot's direction

Recommended Production Workflow

1. Screenplay — Write and save your script
2. Breakdown — Ask your agent to extract assets and compose the storyboard
3. Reference images — Generate reference images for your assets
4. Keyframes — Ask your agent to compose keyframe images using asset references
5. Review — Certify what your agent proposed in the Storyboard

---

Tips and Best Practices

Storyboard Organization

• Collapse scenes you're not working on to focus on one at a time
• Use Jump to Shot to navigate quickly in large storyboards
• Keep direction concise: Action descriptions should be clear and actionable
• Attribute dialog clearly: Always specify the speaker for each line

Diff Resolution Tips

• Review before bulk actions: Check a few shots individually before using "Approve All"
• Preserve media when possible: If only position changed, approve moved shots to keep existing media
• Reject unwanted additions: Don't let unintended screenplay changes pollute your storyboard
• Resolve systematically: Work through scenes in order to avoid missing changes

Media Management

• Generate reference images before keyframes: Get your asset reference images ready first, then compose keyframes for the best quality
• Regenerate invalidated media promptly: Don't let stale media accumulate
• Upload reference images: Use the Upload button when you have specific images you want for a shot

Workflow Tips

• Save your screenplay first: Your agent's breakdown reads from the saved screenplay, not unsaved edits
• Ask your agent for bulk operations: Composing directions and keyframes for many shots at once is your agent's job, not a UI button
• Coordinate with team members: Communicate about screenplay edits on collaborative projects

---

Common Questions

I asked my agent to break down the screenplay but nothing happened in the Storyboard?

Make sure you have a saved screenplay in the Screenplay tab first, and that your agent is connected — see Connect Your Agent. The composition runs in the background, and the Storyboard page updates automatically when it's ready.

How do I update the storyboard after editing my screenplay?

Saving your screenplay does not automatically update the storyboard. Ask your connected agent to break down the screenplay again. If changes are detected, the Diff View appears for you to review.

Why don't I see the Diff View after running a breakdown?

The Diff View only appears when changes are detected between the new breakdown and your existing storyboard. If the screenplay hasn't changed since the last breakdown, no diff is displayed.

Can I undo a resolution decision?

Individual resolution decisions cannot be undone within the Diff View. However, you can:

• Continue editing the screenplay and run breakdown again
• Manually edit shots in the Storyboard after resolution

What happens to media when I delete a shot?

All media associated with the shot (keyframes, audio, video) is deleted. This includes all variations, not just selected media. This action cannot be undone.

Why is my media marked as invalidated?

Media is marked as "Invalidated" when the shot content changes after the media was generated. This ensures your media stays in sync with your screenplay. Hover over the badge for details, then navigate to the appropriate editor to regenerate.

Can I approve some changes and reject others?

Yes, you can resolve each change independently. Use individual shot resolution to make selective decisions, or mix individual and bulk resolution.

What if I accidentally approve a change I didn't want?

Complete the resolution workflow, then manually edit the shot using the Edit Shot button to restore the content you want. You'll need to regenerate any affected media.

Can I edit a shot while in Diff View?

No, shot editing is disabled during diff resolution. Complete the resolution first, then make additional edits in the normal Storyboard view.

What happens if I need to make more screenplay changes after resolution?

Edit your screenplay, save it, then ask your agent to break it down again. A new Diff View will appear showing only the new changes.

---

Next Steps

• Screenplay - Write and edit your screenplay, then ask your agent to break down changes to the storyboard
• Asset Manager - Manage characters, locations, and props, and generate reference images
• Keyframe Editor - Create and compose keyframes for your shots
• Dialog Editor - Add voice audio to your shots
• Video Editor - Generate videos from your keyframes