SceneItAll Docs

Breakdown

Detect elements with AI

SceneItAll’s AI can read your screenplay and suggest the production elements in it — cast, props, vehicles, wardrobe, and more. Detection never changes your breakdown directly: every result goes through a review step where you accept or reject each item. This article covers running detection and reviewing its results. For the concept behind the AI agents, see AI element detection.

Before you start

  • You have a script with parsed scenes.
  • You are a project Owner or Admin. Only Owners and Admins can run element detection.

Run detection from the breakdown overview

To detect elements across several scenes at once:

  1. On the Breakdowns tab, select the scenes you want to process with their checkboxes.
  2. Open the AI tools menu in the toolbar and choose Element Breakdown. With scenes selected, the item shows the count, for example Element Breakdown (3).
  3. The job starts in the background. The AI tools menu is replaced by a status strip and a Cancel button while it runs.

Run detection from a scene

To detect elements in a single scene:

  1. Open the scene in the scene detail view.
  2. Open the AI tools menu in the header and choose Element Breakdown.
  3. Detection runs on that scene.

Monitor progress

While detection runs, a status strip appears below the top bar showing the current operation and progress. You can keep working elsewhere in the app, and you can stop the job with Cancel (you are asked to confirm, since progress is lost).

Review the results

When detection finishes, you are notified two ways:

  • A toast notification that the AI element detection is ready for review.
  • A banner at the top of the breakdown overview with a Review button.

Select Review to open the Review AI Changes dialog.

[SCREENSHOT: The Review AI Changes dialog showing per-scene sections with New elements and Flagged for Removal elements, each with a checkbox]

What the dialog shows

The dialog groups the AI’s findings by scene. Each scene section can have two parts:

  • New — elements the AI found in the script. Each row has a checkbox (checked by default), a NEW badge, the element type, and a confidence percentage. Within a scene, each type has Confirm All and Reject All shortcuts.
  • Flagged for Removal — elements already on the scene that the AI did not find this time. Each has a Keep toggle; leave it off to remove the element from the scene, or turn it on to keep it.

The header shows a running count of new and flagged items and a Select all new / Deselect all new shortcut.

Apply the results

  1. Review the New elements and uncheck any you do not want.
  2. Review the Flagged for Removal elements and turn on Keep for any that should stay.
  3. Select the apply button at the bottom right. Its label reflects your choices — for example Apply: Add 4, Remove 1.

The checked new elements are created and tagged, the unkept flagged elements are removed, and the dialog closes with a summary toast. To discard everything, select Reject All.

When several new Characters are applied together, SceneItAll assigns each one the next distinct project-wide character number. Existing character numbers are left unchanged.

When the AI finds nothing

If detection finds no elements to add and none to remove, the dialog shows a single Mark as Reviewed button (and no Reject All). Select it to confirm the scene was reviewed and clear the pending banner and notification.

How matching works

Detection respects your existing element library — the AI tries to match what it finds to elements you already have before proposing new ones. Detected items carry a confidence score so you can prioritize your review.