Scripts

Two separate script tools

Studio Color has two distinct script-related features that serve different purposes:

• Script Management (/scripts) — A version library for your script PDFs. Upload each draft, download any version, and see AI-generated summaries of what changed between versions.
• Script Analyzer (/script) — An AI tool that reads a script PDF and extracts scenes, locations, props, and more to populate your project. Restricted to super admins.

Script Management — version library

Every production goes through multiple script drafts. Script Management gives you a clean version history: each upload gets an incremental version number (v1, v2, etc.) and the system automatically compares adjacent versions to generate a plain-English summary of what changed.

Uploading a new version

• Navigate to Script Management in the sidebar.
• Click Upload New Version and select a PDF file from your computer.
• The system reads the PDF text, assigns the next version number, and — if there’s a previous version — uses Claude to generate a change summary comparing the two drafts.
• The new version appears at the top of the version timeline.

Downloading a script

Any crew member can download any version of the script from the Script Management page. Click the download icon next to the version you want. The file is served directly from secure storage.

Change summaries

When you upload a version after v1, Studio Color automatically generates a short plain-English summary of differences between the new version and the one before it. This is powered by Claude and covers things like added scenes, deleted sequences, location changes, and character additions or removals.

Script Analyzer — AI breakdown

The Script Analyzer is the most powerful feature in Studio Color. Upload your script PDF and the AI reads it to extract every scene, location, and prop — then you review the results and confirm them into your project. This populates your Scenes, Locations, and Props lists in one step.

Running an analysis

• Navigate to Script Analyzer in the Production section of the sidebar (only visible if you are a super admin).
• Upload your script PDF. The page immediately queues the analysis and shows a live progress screen.
• The AI identifies: scenes (with scene number, name, location, script day, and day/night), locations referenced in the script, and props mentioned in the action lines.
• You are shown a review screen where you can inspect, edit, and remove individual items before confirming. This is your chance to correct any AI misreads.
• Click Confirm & Import to write the scenes, locations, and props to your project. Existing records are merged intelligently — scenes are matched by scene number, locations by name.

How analysis runs

The analyzer uses a background pipeline so the page never freezes or times out, even on long feature-length scripts:

• Immediate response — As soon as you upload, the analysis is queued via a durable message queue and you see a live progress bar. The page responds in under a second.
• Live progress via Realtime — The progress bar and status message update automatically as the analysis moves through its stages (downloading PDF, extracting text, analyzing, merging results). No manual refreshing needed.
• Navigate away safely — Analysis runs in the background on dedicated infrastructure. You can close the tab and come back later. When you return, the page reconnects to the running analysis and resumes showing progress. Any rows stuck for more than 10 minutes are automatically marked failed so you can try again.
• Single-pass for most scripts — Scripts up to about 150 pages are analyzed in a single AI call with no merge step. This is the fastest path and produces the most consistent results because the AI sees the whole script at once (no cross-chunk seams). A 110-page feature typically completes in 60–90 seconds.
• Parallel section analysis for very long scripts — Scripts beyond 150 pages are split into scene-aligned sections processed simultaneously (up to 5 at once), then a deduplication pass merges results across sections. Individual sections retry automatically on transient API errors, with a fallback model if needed.
• Automatic QC — After the AI pass, a validation step checks cross-references, duplicate scene numbers, and miscategorized items, and auto-fixes what it can.
• Stuck detection — If the analysis has not reported progress for 90 seconds, a warning appears with a Cancel & Try Again button.

What gets imported

• Scenes — Scene number, name, location reference, script day, and INT/EXT/DAY/NIGHT metadata.
• Locations — Location names extracted from scene headings, created as new locations if they don’t already exist.
• Art Department Items — Props, set dressing, wardrobe, and vehicles extracted from action lines. Each item is categorized and linked to the scenes it appears in. You can re-categorize items on the review screen before confirming.

Usage limits

Each subscription plan includes a set number of script analyses per project. Additional credits can be purchased from the Billing page. Usage is shown in the Script Analyzer UI.

Permissions