On Book

Appearance

Script Import & AI Analysis ​

Let AI build your show structure in minutes.

Overview ​

The AI Script Import feature uses a multi-stage analysis pipeline to accurately extract structure from your PDF script:

  1. OCR (Mistral OCR): High-fidelity text extraction from your PDF
  2. AI Extraction (Gemini 2.5 Pro): Deep extraction of scenes, characters, dialogue, props, and sound cues

After import, you can view and edit the full script in the Script subtab.

What Gets Extracted ​

  • ScriptBlocks — The full script content broken into editable blocks
  • Scene structure with act assignments
  • Character names and their scene appearances
  • Props mentioned in stage directions
  • Sound cues from the script

How to Import a Script ​

Step 1: Open File Management ​

  1. Click the hamburger menu (☰) in the top-left corner
  2. Select "File Management"

Step 2: Upload Your Script ​

  1. Click "Import Script (PDF)"
  2. Select your PDF file
  3. Wait for the upload to complete

Step 3: AI Analysis ​

Once uploaded, the AI will:

  1. Show an "Analyzing..." toast notification
  2. OCR: Extract text from the PDF (5-15 seconds)
  3. Extraction: Analyze the script for structure, characters, and cues (1-5 minutes depending on length)
  4. Display a success message when complete

The PDF is also saved to your Cloud File Repository for future reference.

Step 4: Review Imported Data ​

Navigate to Show Structure to review:

SubtabWhat to Check
Acts & ScenesActs and scenes are correctly numbered and named
CharactersNames are spelled correctly (merge duplicates if needed)
ScriptFull script content with block-by-block editing

The Script Subtab ​

After import, the Script subtab provides two viewing modes:

Reading Mode (Default) ​

  • View your script in a clean, readable format
  • Navigate by scene
  • See character dialogue formatted correctly

Block View Mode ​

  • View the script as editable ScriptBlocks
  • Each block has a type: dialogue, stage_direction, heading, lyric, character_name, front_matter, other
  • Click any block to edit its content or reclassify its type
  • Useful for correcting AI misclassifications

Editing Script Blocks ​

  1. Go to Show Structure → Script
  2. Toggle to Block View (icon)
  3. Click any script block to open the editor
  4. Make changes:
    • Edit the text content
    • Change the block type (e.g., from stage_direction to dialogue)
    • Assign to a different scene
  5. Click Save

Partial Imports & Repair ​

If the AI encounters errors during extraction, your import will be marked as partial. You don't lose the successful results — the toolbar status chip will turn amber and allow you to selectively re-run only the failed phases.

Repairing a Partial Import ​

  1. Look for the amber warning chip in the Show Structure toolbar
  2. Click it to open the Repair Popover
  3. Failed phases are pre-selected (Structure, Props, Sound Cues, Blocks)
  4. Toggle any phases you want to re-run
  5. Click Repair — only the selected phases are re-processed

Best Practices ​

✅ For Best Results ​

  • Use text-based PDFs — Scanned images are supported but text-based PDFs give better results
  • Standard formatting — Scripts with clear scene headings work best
  • Clear character names — Consistent naming throughout the script

⚠️ Common Issues ​

Problem: Import fails or hangs Solution: Check that your PDF is under 10MB and try re-importing. Use the repair feature if partial.

Problem: Character names are incorrect Solution: Edit in Show Structure → Characters. Character data is consolidated here.

Problem: Scenes are mislabeled Solution: Drag and drop scenes to reorder, or edit act/scene numbers manually

Problem: Script blocks have wrong types Solution: Use Block View (bar_chart) to reclassify blocks

Manual Editing After Import ​

All imported data can be edited:

Editing Scenes ​

  1. Go to Show Structure → Acts & Scenes
  2. Click on any scene to edit its name or act assignment
  3. Drag scenes to reorder them

Editing Characters ​

  1. Go to Show Structure → Characters
  2. Click a character to edit their name or scene assignments
  3. Characters support soft-delete (can be restored)

Editing Script Blocks ​

  1. Go to Show Structure → Script
  2. Toggle to Block View (bar_chart)
  3. Click any block to edit content or type

Editing Props ​

  1. Go to Props
  2. Review the list or extract from script
  3. Add missing props or delete incorrect entries

Tips for Success ​

emoji_objects Import early in your process — It's easier to edit AI-generated content than to manually enter everything

emoji_objects Review the Script subtab — Verify the AI correctly identified scene breaks and character dialogue

emoji_objects Use Block View for corrections — The block editor makes it easy to fix misclassified content

emoji_objects Use the Repair feature — If a phase fails, you can re-run just that phase without re-importing

Video Tutorial ​

video_library Watch: How to Import a Script (Coming soon)

Last updated: March 2, 2026 (Mistral OCR pipeline, parallel extraction, repair workflow)