On Book

Appearance

Script Import & AI Analysis ​

Human review required. AI import needs review before the data is used for scheduling, reports, prompt book, or performance.

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 when script text access is enabled.

Analysis Modes ​

On Book Pro offers two levels of AI script analysis:

FeatureStandardScript Text Access
Scene structure✅✅
Character extraction✅✅
Props and sound cue candidates✅✅
Full script text (Script/Rehearsal Script subtabs)❌✅
Block-level editing❌✅

Standard is the default for all projects and extracts all production metadata (structure, characters, props, sound cues) directly from the PDF in a single AI call.

Script text access additionally performs full OCR to capture verbatim script text, enabling the editable Script subtab for authorized editors and the focused Rehearsal Script subtab for read-focused collaborators. Access is enabled per-project by an administrator.

Note: Script text storage is subject to your production's copyright and licensing agreements. Project access should be granted with that in mind.

What Gets Extracted (Both Modes) ​

  • Scene structure with act assignments
  • Character names and their scene appearances
  • Props and sound cue candidates from the script

What Gets Extracted With Script Text Access ​

  • ScriptBlocks — The full script content broken into editable blocks

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.

Standard imports may not create every generated script artifact. That is expected: On Book Pro checks which generated files exist before loading optional script blocks, props, or sound cues so metadata-only projects do not show avoidable missing-file errors.

Retention

Source PDFs are not automatically deleted after analysis. If you no longer want the PDF retained, move it to Trash or permanently delete it from Files. Generated script and OCR artifacts are retained for import, repair, and prompt book workflows, and are removed only by the project deletion cleanup paths currently covered by the retention policy.

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 for roles that can edit script text
Rehearsal ScriptFocused script reading with assigned-character highlights for read-focused roles

Prompt Book, Performance, Line Notes, and the script-reading subtabs are only available when the project has script text access.

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

The Rehearsal Script Subtab ​

For read-focused collaborators, the same imported script text appears as Rehearsal Script in Show Structure. It highlights characters linked to your personnel profile, lets you add more characters for the current session, and provides previous/next speech navigation for selected roles. It does not expose block editing or type reassignment controls.

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 and Rehearsal Script subtabs — Verify the AI correctly identified scene breaks, character dialogue, and assigned-role highlights

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 walkthrough: planned.

Last updated: May 25, 2026 (tenant-scoped import and optional artifact loading)