Welcome to NoosphereWriter

NoosphereWriter is an AI-assisted screenwriting application designed to help you craft professional screenplays. It follows industry-standard formatting conventions and provides intelligent assistance throughout your writing process.

Principles

• Flexible AI Integration

  You retain full creative control, utilizing AI as much or as little as you like.

• The Studio System in a Box

  NoosphereWriter democratizes the filmmaking process, replacing the infrastructure of a development team with flexible AI agents—acting as Producer, Director, and Script Doctor—to allow a single creator to execute a complex studio-level vision.

• Adversarial Narrative Design

  Beyond simple generative drafting, the application acts as an adversarial engine that operationalizes rigid Hollywood storytelling theories to stress-test your screenplay for structural integrity and commercial viability.

• Unified Production Reality

  The application collapses the gap between the writing and pre-production phases, seamlessly integrating creative storytelling with logistical planning to ensure your work is not just readable, but produceable.

Key Features

Command Palette

The Command Palette is a powerful tool inspired by "Spotlight" search. It allows you to find and execute any feature in NoosphereWriter instantly, without digging through menus.

Key Benefits:

• Speed: Execute commands without lifting your hands from the keyboard.
• Discovery: Find features you didn't know existed by searching for what you want to do (e.g., search "stress test" to find "Red Teaming").
• Categorization: See features grouped by workflow stage (Validation, Analysis, Production, Export).

How to Use

1. Press Ctrl+K (Windows/Linux) or Cmd+K (Mac) anywhere in the app.
2. Type the name of a feature or a keyword describing what you want to do.
3. Select the feature from the list and press Enter (or click it).

Quick Start Guide

1. Create a New Screenplay

   Go to File → New or press Ctrl+N to start a new screenplay.

2. Set Up Your Title Page

   Go to Script → Title Page to add your screenplay title, author name, and contact information.

3. Define Your Movie Concept

   Go to Script → Movie Concept to outline your story's genre, themes, and premise.

4. Start Writing

   Use the element buttons or keyboard shortcuts to format your screenplay:

   • Ctrl+1 - Scene Heading
   • Ctrl+2 - Action
   • Ctrl+3 - Character
   • Ctrl+4 - Parenthetical
   • Ctrl+5 - Dialogue
   • Ctrl+6 - Transition

5. Save Your Work

   Go to File → Save or press Ctrl+S to save to Google Drive.

File → New

Creates a new, blank screenplay. If you have unsaved changes, you'll be prompted to save them first.

Shortcut: Ctrl+N (Windows/Linux) or Cmd+N (Mac)

File → Open

Opens the file picker to select a screenplay from your Google Drive. You can also access recent files for quick opening.

Shortcut: Ctrl+O (Windows/Linux) or Cmd+O (Mac)

Recent Files

The submenu shows your recently opened screenplays for quick access. Select any recent file to open it immediately.

File → Save

Saves the current screenplay to Google Drive. If the file hasn't been saved before, you'll be prompted to enter a filename.

Shortcut: Ctrl+S (Windows/Linux) or Cmd+S (Mac)

Save As

Creates a copy of your screenplay with a new name. Useful for creating different versions or drafts.

Shortcut: Ctrl+Shift+S (Windows/Linux) or Cmd+Shift+S (Mac)

File → Import

Import screenplays from various formats:

• Fountain (.fountain) - Plain text markup format
• Final Draft (.fdx) - Industry standard format
• Celtx (.celtx) - Celtx project files
• Fade In (.fadein) - Fade In document format
• NoosphereWriter (.nws) - NoosphereWriter project files (v1.0 and v2.0)
• Plain Text (.txt) - Basic text files
• PDF (.pdf) - Extract text from PDF screenplays

Security & XSS Protection

NoosphereWriter includes comprehensive security measures to protect against malicious content:

• Automatic Content Sanitization: All imported files are automatically scanned and cleaned of potentially dangerous content
• XSS Attack Prevention: JavaScript, script tags, and other executable content are automatically removed from imported files
• Security Warnings: If potentially unsafe content is detected during import, you'll receive a notification showing what was sanitized
• Performance Optimized: Security scanning uses intelligent detection to maintain fast import speeds while ensuring safety

Protected Content Types

Our security system automatically detects and removes:

• <script> tags and JavaScript execution
• javascript: URLs and protocol handlers
• Event handlers (onclick, onerror, onload, etc.)
• <iframe>, <object>, and <embed> elements
• <form> elements and data submission vectors
• Dangerous CSS and style injections

Safe Import Process

1. Content Analysis: Files are quickly scanned for dangerous patterns
2. Threat Detection: Any potentially harmful content is identified and flagged
3. Automatic Sanitization: Dangerous elements are safely removed while preserving screenplay formatting
4. User Notification: If threats were found, you'll see a security warning with details
5. Safe Loading: Only clean, safe content is loaded into your screenplay editor

Note: This protection works automatically in the background - you don't need to take any action. The system is designed to preserve all legitimate screenplay content while removing only genuinely dangerous elements.

File → Export

Export your screenplay in various formats:

• NoosphereWriter (.nws) - Native project format (for backup/sharing)
• PDF - Professional PDF with proper formatting
• Watermarked PDF - PDF with custom watermark text
• Word Document (.docx) - For Microsoft Word and other processors
• Rich Text Format (.rtf) - Universal document format
• Fountain - Plain text markup format
• Final Draft XML - For use in Final Draft
• Celtx - For use in Celtx
• Fade In - For use in Fade In
• Highland - For use in Highland 2
• Plain Text - Basic text file
• LaTeX (.tex) - Academy-compliant formatting for professional typesetting

LaTeX Export

The LaTeX export creates a professional, Academy-compliant screenplay format using John Pate's screenplay document class. This format is ideal for high-quality typesetting and professional submissions.

Requirements

To compile the exported .tex file, you'll need:

• John Pate's screenplay class: Available at https://github.com/JohnPate/Screenplay
• LaTeX distribution: TeX Live, MiKTeX, or similar
• LaTeX editor: TeXShop, TeXstudio, Overleaf, or any LaTeX compiler

Features

• Professional screenplay formatting with proper margins and spacing
• Title page integration (if configured in Tools → Title Page)
• All screenplay elements: scene headings, dialogue, action lines, transitions
• Character directions and parentheticals
• Academy-compliant layout and typography
• Automatic LaTeX character escaping for special characters

Usage

1. Click File → Export → LaTeX (.tex)
2. Save the downloaded .tex file
3. Install John Pate's screenplay class in your LaTeX environment
4. Compile the .tex file using your preferred LaTeX tool

Note: The LaTeX format provides precise control over formatting and is particularly useful for professional submissions requiring exact industry standards.

Settings

Configure application preferences, AI models, and integrations.

Models Tab

Manage your Google Gemini API key and configure how AI models are used across the application.

Google Gemini API Key

Enter your Google Gemini API key here. The key is encrypted and stored locally in your browser. You can obtain a free API key from Google AI Studio.

Model Allocation Strategy

Optimize performance and cost by assigning specific models to different types of tasks:

• Utilities: For fast, routine tasks like Thesaurus, Formatting, and Auto-complete. (Recommended: Gemini Flash)
• Creative Generation: For content creation tasks like Idea Lab, Character Interviews, and Scene Writing. (Recommended: Gemini Flash or Pro)
• Deep Analysis: For complex reasoning tasks like Script Doctor, Breakdowns, and Consultants. (Recommended: Gemini Pro)

Project Phases

Project Phases customize your NoosphereWriter experience to match your creative workflow. Each phase shows the most relevant tools and AI assistance for that stage of your project.

Available Phases

NoosphereWriter includes three built-in phases:

• Ideation: Focus on expansion, structure, and thematic grounding. Emphasizes Movie Concept, Theme Structure, Characters, and Locations. Production tools are hidden.
• Drafting: Focus on execution, flow, and narrative integrity. Enables AI-powered context menu assistance (Generation, Refinement, Analysis, Report), craft and style tools, and script evaluation reports.
• Production: Focus on logistics, feasibility, and asset generation. Shows Marketing, Pre-Production, Design System, and Shot Planning tools. AI context menu assistance is disabled.

Accessing Project Phases

Open the Phase Configuration dialog via File → Preferences → Phases.

Select the phase that matches your current creative stage and click Set Phase.

How Phases Curate the UI

• Menu Filtering: Script, Production, and Reports menus show only relevant items for your phase.
• Context Menu: AI-powered features (Generation, Refinement, Analysis, Report) are only visible in Drafting phase.
• AI Context: AI assistants are informed of your current phase for more relevant responses.

Command Palette Override

Even with phase filtering active, you can access all features anytime via the Command Palette (Ctrl+K or Cmd+K). This ensures you're never locked out of any tool.

Workflow Recommendations

• Starting a new project? Begin in Ideation to establish your story's foundation.
• Writing your first draft? Switch to Drafting for AI assistance with scenes and dialogue.
• Preparing for production? Move to Production for breakdowns, shot lists, and storyboards.

Writer's Codex

The Writer's Codex is a sophisticated style analysis engine that captures your unique narrative voice and "teaches" it to the AI. This ensures that AI suggestions align with your personal writing style rather than sounding generic.

Key Features

• Voice Calibration: Analyzes your specific sentence rhythm, vocabulary, and subtext density.
• Structural Alignment: Adapts to your preferred pacing and act structure.
• Consistent Tone: Ensures AI-generated content (like Scene Lab drafts or Dialogue) feels like you wrote it.

How to Use

1. Go to File → Preferences → Writer's Codex.
2. Create a Profile: Upload an existing screenplay (.fountain, .pdf, .fdx) to analyze your style.
3. Set Active Profile: Select a profile to be the "Active Writer Profile."
4. Write: AI features like Scene Lab, Character Debate, and Storyboard will automatically use this profile to guide their output.

Analyzed Traits

The Codex builds a "Vector Summary" of your style based on 4 dimensions:

• Dialogue Style: Rhythm (rapid vs. deliberate), subtext, and voice distinction.
• Structure: Beat sheet alignment and act break intensity.
• Emotional Dynamics: Character agency and emotional arc trajectory.
• Format Metrics: Action-to-dialogue balance and scene length variance.

Basic Editing

Standard editing operations with screenplay-specific enhancements:

Undo/Redo

• Undo: Ctrl+Z - Reverses the last action
• Redo: Ctrl+Y or Ctrl+Shift+Z - Restores an undone action

Cut/Copy/Paste

• Cut: Ctrl+X - Removes selected text to clipboard
• Copy: Ctrl+C - Copies selected text to clipboard
• Paste: Ctrl+V - Inserts clipboard content

Select All

Ctrl+A - Selects the entire screenplay

Find & Replace

Search and replace text throughout your screenplay:

Find

Shortcut: Ctrl+F

• Case-sensitive search option
• Whole word matching
• Navigate with Next/Previous buttons
• Shows match count

Replace

• Replace single instance or all occurrences
• Preview replacements before applying
• Undo support for all replacements

Semantic Find

AI-powered search that understands context and meaning in your screenplay.

How It Works

Unlike regular find, Semantic Find understands what you're looking for conceptually:

• Search for "romantic moments" to find love scenes
• Search for "conflict" to find arguments and tension
• Search for "character reveals" to find important disclosures

Using Semantic Find

1. Go to Edit → Semantic Find or press Ctrl+Alt+F
2. Enter a natural language description
3. Review the AI-identified matches
4. Click any result to jump to that location

Go to Page/Scene

Quickly navigate to specific pages or scenes:

Go to Page

Shortcut: Ctrl+G

Enter a page number to jump directly to that page.

Go to Scene

Enter a scene number or partial scene heading to jump to that scene.

Headers & Footers

Customize headers and footers that appear on your screenplay pages when printing or exporting to PDF.

Overview

The Headers & Footers feature allows you to add professional page headers and footers to your screenplay. These appear on all script pages (excluding the title page) in PDF exports and print previews.

Accessing Headers & Footers

Go to Edit → Headers & Footers to open the configuration dialog.

Configuration Options

For both headers and footers, you can configure three positions: Left, Center, and Right. Each position can display:

• None - No content at this position
• Page Number - Current script page number
• Current Date - Today's date
• Custom - Your own custom text

Custom Text

When you select "Custom" for any position, an input field appears where you can enter your custom text. This is useful for:

• Copyright notices
• Draft versions (e.g., "First Draft")
• Confidentiality notices
• Author attribution

Default Footer

If no headers or footers are configured, a default footer "Created Using NoosphereWriter" will appear in the center of each page. This can be customized or removed by configuring your own footer settings.

Preview

The dialog includes a live preview showing how your headers and footers will appear on the page. This helps you visualize the layout before applying your settings.

Usage Tips

• Headers and footers appear on all pages except the title page
• Page numbers in headers/footers represent script pages, not PDF pages
• Settings are saved with your screenplay file
• Changes apply to PDF exports and print previews

Common Configurations

Professional Script

• Header Right: Page Number
• Footer Center: Custom ("© 2024 Your Name")

Draft Version

• Header Left: Current Date
• Header Right: Page Number
• Footer Center: Custom ("DRAFT - CONFIDENTIAL")

Minimal

• Header Right: Page Number
• All other positions: None

Screenplay Elements

NoosphereWriter automatically formats screenplay elements according to industry standards:

Element Navigation (Enter & Tab Keys)

Use Enter and Tab keys to quickly navigate between screenplay elements while writing:

Auto-Formatting

NoosphereWriter intelligently detects and formats screenplay elements as you type:

Scene Headings

• Type "INT." or "EXT." at the start of a line
• Automatically converts to scene heading format
• Suggests common locations as you type

Character Names

• Type character name in ALL CAPS
• Automatically formats as character element
• Remembers character names for auto-completion

Parentheticals

• Start a line with "(" after a character name
• Automatically formats as parenthetical

Transitions

• End a line with "TO:" (e.g., "FADE TO:")
• Automatically formats as transition

Text Formatting

Apply emphasis to your screenplay text:

Bold

Shortcut: Ctrl+B

Makes selected text bold. Use sparingly in screenplays.

Italic

Shortcut: Ctrl+I

Makes selected text italic. Commonly used for emphasis.

Underline

Shortcut: Ctrl+U

Underlines selected text. Rarely used in modern screenplays.

Scene Numbers

Add scene numbers for production drafts:

Show/Hide Scene Numbers

Toggle scene number visibility via Format → Scene Numbers

Scene Number Format

• Numbers appear on left and right margins
• Automatically updates when scenes are added/removed
• Preserved in PDF exports when enabled

Page Zoom

Adjust the display size of your screenplay:

Zoom Levels

• 50% - Overview mode
• 75% - Compact view
• 100% - Default size
• 125% - Enlarged view
• 150% - Large text
• 200% - Maximum zoom

Shortcuts

• Ctrl+Plus - Zoom in
• Ctrl+Minus - Zoom out
• Ctrl+0 - Reset to 100%

Scene Navigation Panel

Toggle the scene list sidebar for quick navigation:

Features

• Shows all scenes in order
• Click any scene to jump to it
• Shows current scene highlighted
• Updates in real-time as you write

Toggle Panel

Go to View → Scene Navigation or press F3

Dual Dialogue

Format two characters speaking simultaneously:

Creating Dual Dialogue

1. Write the first character's dialogue normally
2. Position cursor after the dialogue
3. Go to Format → Dual Dialogue
4. Write the second character's dialogue

Display

Dual dialogue appears side-by-side in the script, clearly showing simultaneous speech.

Full Screen Mode

Enter distraction-free writing mode:

Toggle Full Screen

Shortcut: F11

Or go to View → Full Screen

Features

• Hides browser interface
• Maximizes writing space
• Press Esc to exit

Active To-Do List

The Active To-Do List is an intelligent task management system designed specifically for screenwriters. It doesn't just track tasks; it actively helps you move your script forward with context-aware suggestions and workflow templates.

Core Features

• Smart Workflows: Choose from pre-built guides like "Idea First," "Production Prep," or "Rewrite & Rescue" to get a tailored checklist for your current writing phase.
• Active Monitoring: The system analyzes your script's state (e.g., page count, character development) and intelligently suggests relevant tasks, such as "Analyze Act 1 Pacing" or "Flesh out Protagonist."
• AI Producer: Click "Generate Tasks" to have the AI analyze your current script section and generate specific, actionable revision tasks automatically.
• Sprint Mode: A dedicated planning tool to help you hit deadlines. Learn more about Sprint Mode.

Workflow Templates

Access the Workflow List button (📋) to select a guided path:

• Idea First: For turning a spark of an idea into a solid concept.
• Character-First: For building a story around strong characters.
• Production Prep: For getting a script ready for shooting (Shot Lists, Props, Breakdowns).
• Rewrite & Rescue: For fixing structural issues in existing drafts.
• Visual Director: For establishing the "look and feel" before writing scenes.

Active Suggestions

As you write, you may see suggestions appear at the top of your list with an "Add" button. These are triggered by:

• Milestones: Reaching page count targets (e.g., "Act 1 Complete").
• Missing Elements: Detecting undefined characters or lack of themes.
• Stagnation: Prompting checks if you haven't written for a while.

AI Producer Mode

Click the Generate Tasks button (✨) to open the AI Producer. It will read your current 10-page chunk and generate 3-5 specific, actionable revision tasks to improve dialogue, pacing, and description.

Sprint Mode

Sprint Mode helps screenwriters plan and execute focused writing sprints by automatically generating daily goals based on your timeline and page count targets.

What is Sprint Mode?

Sprint Mode is a wizard-based planning tool that creates a structured writing schedule following the three-act screenplay structure. It calculates how many pages you need to write each day and distributes the work across acts to help you complete your screenplay on time.

Accessing Sprint Mode

1. Open the To-Do List (click the checkbox icon or press Ctrl+Shift+2)
2. Click the rocket icon (🚀) in the To-Do List header
3. Alternatively, if your To-Do list is empty, click the "Start Sprint Mode" button

Sprint Mode Wizard Steps

Step 1: Sprint Duration

Choose how many days for your writing sprint:

• Presets: 7, 10, 14, 21, or 30 days
• Custom Date: Pick any end date using the calendar

Step 2: Screenplay Parameters

• Target Page Count: Set your screenplay's target length (default: 120 pages)
• Research/Outline Days: Optionally add 2 days at the start for research and beat sheet creation
• Revision Days: Optionally add 2 days at the end for revisions and polish

The wizard displays a summary showing your writing days, average pages per day, and other calculated metrics.

Step 3: Preview & Apply

• Review all generated daily goals before adding them
• Edit individual goal text if needed
• Click "Apply Goals" to add them to your To-Do List

Three-Act Structure

Sprint Mode distributes writing goals according to the standard three-act screenplay structure:

• Act 1 (25%): Setup & Inciting Incident
• Act 2A (25%): Rising Action & Midpoint
• Act 2B (25%): Complications & Crisis
• Act 3 (25%): Climax & Resolution

Goal Categories

Generated goals are color-coded by category:

• Research (purple) - Initial research and brainstorming
• Outline (blue) - Beat sheet and structure planning
• Writing (green) - Daily page writing targets
• Revision (orange) - Polish and cleanup tasks

Example Sprint

A 10-day sprint with 120 pages and both research and revision days enabled would generate:

• Days 1-2: Research and outline
• Days 3-8: Writing (averaging 20 pages per day across acts)
• Days 9-10: Revision and final polish

Tips for Success

• Be realistic about your daily output when setting page counts
• Include research days if you haven't fully outlined your story
• Leave revision days at the end for a polished final draft
• Edit goal text to add specific scene or beat targets
• Check off completed goals daily to track your progress

Comments & Annotations

Add inline comments and notes throughout your screenplay for collaboration and revision tracking.

Creating Comments

1. Select text in your screenplay
2. Right-click and choose "Add Comment"
3. Or press Ctrl+Alt+C
4. Type your comment
5. Comments appear as highlighted text

Managing Comments

• Click comment icon in toolbar to see all
• Jump to any comment location
• Mark comments as resolved
• Delete old comments
• Filter by status

Best Practices

• Use for revision notes
• Track feedback from readers
• Mark problem areas
• Note research needs
• Collaborate with partners

Plot Board

Visual story structure tool for planning and organizing your screenplay's beats and sequences.

Board Structure

• Act 1: Setup beats
• Act 2A: Rising action
• Act 2B: Complications
• Act 3: Resolution

Creating Beats

1. Click + in any act section
2. Add beat description
3. Set beat type (Plot, Character, Theme)
4. Add detailed notes
5. Link to script scenes

Templates

Start with proven structures:

• 15-beat Blueprint
• Hero's Journey
• Three-Act Structure
• Five-Act Structure
• Custom templates

AI Customization

Generate story-specific beats:

1. Choose a template
2. Click "Customize with AI"
3. AI adapts beats to your story
4. Edit and refine as needed

Generate Draft

Transform your Plot Board beats into a first draft screenplay using AI. This powerful feature converts your story structure directly into properly formatted screenplay scenes.

How It Works

The Generate Draft feature uses a two-phase AI approach:

1. Beat Expansion: Each beat is expanded into a detailed step outline, identifying key moments, character interactions, and scene flow
2. Scene Writing: The step outline is transformed into properly formatted screenplay content with scene headings, action lines, and dialogue

Using Generate Draft

1. Open the Plot Board dialog (View → Plot Board)
2. Click the "Generate Draft" button in the toolbar
3. Configure your generation settings:
   • Scope: Generate all acts or Act 1 only
   • Creativity Level: Adjust from strict adherence to creative expansion
   • Dialogue/Action Ratio: Control the balance between dialogue and action lines
   • Max Word Count: Set the target length for each generated scene
   • Include Character Notes: Add parenthetical directions for key moments
4. Click "Generate" to start the process
5. Monitor progress as each scene is generated
6. Generated scenes are automatically inserted into your screenplay

Configuration Options

• Generate All Acts: Converts all beats across your entire plot board
• Generate Act 1 Only: Focuses on the first act for faster iteration
• Creativity Level Slider:
  • Strict Adherence (left): Closely follows beat descriptions
  • Creative Expansion (right): Adds more creative details and elaboration
• Dialogue vs. Action Ratio:
  • Action Heavy (left): Prioritizes visual storytelling and movement
  • Balanced (center): Equal mix of dialogue and action
  • Dialogue Heavy (right): Focuses on character interaction and speech
• Max Word Count per Scene: Adjustable target length (200-1000 words) to control scene pacing and depth
• Character Notes: When enabled, includes acting directions and emotional beats

Best Practices

• Detailed Beats: Write detailed beat synopses for better scene generation
• Character Data: Set up your characters in Script → Characters before generating
• Movie Concept: Fill in your Movie Concept for better context and continuity
• Iterative Approach: Start with Act 1 to test results before generating the full script
• Review and Revise: Treat generated content as a first draft to be refined

Scene Linking

After generation, each beat is automatically linked to its corresponding scene in the screenplay. This connection allows you to:

• Navigate directly from a beat to its scene
• Track which beats have been written
• Maintain alignment between structure and content

Cancellation

If you need to stop generation mid-process:

• Click the "Cancel Generation" button
• Already generated scenes will be preserved
• You can resume from where you left off by regenerating

Requirements

• Google AI API key configured in File → Settings
• At least one beat in your Plot Board
• Internet connection for AI generation

Zen Mode

Zen Mode provides a distraction-free writing environment by hiding all UI elements except the editor.

Activating Zen Mode

• Go to View → Zen Mode
• Or press Ctrl+Alt+Z

Features

• Distraction-Free: Hides the menu bar, toolbar, status bar, and sidebar
• Full Screen: Automatically enters full-screen mode
• Auto-Close: Automatically closes floating dialogs (To-Do, Comments)

Exiting Zen Mode

To exit Zen Mode and restore the standard interface:

• Press Ctrl+Alt+Z again
• Or press Esc (this also exits full-screen mode)

Tools Menu Overview

The Tools menu provides AI-powered creative assistance and development tools organized by workflow focus:

Story Development

Deep dive tools for developing story elements:

Note: Theme Excavation is now accessed via Script → Movie Concept → Themes tab → Excavate.

Note: World-Building is now accessed via Script → Locations → Add/Edit Location → World-Building button.

Note: Stakes Escalation is now accessed via right-click on a Scene Heading → Generation → Stakes Escalation.

Character Development

Advanced character exploration and development tools:

• Character Crucible - Test characters through difficult moral choices under pressure
• Inner World Explorer - Dive deep into character psychology and emotions
• Character Interview - Interview-style character development and exploration

AI Coaching

Personalized AI guidance and professional consultation:

• Screenwriting Coach - Progressive AI tutoring with personalized lessons
• Creative Consultant - Access 14+ industry professional consultants

Utilities

Essential formatting and editing tools:

• Check Formatting - Validate screenplay formatting standards
• Insert Symbol - Special character insertion tool

Workflow Builder

Create custom AI workflows by chaining multiple features together. Workflow Builder allows you to automate complex tasks, create personalized writing assistants, and standardize your production processes.

Creating a Workflow

1. Open Workflow Builder from the Tools menu
2. Click "Create New Workflow"
3. Name your workflow (e.g., "Polishing Assistant", "Production Prep")
4. Add a description
5. Select features to include in the workflow:
   • Validation: Format Check, Continuity, etc.
   • Production: Breakdown, Shot List, Actor Breakdown
   • Story Development: Scene Optimizer, Final Polish, etc.
6. Reorder actions using up/down arrows to set execution order
7. Click "Create Workflow" to save

Executing a Workflow

1. Open Workflow Builder
2. Find your workflow in the list
3. Optionally enable "Force regenerate all features" to ignore cached results
4. Click the Play button (▶) next to the workflow
5. Monitor progress as each action executes
6. View consolidated results when complete

Understanding Results

After execution completes, Workflow Builder displays:

• Execution Summary: How many actions succeeded/failed
• Consolidated Findings: All issues grouped by severity:
  • Critical: Major problems requiring immediate attention
  • Warning: Significant issues to address
  • Minor: Small improvements to consider
• Finding Details: Each issue shows:
  • Category (Format, Continuity, Readability, etc.)
  • Description of the problem
  • Location in script (page/scene number)

Managing Agents

Editing Agents

1. Click the Edit button (✏) next to any agent
2. Modify name, description, or selected features
3. Reorder actions as needed
4. Click "Update Agent" to save changes

Deleting Agents

1. Click the Delete button (🗑) next to any agent
2. Agent is immediately removed
3. This action cannot be undone

Cache Control

Workflow Builder integrates with NoosphereWriter's intelligent caching system:

• Default Behavior: Uses cached results when screenplay and context haven't changed (faster execution)
• Force Regenerate: Enable this option to run fresh analyses for all features, ignoring cache
• When to Force: After making significant script changes, when you want the latest analysis
• Cache Validation: System automatically detects when screenplay content or context (characters, locations, themes) has changed

Example Workflows

Script Quality Audit

Comprehensive validation before submission:

1. Format Error Detector
2. Continuity Check
3. Common Flaws Report
4. Readability Report
5. On-the-Nose Detector

Pre-Production Package

Complete production planning suite:

1. Script Breakdown
2. Shot List
3. Actor Breakdown

Final Polish Check

Last-pass optimization before locking script:

1. Readability Report
2. Cinematic Language
3. Cadence Analyzer
4. Scene Optimizer
5. Final Polish

Best Practices

• Start Small: Create focused agents for specific tasks (validation only, production only, etc.)
• Logical Ordering: Arrange actions in a meaningful sequence (e.g., fix formatting before analyzing style)
• Descriptive Names: Use clear names that indicate the agent's purpose
• Regular Use: Run quality check agents periodically during development
• Pre-Submission: Execute comprehensive audit agents before sharing your script
• Production Prep: Use production-focused agents when transitioning from development to pre-production

Global Agent Library

Agents are saved globally and available across all your screenplays. Create once, reuse everywhere:

• Agents persist between sessions
• Available for any screenplay you work on
• Build a library of specialized workflows
• Share agent configurations with writing partners (future feature)

Performance Tips

• Caching: Leave "Force regenerate" disabled for faster execution when script hasn't changed
• Selective Execution: Create multiple focused agents instead of one giant agent
• Sequential Processing: Features execute one at a time to ensure reliable results
• Background Work: Workflow Builder shows progress - you can review results while it runs

Troubleshooting

Agent Execution Failed

• Check that you have screenplay content in the editor
• Verify your AI API key is configured in Settings
• Review the error message for specific feature failures
• Try running the failing feature individually to diagnose

No Results Displayed

• Some features don't produce "findings" (e.g., Breakdown, Shot List)
• Check the Execution Log to verify which features completed
• Individual feature results are saved to their respective storage locations

Cached Results Not Updating

• Enable "Force regenerate all features" to bypass cache
• Cache automatically invalidates when screenplay or context changes
• Individual features can be run separately to refresh specific results

Screenwriting Coach

Your personal AI screenwriting tutor that provides progressive lessons and remembers your learning journey.

Features

• Personalized tutoring based on your experience level
• Progressive curriculum from basics to advanced techniques
• Conversation memory across sessions
• Practical exercises and examples
• Industry insights and best practices

Getting Started

1. Go to Tools → AI Coaching → Screenwriting Coach
2. Choose your experience level
3. Ask questions or request specific topics
4. Complete suggested exercises

Topics Covered

• Story structure and three-act format
• Character development and arcs
• Dialogue techniques
• Scene construction
• Professional formatting
• Industry standards and practices

Theme Excavation

Discover the deeper thematic questions hidden within your story concept through Socratic dialogue.

Accessing Theme Excavation

Theme Excavation is now integrated into the Movie Concept dialog for a seamless workflow:

1. Go to Script → Movie Concept
2. Navigate to the Themes tab
3. Click the Excavate button (blue button with target icon)
4. The excavation process starts automatically

The Process

Theme Excavation uses a series of probing questions to help you uncover what your story is really about:

1. Start with your surface-level concept
2. Answer thought-provoking questions
3. Dig deeper into character motivations
4. Uncover universal themes
5. Clarify your story's message

Applying Extracted Themes

When the excavation reaches the "statements" phase, you'll see potential thematic statements. Click Apply to Movie Concept to automatically match these statements to the 65 predefined themes in your Movie Concept.

Example Questions

• "What does your protagonist really want?"
• "What lie does your character believe?"
• "What truth must they discover?"
• "What universal human experience does this explore?"

Benefits

• Adds depth to your screenplay
• Strengthens character arcs
• Creates more resonant stories
• Helps with writer's block
• Automatically maps to predefined themes for consistency

World-Building

Generate rich, story-focused world-building research that brings your locations to life with authentic details and plot opportunities. World-Building is now integrated into the Location form.

How It Works

World-Building creates a comprehensive Research Dossier for each location:

1. Go to Script → Locations
2. Click Add Location or edit an existing location
3. Click the World-Building button in the dialog header
4. Select characters from the dropdown (multi-select with full character context)
5. Set the time period and story mood
6. Click Generate Research Dossier
7. Review results and click Apply All to populate location fields

Research Dossier Categories

Your research dossier includes six detailed categories with visual icons:

• Five Senses: Specific sights, sounds, smells, textures, and tastes unique to your setting
• Jargon & Lingo: Authentic professional slang and technical terms with definitions
• Daily Rhythms: Specific routines, habits, and rituals unique to this environment
• Tools of Trade: Specific equipment with functions and potential plot uses
• Points of Conflict: Inherent tensions and problems that could complicate your story
• Hidden Detail: One fascinating, insider detail that only professionals would know (highlighted in a special callout box)

Context Fields

The World-Building dialog automatically uses your Movie Concept data for richer context. You can also provide:

• Character Focus: Select characters from a dropdown - their full profiles (role, description, flaw, want, need, ghost) are included in the AI prompt
• Time Period: Include relevant timing details (e.g., "Present Day (Summer 2025), during hurricane season")
• Story Mood: Define the atmosphere and emotional tone of your scenes

Key Features

• Smart Button Logic: Generate button enables when any field is filled
• Reset Functionality: Reset button appears when you have data, allowing you to start fresh
• Persistent Data: Your research and input fields are automatically saved and restored between sessions
• AI Integration: Uses your configured AI settings and model preferences
• Visual Organization: Results displayed with bullet points and icons for easy scanning
• Context Awareness: AI considers your movie concept and character data for more relevant results

Best Practices

• Be as specific as possible in your context descriptions
• Focus on authentic, research-based details rather than generic information
• Use the research to enhance character development and plot opportunities
• Save your research dossier for reference during writing
• Reset and generate new research for different settings or time periods
• Combine multiple contexts for complex stories (location, time, character, mood)

Benefits

• Adds authenticity to your screenplay with professional-level details
• Provides plot opportunities through inherent conflict points
• Enhances dialogue with authentic jargon and terminology
• Improves sensory details in scene descriptions
• Saves research time with targeted, story-focused information
• Helps overcome writer's block with specific environmental details
• Creates consistency across scenes in the same setting

Usage Tips

• Layer Your Research: Generate research for multiple aspects of your story (different locations, time periods, character perspectives)
• Use the Hidden Detail: This unique insider information often makes the best plot devices
• Save Different Versions: Reset and regenerate for different takes on the same setting
• Reference During Writing: Keep the research dossier open in another tab while writing scenes
• Character Integration: Use the jargon and tools in character dialogue and actions

Stakes Escalation

Generate powerful ways to escalate stakes at crucial story moments, focusing on personal, temporal, moral, and dramatic consequences that deepen audience investment. Stakes Escalation is now available as a contextual right-click action on Scene Headings.

How It Works

Stakes Escalation is available as a context menu action when you right-click on a Scene Heading:

1. Right-click on any Scene Heading line in your screenplay
2. Navigate to Generation → Stakes Escalation
3. AI automatically uses your Characters data (protagonist/antagonist) and scene context
4. Review your five escalation strategies

Automatic Context Extraction

Stakes Escalation automatically gathers context from your screenplay project:

• Protagonist & Antagonist: Extracted from your Script → Characters data
• Current Scene: The scene content where you triggered the action
• Previous Scene: Context from the preceding scene
• Movie Concept: Your overall story concept and themes

Five Escalation Categories

Your escalation strategies include five powerful categories designed by script doctors:

• Ticking Clock (Temporal Stakes): Time-based pressure that creates urgency and forces immediate action
• Public Stakes (Professional & Social): Threats to reputation, career, or social standing that amplify personal consequences
• Personal Stakes (Emotional & Relational): Impact on family, loved ones, or core relationships that matter most
• Moral Stakes (Compromising the Soul): Ethical dilemmas that force characters to choose between values and victory
• Antagonist's Counter-Move: How the opposition escalates in response, making the protagonist's situation more desperate

When to Use Stakes Escalation

• Plot Development: When planning major story beats and turning points
• Rewriting: When scenes feel flat or lack dramatic tension
• Character Arcs: To deepen the personal cost of the protagonist's journey
• Pacing Issues: When the middle act needs more forward momentum
• Climax Planning: To ensure your final confrontation has maximum impact
• Antagonist Development: To make your opposition more formidable and reactive

Best Practices

• Set up your Characters first (Script → Characters) so the AI knows your protagonist and antagonist
• Focus on consequences that genuinely matter to your protagonist
• Layer multiple types of stakes for compound pressure
• Ensure escalations feel organic to your story world
• Connect stakes to your protagonist's deepest fears and desires
• Build progressively throughout your screenplay - save the biggest stakes for the climax

Character Crucible

Test your character's true nature through difficult moral choices under pressure, generating powerful dilemmas that reveal character depth and drive dramatic conflict.

How It Works

Character Crucible creates targeted moral dilemmas based on your character's psychology and story context:

1. Go to Script → Characters, select a character, and switch to the "Crucible" tab.
2. Select a character from your character roster
3. Describe the current situation creating pressure
4. Define what's currently at stake for the character
5. Click "Generate Crucible Scenario"
6. Review 3-5 powerful moral dilemmas designed to test your character

Crucible Setup Fields

All fields work together to create targeted, character-specific dilemmas:

• Character to Test: Select from your defined characters (requires Script → Characters)
• The Situation: Current plot circumstances creating pressure and urgency
• What's Currently at Stake: What will be lost or gained based on the character's choice

Character Context Integration

The AI uses your character's defined psychology to create authentic dilemmas:

• Character Flaw: Weaknesses that can be exploited
• Want vs. Need: Surface desires vs. deeper psychological needs
• Lie They Believe: False beliefs that drive poor choices
• Ghost (Backstory): Past trauma that influences current decisions
• Relationships: Connections that can be threatened or leveraged

Generated Crucible Scenarios

Each dilemma includes four critical elements designed by character psychology experts:

• The Choice: The specific decision the character must make
• Immediate Consequence: What happens right after they choose
• What This Reveals: What the choice exposes about their true nature
• Character Truth: How this contradicts or confirms their established characterization

Key Features

• Character-Driven Design: Dilemmas tailored to each character's unique psychology
• Context-Aware Scenarios: Considers current story situation and stakes
• Multiple Dilemma Options: Generates 3-5 different crucible scenarios per session
• Copy-Friendly Results: Click any choice to copy to clipboard for easy reference
• Session Persistence: Your scenarios and input are automatically saved between sessions
• Reset Functionality: Start fresh with new scenarios anytime
• AI Integration: Uses your configured AI settings and model preferences

Types of Moral Dilemmas Generated

Character Crucible focuses on dilemmas that force genuine character revelation:

• Competing Values: Force choice between two things the character holds dear
• Loyalty vs. Self-Preservation: Test bonds against personal safety
• Truth vs. Compassion: Honesty that could devastate someone they care about
• Personal Gain vs. Collective Good: Individual benefit at others' expense
• Past Promises vs. Present Needs: Old commitments that conflict with current reality
• Moral Principles vs. Practical Necessity: Ideals challenged by harsh circumstances

When to Use Character Crucible

• Character Development: Deepen character psychology and reveal hidden aspects
• Plot Planning: Generate dramatic turning points that test character growth
• Midpoint Crises: Create powerful Act 2 dilemmas that raise stakes
• Climax Design: Craft the ultimate test of character transformation
• Relationship Dynamics: Test bonds between characters under extreme pressure
• Theme Exploration: Force characters to confront story's central philosophical questions

Best Practices

• Define Characters First: Use Script → Characters to create detailed character profiles before crucible generation
• Be Specific About Stakes: The more specific your stakes, the more targeted the generated dilemmas
• Consider Story Timing: Different dilemmas work better at different story beats
• Layer Multiple Dilemmas: Use different scenarios for different characters in the same story
• Test Character Growth: Generate new dilemmas as characters evolve throughout your story
• Connect to Theme: Choose dilemmas that also explore your story's central themes

Story Integration Tips

• Plant Seeds Early: Establish what matters to your character in Act 1 so crucible moments have maximum impact
• Progressive Difficulty: Start with smaller moral tests, build to life-changing dilemmas
• Active Choice Required: Best crucibles force characters to make active decisions, not just react
• No Easy Answers: Great dilemmas have compelling arguments for multiple choices
• Character Arc Integration: Use crucibles to push character development at key story beats
• Consequence Follow-Through: Show the long-term impact of crucible choices on character relationships and self-image

Example Scenario Generation

For a character defined as a "loyal detective with trust issues from betrayal," given the situation "partner is revealed to be corrupt" with stakes "career vs. friendship," Character Crucible might generate:

• Choice: "Report your partner immediately or give them 24 hours to come clean"
• Immediate Consequence: "Either your career advances but friendship ends, or you become complicit in corruption"
• Character Revelation: "Whether loyalty to individuals trumps loyalty to justice"
• Character Truth: "Tests their claim that betrayal destroyed their ability to trust"

Integration with Other Tools

Character Crucible works seamlessly with NoosphereWriter's other features:

• Characters System: Automatically loads character psychology from Script → Characters
• Movie Concept: Considers genre and story archetype for appropriate dilemma types
• Theme Structure: Aligns dilemmas with your story's central thematic questions
• Stakes Escalation: Complements stakes generation with character-specific pressure points
• Plot Board: Crucible scenarios can be integrated into story beat planning

Inner World Explorer

Dive deep into your character's psychology, emotions, and internal landscape to discover authentic inner thoughts, complex emotional states, and psychological barriers that drive compelling character development.

How It Works

Inner World Explorer analyzes your character's psychological profile and current context to generate authentic inner world insights:

1. Go to Script → Characters, select a character, and switch to the "Inner World" tab.
2. Provide context through one or more fields:
   • Current Situation: What's happening in the character's circumstances
   • Internal Conflict: The emotional or psychological battle they're fighting
   • External Pressure: Forces, people, or situations pressuring the character
3. Click "Explore Inner World"
4. Review 2-3 comprehensive psychological insights about your character's inner experience

What You Get

Each insight provides four key psychological dimensions:

• Internal Dialogue: The character's authentic inner voice and thoughts in this moment
• Emotional State: The complex mix of emotions they're experiencing beyond surface feelings
• Psychological Barrier: What defense mechanism, fear, or psychological pattern is blocking them
• Breakthrough Moment: What would need to happen for them to have a moment of truth or breakthrough

Key Features

• Character-Centric: Requires character selection to ensure personalized insights
• Multiple Context Fields: Flexible input allowing different types of story context
• Psychological Depth: Focuses on authentic inner experience rather than external actions
• Click-to-Copy: Easily copy internal dialogues and insights to your clipboard
• Session Persistence: Saves your exploration data automatically per file
• Reset Functionality: Start fresh with new explorations anytime
• AI Integration: Uses your configured AI settings and model preferences

Types of Insights Generated

Inner World Explorer reveals different layers of character psychology:

• Conscious Thoughts: What the character is actively thinking about their situation
• Unconscious Patterns: Hidden psychological tendencies and defense mechanisms
• Emotional Complexity: The layered emotional reality beneath surface reactions
• Psychological Blocks: What's preventing the character from growth or change
• Breakthrough Opportunities: Moments of potential transformation or realization
• Inner Conflicts: The competing desires and values creating internal tension

When to Use Inner World Explorer

• Character Development: Deepen understanding of character psychology and motivations
• Scene Writing: Generate authentic internal monologue and subtext for scenes
• Emotional Beats: Explore how characters process important story moments internally
• Character Arc Planning: Understand psychological barriers that need to be overcome
• Dialogue Enhancement: Create subtext by understanding what characters aren't saying
• Method Writing: Get inside your character's head for more authentic writing

Best Practices

• Character Foundation: Ensure your character has detailed psychology (flaw, want, need, lie, ghost) for richer insights
• Specific Context: Provide concrete situations rather than vague descriptions for more targeted insights
• Emotional Honesty: Be honest about your character's emotional state, including uncomfortable feelings
• Multiple Explorations: Use different contexts to explore various facets of your character's inner world
• Scene Integration: Use insights to inform how characters behave and react in specific scenes
• Character Growth: Track how inner world insights change as your character develops through the story

Example Exploration

For a character defined as a "paranoid and distrustful warrior mother," given the situation "cleaning weapons while her son sleeps" with internal conflict "wants to give him a normal life but knows they can never be safe," Inner World Explorer might generate:

• Internal Dialogue: "I can't let my guard down, not even for a moment. Every shadow could hide a threat."
• Emotional State: "A complex mix of hypervigilance, exhaustion, and deep-seated fear masked by determination"
• Psychological Barrier: "Trust issues stemming from past betrayals, creating walls that keep others at a distance"
• Breakthrough Moment: "Realizing that her isolation is actually making her son more vulnerable, not safer"

Integration with Other Tools

Inner World Explorer works seamlessly with NoosphereWriter's other features:

• Characters System: Automatically loads detailed character psychology from Script → Characters
• Character Crucible: Complements moral choice testing with deep psychological understanding
• Movie Concept: Considers genre and story archetype for psychologically appropriate insights
• Theme Structure: Aligns inner explorations with your story's thematic questions
• Screenwriting Coach: Provides character psychology insights for scene writing lessons
• Comments System: Use insights to add psychological depth notes to specific scenes

Character Interview

Conduct dynamic conversations with your characters to discover their voice, mannerisms, and deeper psychological insights. This interactive tool helps you understand your characters as living beings rather than plot devices.

How It Works

Character Interview creates a conversation between you and your selected character, powered by AI that understands their psychology and context:

1. Go to Script → Characters, select a character, and switch to the "Interview" tab.
2. Choose from curated questions or ask your own
3. Have a real-time conversation with your character
4. Export the conversation for reference

Question Categories

Character Interview provides expertly crafted questions across four strategic categories:

• Warm-Up & Foundation: Establish comfort and immediate context ("What's on your mind right now?", "Describe the room you're in")
• Voice & Mannerisms: Discover how they speak and behave ("Tell me a story you've told a hundred times", "How do you order a drink?")
• Psychological Depth: Explore motivations and internal conflicts ("What do you believe you want more than anything?", "What's a small lie you tell yourself?")
• Story Possibilities: Generate plot potential ("What's your biggest secret?", "Who has the most power over you?")

Character Context Integration

The AI uses your character's defined attributes to create authentic responses:

• Character Profile: Role, archetype, description, and character arc
• Psychology: Flaw, want, need, lie they believe, and ghost (backstory trauma)
• Relationships: How they relate to other characters
• Story Context: Movie concept, themes, and current story situation

Key Features

• Dynamic Conversation: Real-time back-and-forth dialogue with your character
• Expert Questions: Curated by professional character development techniques
• Custom Questions: Ask anything specific to your story or character needs
• Conversation History: Full transcript maintained throughout your session
• Export Function: Save conversations as text files for later reference
• Persistent Sessions: Conversations automatically saved between sessions
• Markdown Processing: Character responses support rich formatting for emphasis and structure
• Context Awareness: Character responses consider conversation history and project context

Question Strategy and Purpose

Each question category serves specific character development goals:

• Warm-Up Questions: Establish the character's immediate state and environment, creating natural entry points into deeper topics
• Voice Questions: Reveal speech patterns, humor, social behavior, and how they adapt to different situations
• Psychology Questions: Uncover motivations, internal contradictions, self-awareness, and emotional patterns
• Story Questions: Explore secrets, power dynamics, fears, and potential plot catalysts

When to Use Character Interview

• Character Creation: Develop new characters beyond basic profiles
• Dialogue Writing: Discover authentic voice patterns and speech habits
• Character Development: Deepen existing characters with new insights
• Scene Planning: Understand how characters would react in specific situations
• Plot Development: Generate story ideas through character secrets and conflicts
• Character Consistency: Verify character reactions align with their psychology
• Writer's Block: Get unstuck by letting characters guide story direction

Best Practices

• Define Characters First: Use Script → Characters to create detailed character profiles before interviewing
• Start with Warm-Up: Begin conversations with foundation questions to establish context
• Follow Natural Flow: Let the conversation develop organically based on character responses
• Ask Follow-Up Questions: Dig deeper when characters reveal interesting details
• Challenge Characters: Don't accept surface answers - push for deeper truths
• Note Voice Patterns: Pay attention to how characters speak and express themselves
• Export Important Sessions: Save breakthrough conversations for future reference

Advanced Interview Techniques

• Situational Questions: Place characters in hypothetical scenarios to test reactions
• Relationship Queries: Ask about specific other characters to explore dynamics
• Time-Based Questions: Explore past events, future hopes, and present concerns
• Contradiction Challenges: Point out inconsistencies to discover deeper truths
• Emotional Pressure: Ask difficult questions that create emotional responses
• Value Testing: Present moral dilemmas to understand character principles

Story Integration Tips

• Voice Consistency: Use interview insights to maintain authentic dialogue throughout your script
• Backstory Details: Incorporate revealed backstory elements into scene context and character behavior
• Conflict Seeds: Transform discovered secrets and fears into plot complications
• Character Arcs: Use psychological insights to design meaningful character growth
• Relationship Dynamics: Apply character perspectives to improve interactions with other characters
• Subtext Creation: Use internal conflicts to add layers beneath surface dialogue

Example Interview Flow

A typical character interview might progress:

1. Foundation: "What's on your mind right now?" → Establishes current emotional state
2. Context: "Describe where you are" → Creates environmental grounding
3. Voice: "Tell me about your morning routine" → Reveals behavioral patterns
4. Depth: "What do you want more than anything?" → Uncovers core motivation
5. Challenge: "What's stopping you from getting it?" → Explores obstacles and fears
6. Story Potential: "What would you do if that obstacle disappeared tomorrow?" → Generates plot possibilities

Integration with Other Tools

Character Interview works seamlessly with NoosphereWriter's character development ecosystem:

• Characters System: Automatically loads character psychology and relationships
• Character Crucible: Use interview insights to create more targeted moral dilemmas
• Inner World Explorer: Complement psychological exploration with conversational discovery
• Movie Concept: Character responses consider genre expectations and story archetype
• Theme Structure: Align character insights with your story's thematic questions
• Screenwriting Coach: Use character voice discoveries in scene writing lessons

Technical Features

• Persistent Storage: Conversations automatically saved to browser local storage
• Session Management: Multiple interviews tracked separately per character
• Export Format: Clean text format with speaker labels for easy integration
• Markdown Support: Character responses can include emphasis, lists, and formatting
• Context History: AI maintains conversation context throughout entire session
• Error Recovery: Graceful handling of API failures with retry options

Character Debate

Simulate a debate between two characters to explore their conflict, voice, and differing perspectives. This tool helps you test how characters interact when their goals or beliefs clash.

How It Works

Character Debate creates a dialogue between two selected characters based on a specific topic or context:

1. Go to Script → Characters, check the selection boxes for exactly two characters, and click the "Start Debate" button.
2. Enter a topic, situation, or context for them to discuss
3. Click "Start Debate" to generate the initial dialogue
4. Click "Continue Debate" to extend the conversation

Key Features

• Dual Character Selection: Pit any two characters against each other
• Context-Aware Dialogue: Characters speak according to their defined profiles and the screenplay's context
• Topic-Based Generation: Focus the debate on specific themes, plot points, or conflicts
• Suggestion Chips: Quickly select common debate topics like "The ethics of the plan" or "A betrayal"
• Copy Functionality: Easily copy individual lines of dialogue to your clipboard

When to Use Character Debate

• Conflict Testing: See how characters handle disagreement
• Voice Differentiation: Ensure characters sound distinct from one another
• Scene Brainstorming: Generate ideas for argument scenes
• Relationship Exploration: Discover the dynamics between two specific characters

Name Database

Find the perfect name for your characters using a searchable database of over 200,000 names with rich metadata. Search by demographics, phonetics, archetypes, or use natural language descriptions with AI-assisted search.

How to Access

Go to Script → Characters and click "Add Character" (or edit an existing one) to access the Name Database.

Search Modes

The Name Database offers two powerful search modes:

Structured Search

Use specific filters to narrow down names by category:

• Gender: Filter by Female, Male, or Any
• Origin: Search by cultural or geographic origin (e.g., Greek, Celtic, Hebrew, African)
• Class Connotation: Names associated with different social classes (Aristocratic, Working Class, etc.)
• Phonetics Feel: How the name sounds (Soft, Hard, Lyrical, Harsh, Sibilant)
• Archetype: Character archetypes the name evokes (Hero, Sage, Rebel, etc.)
• Vibe: The overall feeling of the name (Elegant, Tough, Mystical, etc.)
• Syllable Count: Set minimum and maximum syllables

AI-Assisted Search

Describe your character in natural language and let AI find matching names:

• Enter descriptions like "A tough female detective with Eastern European roots"
• The AI interprets your description and searches the database
• If the database has no matches, AI generates appropriate names

Name Results

Each name result includes rich metadata to help you choose:

• Name: The character name
• Origin: Cultural or geographic origin
• Meaning: The traditional meaning of the name
• Gender Skew: Whether the name tends masculine, feminine, or neutral
• Class Connotation: Social class associations
• Archetype: Character archetypes evoked by the name
• Vibe: The overall feeling or impression
• Phonetics: Sound characteristics and syllable count
• Tags: Additional descriptive keywords

Using Results

Once you find a name you like:

• Copy to Clipboard: Click the copy icon to copy the name for use in your screenplay
• View Details: Expand names to see full metadata for informed choices
• Refine Search: Adjust filters and search again for more options

LLM Fallback

When the database doesn't have matching names for your search criteria:

• The AI automatically generates appropriate names matching your description
• Generated names include complete metadata (origin, meaning, archetype, etc.)
• This ensures you always get useful results, even for unusual requests

Best Practices

• Start Broad: Begin with fewer filters and refine as needed
• Consider Phonetics: Think about how names sound when spoken aloud
• Match Character Archetypes: Use the archetype filter to find names that fit your character's role
• Check Origin: Ensure the name's origin fits your story's setting and cultural context
• Use AI Search for Complex Requests: For nuanced requirements, describe your character to the AI

Database Coverage

The Name Database contains over 207,000 names with:

• 18,000+ distinct cultural origins
• Comprehensive phonetic analysis
• Character archetype associations
• Meaning and etymology information
• Social class connotations

Creative Consultant

Consult with film industry professionals about your screenplay. Get specialized expertise from 14 different roles across all production phases—from producers and screenwriters to cinematographers and VFX supervisors.

How It Works

Creative Consultant connects you with AI-powered industry experts who understand filmmaking from their specialized perspective:

1. Go to Tools → AI Coaching → Creative Consultant
2. Select a consultant role from the dropdown menu
3. Choose specific scenes to discuss (or consult on the entire screenplay)
4. Ask questions and receive expert guidance
5. Continue the conversation with follow-up questions
6. Export the consultation for reference

Available Consultant Roles

Creative Consultant provides access to 14 specialized industry professionals organized by production phase:

Pre-Production Consultants

• Producer: Budget management, financing strategies, distribution planning, risk management, and balancing creative vision with practical constraints
• Screenwriter: Story structure, character arcs, dialogue, visual storytelling, scene economy, genre conventions, and the rewriting process
• Director: Shot composition, visual metaphor, actor performance, blocking, tone and atmosphere, pacing, and translating script to screen

Production Consultants

• Actor: Character psychology, emotional preparation, subtext, physical characterization, scene objectives, and the difference between written text and performed reality
• Director of Photography: Lighting design, camera movement, color palette, visual motifs, lens choice, depth of field, and collaboration with production design
• Assistant Director: Production logistics, shooting schedules, location scouting, crew coordination, and managing on-set workflow
• Production Designer: Set design, color theory, period accuracy, visual motifs, practical vs. built sets, and how physical spaces tell stories
• Costume Designer: Character psychology through wardrobe, color symbolism, period research, costume evolution reflecting character arc, and practical considerations
• Makeup Artist: Character transformation, aging techniques, injury effects, continuity, and how makeup reveals character state
• Production Sound Mixer: On-set audio capture, dialogue recording, ambient sound, microphone placement, and production sound challenges

Post-Production Consultants

• Editor: Narrative assembly, pacing, rhythm, performance selection, scene transitions, and building emotional arcs through cutting
• Composer: Musical themes, emotional underscore, leitmotifs, instrumentation, and how music supports narrative without overpowering
• Sound Designer: Audio world-building, sound effects, Foley, ambient layers, sonic storytelling, and creating immersive soundscapes
• VFX Supervisor: Visual effects planning, practical vs. digital effects, green screen logistics, and integrating VFX into storytelling

Context-Aware Consultations

Each consultant has access to comprehensive project context, providing advice tailored to your specific screenplay:

• Screenplay Content: Selected scenes or full script for targeted or comprehensive consultations
• Characters: Character profiles, psychology (want, need, flaw, ghost, lie), archetypes, and relationships
• Locations: Location roster with types (interior/exterior), descriptions, and story significance
• Movie Concept: Genre, logline, themes, story archetype, and overall vision
• Theme Structure: Central argument, thematic questions, and narrative structure
• Production Design System: Visual themes, character styling, location design, and prop library (for relevant roles)

Role-Based Context Filtering

Each consultant receives information relevant to their expertise:

• All Roles: Screenplay scenes, characters, locations, movie concept, theme structure
• Design-Focused Roles: Production Designer, Costume Designer, Makeup Artist, Production Sound Mixer receive additional Production Breakdown data and Design System information
• Director of Photography: Receives character styling and location design for cinematography planning
• Other Roles: Receive screenplay and story-level context appropriate to their focus

Key Features

• 14 Specialized Roles: Consult with experts from every production phase
• Scene Selection: Focus consultations on specific scenes or discuss the entire screenplay
• Select All/Deselect All: Quickly include or exclude all scenes with one click
• Context Indicators: Visual badges show what project information is available to the consultant
• Conversation History: Full transcript maintained throughout your session
• Follow-Up Questions: Continue the conversation and dig deeper into specific topics
• Persistent Sessions: Consultations automatically saved between sessions per role
• Role Switching: Change consultants mid-session to get different perspectives
• Markdown Processing: Consultant responses support rich formatting for clarity and structure
• Export Function: Save consultations as text files for production notes and collaboration
• Clear Conversation: Start fresh consultations with confirmation protection

When to Use Creative Consultant

• Pre-Writing Planning: Consult with Producer about budget feasibility or Director about visual approach
• Script Development: Get Screenwriter feedback on structure, character arcs, or dialogue
• Scene-Specific Questions: Ask Director of Photography about lighting a night scene or Actor about character motivation
• Production Planning: Consult Assistant Director about scheduling or Production Designer about set requirements
• Technical Feasibility: Check with VFX Supervisor about effects complexity or Sound Designer about audio challenges
• Character Visualization: Work with Costume Designer and Makeup Artist on character appearance evolution
• Post-Production Vision: Discuss pacing with Editor or musical themes with Composer
• Multiple Perspectives: Get different viewpoints on the same scene from different roles
• Professional Development: Learn industry workflows and professional approaches to filmmaking

Best Practices

• Define Project Data First: Complete Script → Movie Concept, Characters, and Locations before consulting for richer context
• Use Scene Selection: Focus consultations on specific scenes for targeted advice
• Ask Specific Questions: "How should I light this interrogation scene?" works better than "Tell me about lighting"
• Consider the Role: Match your question to the consultant's expertise area
• Follow Up: Dig deeper when consultants provide interesting insights or suggestions
• Switch Perspectives: Ask multiple consultants about the same scene for holistic understanding
• Reference Context: Consultants can see your screenplay—reference specific lines, actions, or moments
• Save Important Sessions: Export breakthrough consultations for production notes
• Production Design Integration: Use Design System data (themes, styling, locations) for more detailed consultations with relevant roles

Example Consultation Flow

A typical consultation might progress:

1. Select Consultant: Choose "Director of Photography" from dropdown
2. Select Scenes: Choose the interrogation scene and warehouse confrontation
3. Initial Question: "How should I approach the lighting for the interrogation scene to create psychological pressure?"
4. Consultant Response: Detailed advice on harsh overhead practicals, eliminating fill light, creating shadow patterns
5. Follow-Up: "What about the transition to the warehouse? Should the lighting contrast or continue the harsh approach?"
6. Further Discussion: Continue refining visual approach based on consultant expertise
7. Export: Save consultation for director and DP collaboration

Applying Consultation Insights

• Screenplay Revisions: Incorporate structural or dialogue suggestions from Screenwriter consultations
• Production Notes: Add consultant insights as scene notes or production breakdown annotations
• Shot Lists: Use Director and DP advice to create detailed shot lists in Production menu
• Design Documents: Incorporate Production Designer, Costume Designer, and Makeup Artist suggestions into Design System
• Collaboration: Share exported consultations with actual crew members as starting points for discussion
• Budget Planning: Use Producer insights to create realistic budget expectations and contingency plans
• Schedule Planning: Apply Assistant Director logistics advice to shooting schedules

Integration with Other Tools

Creative Consultant works seamlessly with NoosphereWriter's production ecosystem:

• Movie Concept: Consultants consider genre, themes, and story archetype in their advice
• Theme Structure: Advice aligns with your thematic questions and central argument
• Characters System: Consultants understand character psychology, relationships, and arcs
• Locations System: Location context informs production planning and scene-specific advice
• Production Breakdown: Design-focused consultants access detailed breakdown data
• Design System: Visual themes, character styling, location design, and props inform consultant responses
• Scene Navigation: Select specific scenes from your screenplay for targeted consultations
• Character Tools: Complement Character Interview, Character Crucible, and Inner World Explorer with professional production perspectives

Technical Features

• Persistent Storage: Consultations automatically saved to browser local storage per role
• Role-Based Sessions: Each consultant maintains separate conversation history
• Scene Extraction: Automatic scene detection from screenplay for selection interface
• Export Format: Clean text format with consultant role labels and timestamps
• Markdown Support: Consultant responses include formatting, lists, emphasis for clarity
• Context Optimization: Intelligent context packaging based on consultant expertise
• Error Recovery: Graceful handling of API failures with clear error messages
• Design System Integration: Seamless loading of production design data from localStorage

Professional Use Cases

• Film Students: Learn industry workflows and professional perspectives from multiple departments
• Independent Filmmakers: Get expert advice when you can't afford to hire all these roles
• Screenwriters: Understand how different departments will interpret and execute your script
• Directors: Plan shots and collaborate with virtual department heads before hiring crew
• Producers: Evaluate production complexity and identify potential challenges early
• Film Educators: Teach students how different roles collaborate and think about scripts
• Development Executives: Assess scripts from multiple production perspectives

Character Introduction

Analyze how your characters are introduced to the audience, evaluating their first appearance for maximum impact and proper storytelling foundation using professional character introduction techniques.

How It Works

Character Introduction analyzes your character's first appearance in the screenplay against established character introduction best practices:

1. Go to Script → Story & Structure → Character Introduction
2. Select a character from your character roster
3. The tool identifies their first appearance in the screenplay
4. Click "Analyze Introduction"
5. Receive comprehensive analysis of introduction effectiveness
6. Get strategic recommendations for improvement
7. Export detailed analysis as PDF report

Character Introduction Checklist Framework

The analysis evaluates character introductions against a comprehensive professional checklist organized into five key categories:

• Core Goals & First Impressions: Timing, memorable impact, reader hook, and genre alignment
• Character Revelation: Core essence, revealing actions, flaw establishment, purposeful dialogue, environment reflection, and vulnerabilities
• Narrative and Plot Function: Plot advancement, conflict foreshadowing, and information balance
• Common Pitfalls to Avoid: Physical description lists, clichéd scenarios, info-dumping, name clarity, and character objectification
• Formatting and Clarity: Proper name formatting, age inclusion, and mystery identity handling

Professional Analysis Interface

The Character Introduction tool provides a comprehensive tabbed interface with four detailed analysis sections:

• Assessment Tab: Character information, first appearance details, strengths/weaknesses analysis, genre considerations, archetype analysis, and marketability notes
• Checklist Details Tab: All 21 individual checklist items organized by category with visual pass/fail indicators and detailed analysis for each criterion
• Recommendations Tab: Priority-based recommendations (High/Medium/Low) with specific action items and rationale for improvement
• Industry Insights Tab: Professional insights about genre expectations, archetype considerations, standards, and marketability factors

What You Get from Analysis

Each character introduction analysis provides:

• Overall Effectiveness Score: 0-100 rating with readiness level (amateur/developing/professional/exceptional)
• First Appearance Details: Scene location, page number, and introduction text
• Comprehensive Checklist Results: Pass/fail evaluation of 21 specific industry-standard criteria across five categories
• Detailed Item Analysis: In-depth explanation for each checklist item, including why it passed or failed
• Category Performance Summary: Pass rates and priority recommendations for each major checklist category
• Actionable Recommendations: Specific, prioritized steps to address failed checklist items
• Professional Context: How each checklist item relates to industry expectations and reader engagement
• Genre-Specific Guidance: Checklist evaluations tailored to your screenplay's genre requirements
• Industry Insights: Professional standards, archetype considerations, and commercial viability factors

Professional Checklist Categories

Character Introduction evaluates against industry-standard criteria organized into five strategic categories:

1. Core Goals & First Impressions: Ensures early introduction, memorable impact, reader engagement, and genre alignment
2. Character Revelation: Validates core essence communication, revealing actions, flaw establishment, and dialogue effectiveness
3. Narrative and Plot Function: Confirms plot advancement, conflict setup, and information/mystery balance
4. Common Pitfalls to Avoid: Identifies and prevents typical amateur mistakes like physical description lists and clichéd scenarios
5. Formatting and Clarity: Ensures proper screenplay formatting standards and character name clarity

Introduction Effectiveness Levels

• Exceptional (85-100): Industry-standard character introduction that immediately engages readers
• Professional (70-84): Solid introduction with clear character identity and engagement
• Developing (50-69): Basic introduction present but needs refinement for maximum impact
• Amateur (0-49): Introduction lacks essential elements and requires significant development

When to Use Character Introduction

• First Draft Review: Evaluate how effectively you've introduced key characters
• Character Development: Ensure character introductions match their story importance
• Revision Planning: Identify which character introductions need the most attention
• Professional Polish: Perfect character introductions before submissions
• Reader Engagement: Ensure characters make strong first impressions
• Story Structure: Verify character introductions support overall narrative flow

Pro Tips for Effective Character Introductions

• Start with Action: Show characters doing something that reveals personality
• Avoid Physical Descriptions: Focus on behavior and choices over appearance
• Create Immediate Stakes: Give characters something to want or fear in their first scene
• Use Contrast: Show gaps between how characters see themselves vs. reality
• Plant Story Seeds: Introduction moments should connect to character's larger arc
• Consider Reader Experience: First impressions matter for audience investment

AI-Powered Context Menu Assistant

For quick character introduction improvements while writing, Character Introduction is also available as a context-sensitive AI assistant:

How to Use the Context Menu

1. Right-click on any CHARACTER line in your screenplay
2. Hover over "Generation" in the context menu
3. Select "Character Introduction"
4. Receive immediate AI-generated character introduction alternatives
5. Click any suggestion to replace your current character line

Strategic Framework Integration

The context menu Character Introduction feature implements a comprehensive 5-step strategic framework for professional character introductions:

• Step 1 - Define Core Essence: AI identifies the character's defining personality trait, internal conflict (desire vs. fear), and most significant flaw
• Step 2 - Find Characteristic Moment: Creates dramatized scenarios that force the character to reveal their core essence through action
• Step 3 - Select Introduction Techniques: Layers multiple approaches including action (show don't tell), dialogue (impactful first lines), environment (character-defining settings), and reputation (others discussing them first)
• Step 4 - Decide on Pacing: Determines whether a high-impact entrance or slow burn reveal serves the story better
• Step 5 - Write with Precision: Focuses on concise, evocative language with selective physical details that imply deeper character truth

Context-Aware Suggestions

The AI context menu feature leverages your complete project setup for personalized recommendations:

• Movie Concept Integration: Considers your genre, themes, and story archetype
• Character Roster Analysis: Uses existing character profiles and relationships
• Theme Structure Alignment: Ensures introductions support your thematic premise
• Location Awareness: Incorporates your established settings and environments
• Plot Board Integration: Aligns with your story beats and structure

Professional-Quality Alternatives

Each context menu session generates 2-4 complete character introduction alternatives that:

• Implement professional character introduction best practices
• Are immediately usable as screenplay replacements
• Include analysis explaining the strategic approach taken
• Consider your specific story context and character development needs
• Apply the 5-step strategic framework for maximum impact

When to Use Context Menu vs. Full Tool

• Use Context Menu For: Quick improvements while writing, immediate alternatives, rapid iteration on character lines
• Use Full Tool For: Comprehensive analysis of existing introductions, detailed checklists, PDF reports, systematic evaluation of all characters

Integration with Other Tools

Character Introduction works seamlessly with NoosphereWriter's character development ecosystem:

• Characters System: Automatically analyzes characters from Script → Characters roster
• Character Crucible: Use introduction insights to design better moral dilemmas
• Character Interview: Discover voice and mannerisms to improve introduction dialogue
• Inner World Explorer: Align introduction analysis with psychological insights
• Movie Concept: Ensures character introductions support genre and story archetype
• Theme Structure: Aligns character introductions with thematic questions
• Screenwriting Coach: Provides character introduction lessons based on analysis

Export and Documentation

Character Introduction analysis can be exported as comprehensive PDF reports including:

• Executive Summary: Overall score, effectiveness level, and key recommendations
• Character Assessment: First appearance details, strengths, weaknesses, and professional insights
• Complete Checklist Results: All 21 checklist items with pass/fail status and detailed analysis
• Priority Recommendations: Categorized action items with priority levels and rationale
• Industry Context: Genre expectations, archetype analysis, and marketability factors
• Professional Formatting: Clean, professional layout suitable for development notes and collaboration

Insert Symbol

Add special characters and symbols to your screenplay.

Common Symbols

• © - Copyright symbol
• ® - Registered trademark
• ™ - Trademark
• … - Ellipsis
• — - Em dash
• – - En dash

Using Insert Symbol

1. Go to Tools → Insert Symbol
2. Browse categories or search
3. Click to insert at cursor position

Scene Lab

AI-powered scene rewriting tool that generates alternative versions of your scenes based on specific creative directions. Scene Lab helps you explore different possibilities for your story without losing your original work.

How to Access Scene Lab

1. Right-click on any Scene Heading line in your screenplay
2. Hover over "Generation" in the context menu
3. Select "Scene Lab"
4. The Scene Lab dialog opens with your scene content pre-loaded

Scene Lab Features

Creative Directions

Choose from preset directions or create your own:

• Make it Funnier: Enhances comedic elements and timing
• Increase Tension: Heightens conflict and stakes
• More Emotional: Deepens character feelings and reactions
• Show Don't Tell: Converts exposition into visual action
• Noir Style: Applies moody, atmospheric description and dialogue
• Custom: Type any specific instruction (e.g., "Write it like a Wes Anderson movie")

Working with Alternatives

• Generate: Create up to 3 different versions at once
• Compare: View original and new versions side-by-side
• Select: Choose the version you like best
• Replace: One-click replacement of your scene in the editor

Best Practices

• Use for scenes that feel flat or "off"
• Experiment with radically different tones to find new angles
• Combine elements from different generated versions
• Always review generated content for consistency with your story's voice

Dialogue Lab

AI-powered dialogue refinement tool that helps you polish character voices, improve subtext, and fix common dialogue issues.

How to Access Dialogue Lab

1. Right-click on any Character Name or Dialogue line
2. Hover over "Generation" in the context menu
3. Select "Dialogue Lab"

Dialogue Lab Functions

• Make Subtextual: Hides meaning beneath the surface
• Differentiate Voice: Makes the character sound more unique
• Shorten/Punch Up: Removes fluff and sharpens the lines
• Period/Genre Style: Adapts speech patterns to specific eras or genres

Using Dialogue Lab

1. Select the dialogue you want to improve
2. Choose a refinement option
3. Review the AI suggestions
4. Apply the best option to your script

Action Lab

AI-powered action line enhancer that transforms passive description into active, cinematic writing.

How to Access Action Lab

1. Right-click on any Action line
2. Hover over "Generation" in the context menu
3. Select "Action Lab"

Action Lab Capabilities

• Active Voice: Converts passive phrasing to active verbs
• Visual Impact: Enhances imagery and descriptive power
• Conciseness: Trims wordy descriptions
• Pacing: Adjusts sentence rhythm for better flow

Tips

• Use for "blocky" paragraphs of action
• Great for fight scenes or chase sequences
• Helps eliminate "we see" and "we hear" camera directions

Heighten Conflict

AI-powered conflict escalation tool that analyzes your scenes and provides professional storytelling techniques to increase tension, stakes, and dramatic engagement.

How to Access Heighten Conflict

1. Right-click on any Scene Heading line in your screenplay
2. Hover over "Generation" in the context menu
3. Select "Heighten Conflict"

Conflict Techniques

• Character Conflicting Goals: Ensure characters want mutually exclusive things
• Introduce Obstacles: Add external barriers or complications
• Raise the Stakes: Make consequences of failure explicit
• Add Time Pressure: Create deadlines
• Employ Subtext: Layer hidden agendas
• Dramatic Irony: Reveal info to audience that characters don't know

Using Suggestions

• Review the AI's analysis of your scene's current conflict
• Consider the suggested escalation strategies
• Apply techniques that fit your story's tone

Scene Rescue

AI-powered "Scene Doctor" that diagnoses stalled scenes by checking for the 4 essential dramatic beats and offering specific fixes to get the story moving again.

How to Access Scene Rescue

1. Right-click on any Scene Heading line in your screenplay
2. Hover over "Generation" in the context menu
3. Select "Scene Rescue"

The 4-Beat Diagnosis

Scene Rescue analyzes your scene against a rigid dramatic structure to identify exactly where the momentum is breaking:

• Disagreement: Is there an initial conflict, refusal, or opposing goal?
• Discussion: Do the characters argue, negotiate, or process this conflict?
• Decision: Does a character make a distinct choice or realization?
• Action: Does that decision lead to a physical action or new direction?

Suggested Fix

Based on the missing beat, the tool provides:

• Diagnosis: A concise explanation of why the scene feels stuck.
• Rationale: The reasoning behind the suggested fix.
• Content: A precise, Fountain-formatted screenplay snippet to insert into your script.

Using the Fix

• Copy Suggestion: Copies only the clean screenplay text to your clipboard.
• Enhance Scene: Automatically inserts the suggested content directly into your editor.

Suggest Scene Axe

AI-powered tool that generates "Axes" – physical objects, environmental features, or third parties – to externalize scene subtext and conflict.

How to Access Scene Axe

1. Right-click on any Scene Heading line in your screenplay
2. Hover over "Generation" in the context menu
3. Select "Suggest Scene Axe"

What is a Scene Axe?

A "Scene Axe" is a tangible element introduced into a scene that forces characters to deal with their underlying conflict physically rather than just verbally. It makes subtext visible.

Features

• Subtext Analysis: AI analyzes the scene to identify the core underlying tension.
• 3 Suggestion Types:
  • Prop: An object characters interact with (e.g., a loaded gun, a broken watch).
  • Environment: A feature of the setting (e.g., a leaking roof, sweltering heat).
  • Third Party: A minor character who interrupts or observes (e.g., a nosy waiter, a crying baby).
• Action Beats: Specific suggestions for how characters can interact with the Axe.

Using Suggestions

• Copy to Clipboard: Copy the suggestion text to use manually.
• Add Note: Insert the suggestion as a structured note directly into your scene for future reference.

Research

AI-powered research tool that provides factual information about selected text using Google Search grounding. Perfect for screenwriters who need quick background information on historical events, locations, terminology, or cultural references.

How to Access Research

1. Select any text in your screenplay (a word, name, place, or phrase)
2. Right-click to open the context menu
3. Hover over "Lookup"
4. Select "Research"

What You Get

The Research tool provides a concise, structured response:

• Summary: A 2-3 sentence factual overview
• Key Facts: Three bullet points with the most important information
• Context: Cultural or historical context relevant to screenwriting

Best Uses for Screenwriters

• Historical Accuracy: Verify dates, events, and period-specific details
• Location Research: Learn about cities, landmarks, or settings
• Cultural References: Understand cultural context for characters and dialogue
• Technical Terms: Get quick definitions for specialized vocabulary
• Real People: Quick background on historical figures you're referencing

Tips

• Use for quick fact-checking while writing, not deep research
• Results are grounded in Google Search for accuracy
• Great for verifying details mentioned in dialogue or action lines
• Pair with the Anachronism Detective tool for period pieces

Title Page

Create a professional title page for your screenplay with all required information.

Title Page Elements

• Title: Your screenplay's title
• Author: "Written by" credit
• Based on: Source material credit (if applicable)
• Contact: Your contact information
• Draft Date: Current draft date
• Copyright: Copyright notice

Formatting

The title page is automatically formatted according to industry standards:

• Title centered and in caps
• Credits properly spaced
• Contact info in bottom left or right

Movie Concept

Define and organize the core creative elements of your screenplay project using our comprehensive 4-tab system.

Core Concept Tab

Establish the fundamental elements of your story:

• Movie Idea: Describe your core movie concept in a few sentences
• Genres: Select primary and secondary genres from our comprehensive list
• Protagonist + Goal + Obstacle: Break down your concept into the three essential story building blocks
• Logline: One-to-two sentence summary of your movie's plot
• AI Enhancement: Use AI expansion buttons to generate professional suggestions for each element

Analyze Premise Feature

The Analyze Premise tool acts as a "Ruthless Hollywood Script Doctor," validating your core concept against 7 key questions to ensure structural integrity and marketability.

• Diagnostic Report: Provides an overall Health Score (High/Medium/Low) and pass/fail/warning status for each key question.
• 7 Key Questions: analyzes clarity, stakes, conflict, originality, theme, structural integrity, and emotional connection.
• Actionable Feedback: Offers specific, constructive "Fix" suggestions for any identified weaknesses.
• Workflow:
  1. Fill in the **Protagonist + Goal + Obstacle** and **Logline** fields.
  2. Click the **Analyze Premise** button.
  3. Review the report and use the suggestions to refine your concept.

Story Structure Tab

Define your screenplay's structural framework:

• Story Archetype: Choose from 22 proven story patterns (Hero's Journey, Buddy Love, etc.)
• Compatibility Feedback: Get real-time suggestions for genre-archetype combinations
• Detailed Information: Each archetype includes descriptions, key characteristics, and examples

Stakes Tab

Define what's at risk - what characters and audiences have to lose if the protagonist fails:

• Custom Stakes Input: Add your own stakes descriptions
• 8 Predefined Categories: Choose from common types of stakes:
  • Life itself (humanity's survival to individual lives)
  • Justice (for crimes and prevention of future crimes)
  • Freedom (escape from terrible situations)
  • Family/Way of Life (protecting what one holds dear)
  • Love/Partnership (finding happiness with ideal partner)
  • Professional Future (deserved career advancement)
  • Life-Changing Prize (achievement that transforms identity)
  • Happiness (chance at decent life being threatened)
• Interactive Selection: Click any category to add it, or use the input field for custom stakes
• Multiple Stakes: Add up to 10 different stakes for complex, multi-layered stories
• AI Stakes Generation: Generate compelling stakes scenarios based on your movie concept
• Examples & Tooltips: Each category includes detailed descriptions and movie examples

Themes Tab

Explore the deeper meanings and universal truths your story examines:

• Custom Themes: Add themes like "redemption," "family bonds," or "justice"
• AI Theme Generation: Generate meaningful themes based on your movie concept and context
• Theme Management: Add, remove, and organize multiple themes with badge-style interface
• Integration: Themes integrate with other NoosphereWriter features like Theme Structure

Idea Generation Tools

The Movie Concept dialog acts as a central hub for ideation, incorporating powerful tools to spark your creativity:

Brainstorming & Public Domain

Generate fresh concepts using 15 unique techniques or adapt classic public domain stories. Features include:

• 15 Creative Techniques: Explore methods like "What If", "X Meets Y", "Irony", and "Genre Blending" to create original concepts.
• Public Domain Adaptation: Select from over 30 classic stories (e.g., Dracula, Sherlock Holmes) and apply 9 adaptation strategies to create modern retellings.
• Random Inspiration: Use the "Random" technique to combine unexpected elements and genres.

Idea Lab

An interactive mixing canvas that lets you combine specific ingredients to generate unique concepts:

• Ingredients: Mix Characters, Locations, Themes, and Situations.
• The Engine: Drag ingredients into slots and choose a generation mode (Combine, What If, Hangover Test).
• Custom Instructions: Guide the AI with specific tone or constraint requests.

AI-Powered Features

Each tab includes AI enhancement capabilities:

• Context-Aware Suggestions: AI considers all your existing concept elements for relevant recommendations
• Professional Quality: Generate industry-standard loglines, stakes, and thematic elements
• Iterative Refinement: Generate multiple variations and select the best options
• Integration: AI suggestions work seamlessly with your existing concept data

Best Practices

• Start with Movie Idea: A clear concept helps AI generate better suggestions for other elements
• Define Stakes Early: Strong stakes create emotional investment and drive story tension
• Layer Multiple Stakes: Complex stories often put multiple things at risk simultaneously
• Test Compatibility: Use the archetype feedback to ensure your genre and structure work well together
• Iterate with AI: Don't settle for first suggestions - generate multiple options and combine the best elements

Theme Structure

Develop your screenplay's thematic framework using Craig Mazin's proven methodology.

The Seven Pillars

1. Central Dramatic Argument: The question your story asks
2. Thematic Statement: Your answer to that question
3. Protagonist's Journey: How they embody the theme
4. Antagonist's Role: How they challenge the theme
5. Supporting Characters: Different perspectives on theme
6. Key Scenes: Moments that explore theme
7. Resolution: How theme is ultimately expressed

Character-Theme Integration

Link each character to your theme:

• What does each character believe?
• How do their beliefs conflict?
• How do they change?
• What truth do they discover?

Characters

Manage your screenplay's character roster with detailed profiles and tracking.

Character Profiles

NoosphereWriter provides a comprehensive character development system with 20+ professional character attributes organized into logical phases:

Basic Information

• Name: Character's full name
• Age: Approximate age or range
• Sex/Gender: Character's gender identity
• Role: Protagonist, Antagonist, Supporting
• Archetype: Character's archetypal pattern
• Character Arc: How they transform throughout the story
• Relationships: Connections to other characters
• Description: Detailed personality, background, and physical traits

Core Psychology

• Character Flaw: Internal weakness that creates conflict
• Character Want: What they consciously desire (external goal)
• Character Need: What they actually need for growth (internal goal)
• Character Lie: False belief that holds them back
• Character Ghost: Past trauma, guilt, or unresolved issue
• How Character Sees Themselves: Their self-perception and self-image
• How Others See Them: External perception, often different from self-image

Tactics & Behavior

• Character's Tactics: Methods, strategies, or behaviors used to get what they want
• Behavior Under Pressure: How they react when stressed, afraid, or failing
• Emotional Triggers: Present-day situations that cause disproportionate reactions

Perception Gap

• Defining Contradiction: Memorable contradiction that makes them unique and complex
• Odd Habit: Distinctive quirk or repeated behavior that reveals personality
• Reason for Habit: Origin or psychological reason behind their odd habit
• Meaningful Possessions: Objects they always carry that reveal personality and history
• Symbolic Meaning: Deeper significance of their meaningful possessions
• Counterintuitive Reaction: Surprising responses to extreme stress or danger
• Uncertain Future: How hopes and fears for the future affect present decisions
• Foil (Antagonist): Who represents their inverted version or dark mirror
• Foil (Companion): Who provides qualities they lack as supportive counterpart
• Foil (Mentor): Who shows their potential future as guide or example

Introduction Blueprint

• Opening Line: First memorable dialogue that reveals character and creates impression
• Opening Action: First physical action or behavior that immediately reveals who they are
• Immediate Problem: First conflict that creates dramatic tension and hooks the audience

Character Development Best Practices

NoosphereWriter's phased approach to character development ensures comprehensive character creation:

Phase 1: Tactics & Behavior

Start with how your character acts in the world:

• Tactics: Do they use manipulation, brute force, charm, intellectual superiority, or avoidance? This reveals their true nature.
• Behavior Under Pressure: How they fail, fear responses, and power dynamics reveal character beneath the facade.
• Emotional Triggers: Specific sounds, smells, situations that trigger disproportionate reactions due to their Ghost.

Phase 2: Perception Gap

Develop the contradictions and complexities that make characters memorable:

• Defining Contradiction: Example: A ruthless hitman who enjoys crocheting, or a shy person bold when helping others.
• Odd Habit + Reason: Connect habitual behaviors to their psychological history and Ghost.
• Possessions + Meaning: What they carry reveals personality (worn philosophy book, single bullet, photo of lost loved one).
• Counterintuitive Reaction: Laughing in danger, becoming calm in crisis, focusing on mundane details during tragedy.
• Foil Characters: Define opposing (Antagonist), complementary (Companion), and aspirational (Mentor) versions.

Phase 3: Introduction Blueprint

Plan how to introduce your character memorably:

• Opening Line: Should reveal personality, status, or conflict. Consider how it introduces who they are.
• Opening Action: Physical behavior that immediately shows character and motivations.
• Immediate Problem: First conflict should connect to larger story arc and reveal problem-solving approach.

Integration Tips

• Build Progressively: Start with basic psychology (want, need, flaw, ghost) before adding advanced details
• Connect to Story: Ensure character development serves your movie concept and theme structure
• Use AI Tools: Leverage Character Crucible, Character Interview, and Relationship Illumination for deeper insights
• Test Consistency: Use Continuity Check to verify character behavior remains consistent throughout

AI Character Generation

Generate complete character casts based on your story:

1. Define your genre and premise
2. Click "Generate Cast with AI"
3. Review and customize generated characters
4. AI considers archetypal roles and story needs

Import from Script

Automatically extract and import all character names from your current screenplay:

1. Open the Characters dialog (Script → Characters)
2. Click the "Import from Script" button
3. Review the imported character list
4. Enhance each character with detailed profiles

How It Works

The Import from Script feature intelligently scans your screenplay and:

• Extracts Character Names: Finds all CHARACTER elements in your screenplay
• Normalizes Names: Removes variations like (V.O.), (CONT'D), and (O.S.)
• Prevents Duplicates: Automatically skips characters that already exist
• Assigns Basic Roles: Sets initial roles (Protagonist/Supporting) based on appearance order
• Creates Profiles: Generates basic character entries ready for enhancement

Import Results

After importing, you'll see helpful feedback:

• First Import: "Successfully added X characters."
• Partial Duplicates: "Successfully added X characters. Skipped Y duplicates."
• All Duplicates: "All X characters already exist in your project."
• No Characters: "No character names found in the current screenplay."

Best Practices

• Import Early: Use this feature after completing your first draft to quickly build your character roster
• Review and Enhance: Imported characters have basic information - add detailed profiles using the form fields
• Check for Variations: Verify that character name variations (like "DOCTOR" vs "DR. SMITH") are handled correctly
• Reimport Safely: You can re-import at any time - duplicates are automatically skipped
• Combine with AI: Use both Import from Script and AI Character Generation for comprehensive character development

Pro Tips

• Format Characters Properly: Ensure your screenplay uses proper CHARACTER formatting for best detection
• Review Minor Characters: Decide which imported characters need full profiles vs. basic tracking
• Update Roles: Adjust the automatically assigned roles (Protagonist/Supporting) to match your story structure
• Use with Other Tools: Imported characters work seamlessly with Character Crucible, Character Interview, and other AI tools

Smart Character Rename

Intelligently rename characters across your entire screenplay while preserving formatting and industry conventions.

How It Works

1. Open Script → Characters
2. Select a character to edit
3. Change the character's Name field
4. Click "Save"
5. If the name has changed, you'll be prompted to confirm the Smart Rename

Intelligent Context Handling

The Smart Rename feature uses advanced heuristics to ensure changes adhere to screenwriting rules:

• Action Lines: Automatically converts the name to Title Case for standard action descriptions (e.g., "SUSAN walks" becomes "Mary walks"), while preserving ALL CAPS for introductions (e.g., "SUSAN (30)" becomes "MARY (30)").
• Dialogue Formatting: Preserves emphasis and casing within dialogue text:
  • Normal speech: "Hello Janice" → "Hello Mary"
  • Shouting/Emphasis: "Look out JANICE!" → "Look out MARY!"
• Character Cues: Updates character names above dialogue blocks.

Safety Features

• Confirmation Dialog: You are always asked to confirm before any script-wide changes are applied.
• Transaction-Based: Changes are applied as a single transaction, allowing for clean Undo if needed.

Illuminate Character Facets (Theory of Illumination)

Analyze how different relationships reveal different aspects of your character's personality using AI-powered relationship analysis:

1. In the character form, describe your character's relationships
2. Click the AI "Illuminate Character Facets" button next to the Relationships field
3. AI analyzes how each relationship reveals different character aspects
4. Receive insights on character facets, psychological dynamics, and story function

What You Get from Relationship Illumination

For each relationship, the AI provides:

• Character Facet Revealed: What aspect of personality this relationship brings out
• Evidence in Interaction: How this facet manifests in their dynamic
• Psychological Insight: Deeper understanding of the character's inner world
• Contrast with Other Relationships: How this differs from other dynamics
• Story Function: How this relationship serves the character's arc

Theory of Illumination Principles

This feature is based on the storytelling principle that characters reveal different facets of themselves depending on who they're with:

• Different people trigger different emotional responses
• Power dynamics influence which character traits emerge
• The same character can appear confident with one person and vulnerable with another
• Relationships serve as mirrors, reflecting different aspects of character truth

Best Practices for Relationship Illumination

• Detailed Relationship Descriptions: Provide specific dynamics rather than generic descriptions
• Character Psychology First: Complete character flaw, want, need, lie, and ghost for richer analysis
• Multiple Relationship Types: Include family, professional, romantic, and adversarial relationships
• Story Context: Define movie concept and theme structure for genre-appropriate insights
• Use for Scene Writing: Apply insights to show character complexity in different interactions

Character Tracking

• Auto-complete character names while writing
• Track dialogue count per character
• Ensure consistent character voices
• Generate character reports

Locations

Track and manage all locations in your screenplay for production planning.

Location Details

For each location, specify:

• Name: Location identifier
• Type: Interior, Exterior, or Interior/Exterior
• Description: Visual details and setting information
• Address: Physical location or studio address
• Notes: Production notes and requirements
• Atmosphere: Mood and tone of the location
• Props: Required props and set dressing
• Budget: Estimated costs for location usage
• Availability: Shooting windows and restrictions

Import from Script

Automatically extract locations directly from your screenplay's scene headings. This powerful feature saves time and ensures consistency by parsing your existing script content.

Smart Scene Heading Analysis

The import feature intelligently analyzes your scene headings to extract:

• Location Names: Parses location identifiers from scene headings
• Interior/Exterior Types: Automatically detects INT., EXT., I/E., and combination formats
• Compound Locations: Handles complex locations like "HIGH SCHOOL - CHEMISTRY LAB"
• Time-of-Day Filtering: Excludes time markers (DAY, NIGHT, CONTINUOUS, LATER) from location names
• Duplicate Detection: Identifies unique locations while preserving different type variations

Supported Scene Heading Formats

The import feature recognizes industry-standard scene heading patterns:

• Standard Format: "INT. COFFEE SHOP - DAY"
• Exterior Format: "EXT. CITY STREET - NIGHT"
• Combined Format: "INT./EXT. CAR - MOVING - DAY"
• Abbreviated Format: "I/E. SPACESHIP - CONTINUOUS"
• Compound Locations: "INT. MUSEUM - RENAISSANCE WING - DAY"
• Vehicle Scenes: "INT. TAXI - MOVING - NIGHT"

Import Benefits

• Time Savings: Instantly populate your location list from existing script content
• Consistency: Ensures location names match exactly what's in your scene headings
• Type Detection: Automatically assigns Interior, Exterior, or Interior/Exterior types
• Duplicate Prevention: Avoids creating duplicate locations while handling type variations
• Production Ready: Creates location entries ready for production planning

Manual Location Management

Add locations manually when needed:

• Click "Add Location" to create new entries
• Edit existing locations by clicking the edit icon
• Delete locations that are no longer used
• Organize locations by type and usage frequency

World-Building Integration

Each location has access to the World-Building feature for generating rich research dossiers:

• Click the World-Building button when adding or editing a location
• Generate sensory details, jargon, daily rhythms, tools, conflict points, and hidden details
• Results automatically populate into the location's Atmosphere, Props, Description, and Notes fields
• Movie Concept and Character data provide additional context for relevant results

AI Location Analysis

The AI assistant can:

• Extract all locations from your script automatically
• Suggest detailed location descriptions
• Identify special production requirements
• Group similar or related locations
• Recommend atmosphere and mood settings
• Suggest props and set dressing requirements

Location Reports

Generate comprehensive location breakdowns showing:

• Complete location inventory with descriptions
• Scene count and page count per location
• Interior/Exterior/Both categorization
• Day/Night distribution analysis
• Production requirements summary
• Budget estimates and availability windows

Production Integration

Your location data integrates seamlessly with:

• Location Reports: Detailed breakdowns for production planning
• Scene Reports: Location context for each scene
• Script Reports: Complete location usage statistics

Best Practices

• Import Early: Use the import feature after writing your first draft to establish your location baseline
• Review and Enhance: After importing, add descriptions, addresses, and production notes
• Maintain Consistency: Keep location names in your script consistent with your location manager
• Update Regularly: Re-import when you add new scenes or locations to your script
• Use Both Modes: Use "Add New" during development and "Replace All" for major script revisions

Tools → Convert Screenplay

The Convert Screenplay feature allows you to rewrite your entire script (or specific sections) using advanced AI, applying new genres, themes, and visual styles while maintaining your core story structure.

Core Directives

Customize how the AI reimagines your script using specific directives:

• Target Genre: Shift the tone to a specific genre (e.g., "Film Noir", "Cyberpunk", "Romantic Comedy").
• Target Audience: Tailor the content for a specific demographic (e.g., "Young Adult", "General Audience").
• Core Theme: Infuse a central message or thematic element throughout the narrative (e.g., "Redemption", "Isolation").
• Visual Style: Define the cinematographic feel (e.g., "Wes Anderson-esque", "Gritty Realism").

Rewrite Rules

Add specific instructions for the AI to follow during the conversion process:

• "Make dialogue more subtextual"
• "Increase the pacing of action sequences"
• "Focus on sensory details"

Writing Styles

Choose the formatting style for the output:

• Match Screenplay: Preserves standard screenplay formatting.
• Vertical Writing: A specialized style that prioritizes pacing and visual clarity. Action lines are broken down into single visual beats, and character names are never orphaned from their actions. This style is ideal for fast-paced, visually driven narratives.

Check Formatting

Validate your screenplay's format compliance with industry standards.

What It Checks

• Empty elements or parentheticals with only "()"
• Character elements not followed by parenthetical or dialogue
• Parenthetical elements not following character or dialogue
• Dialogue elements not following character or parenthetical
• Incorrect element types (e.g., character names in wrong format)
• Proper element formatting and industry standards compliance

Smart Dialog Detection

The format checker includes intelligent dialogue continuation detection that can identify when dialogue appears to be split across multiple elements. When it detects this pattern, it will:

• Recommend combining dialogue logs instead of generic fixes
• Recognize emotional words, reactions, and continuation patterns
• Provide a "Combine with Previous Dialogue" button for easy fixing
• Still offer traditional options like "Change to Action" as alternatives

Using Format Check

1. Go to Tools → Check Formatting
2. Issues are highlighted in your script
3. Click "Next Error" to navigate between issues
4. Fix issues or dismiss if intentional

Common Issues

• Orphaned Dialogue: Character name at bottom of page
• Split Parenthetical: Parenthetical broken across pages
• Bad Scene Heading: Incorrect INT./EXT. format

Character Introduction (Script Menu)

Quickly analyze and improve how your characters are introduced in the screenplay. This Script menu version provides fast character introduction analysis.

How to Use

1. Go to Script → Story & Structure → Character Introduction
2. Select a character from your roster
3. View the analysis of their first appearance
4. Get recommendations for improvement

Note: For comprehensive character introduction analysis with detailed checklists, PDF export, and context menu generation, see Character Introduction in Tools menu.

Page One Checklist

Professional evaluation tool that assesses your screenplay's opening page(s) against 11 essential principles derived from industry best practices. This analysis helps ensure your opening makes an immediate impact and demonstrates professional-level craft.

How It Works

Page One Checklist evaluates your screenplay's first 1-3 pages against 11 critical principles that separate professional openings from amateur attempts:

1. Go to Script → Story & Structure → Page One Checklist
2. The tool automatically extracts your first 1-3 pages (up to 20,000 characters)
3. Click "Analyze Opening Pages"
4. Receive comprehensive principle-by-principle evaluation
5. Review pass/fail assessment for each of the 11 principles
6. Export detailed analysis as PDF report

The 11 Essential Principles

The checklist evaluates your opening against these fundamental principles:

1. Jump Right In

Begin at the last possible moment before everything changes.

• What It Means: Start your story at the moment of maximum dramatic potential, not minutes, hours, or days before
• Why It Matters: Readers have limited patience; every second counts in the opening
• Professional Example: Breaking Bad - Man in underwear driving RV frantically through desert
• Amateur Mistake: Opening with character waking up, commuting, or going through morning routine

2. Create a Killer Opening Image

Establish a memorable, thematically relevant visual that hooks the reader immediately.

• What It Means: Your first image should be cinematically striking and thematically significant
• Why It Matters: The opening image is your first impression and sets the visual tone
• Professional Example: American Beauty - Rose petals falling in slow motion
• Amateur Mistake: Generic establishing shots that could belong to any story

3. Show, Don't Tell - Who, What, Where

Establish fundamental story information through action and visual storytelling, not exposition.

• What It Means: Reader should understand protagonist, their world, and the situation through behavior and context
• Why It Matters: Cinematic storytelling reveals character through action, not description
• Professional Example: The Social Network - Rapid-fire dialogue reveals character intelligence and social awkwardness simultaneously
• Amateur Mistake: Character descriptions that read like résumés or lengthy exposition blocks

4. Introduce a Compelling Protagonist

Present a main character who is interesting, active, and worth following for 2 hours.

• What It Means: Your protagonist must be introduced with distinctive behavior, voice, or circumstances
• Why It Matters: Readers decide within pages whether they care about the protagonist
• Professional Example: The Devil Wears Prada - Andy's idealism and naivety established through her first interaction with Miranda's world
• Amateur Mistake: Generic "everyman" characters with no distinctive traits or personality

5. Establish Tone Immediately

Make clear from page one whether this is comedy, drama, thriller, or hybrid genre.

• What It Means: Writing style, pacing, and content should signal genre and tone from the first paragraph
• Why It Matters: Tonal confusion breaks reader trust and creates false expectations
• Professional Example: Deadpool - Fourth-wall-breaking narration establishes irreverent comedy tone instantly
• Amateur Mistake: Opening that feels like a different genre than the actual story

6. Promise the Genre and Deliver

Opening must contain the DNA of your genre and suggest what kind of story this will be.

• What It Means: Genre conventions should be present or cleverly subverted from the start
• Why It Matters: Genre promises set reader expectations that the entire script must fulfill
• Professional Example: Get Out - Opening abduction immediately establishes horror/thriller genre despite seemingly normal setup
• Amateur Mistake: Generic opening that could belong to any genre, revealing nothing about story type

7. Create Immediate Questions

Raise compelling mysteries or questions that demand answers and pull reader forward.

• What It Means: Opening should create dramatic questions that can only be answered by continuing
• Why It Matters: Curiosity is the engine that keeps readers turning pages
• Professional Example: Memento - Man with no short-term memory hunting someone raises immediate questions about both past and present
• Amateur Mistake: Opening that answers all questions or raises none

8. Demonstrate Professional Craft

Show mastery of screenplay format, structure, pacing, and visual storytelling technique.

• What It Means: Writing should demonstrate knowledge of professional screenplay conventions and craft
• Why It Matters: Amateur formatting, style, or structure signals inexperience instantly
• Professional Example: Crisp action lines, economical description, proper scene headings, active voice throughout
• Amateur Mistake: Camera directions, excessive description, passive voice, incorrect formatting

9. Avoid Common Opening Mistakes

Steer clear of clichéd openings that instantly signal amateur writing.

• What It Means: Avoid alarm clocks, dream sequences, voiceover exposition, mundane routines
• Why It Matters: Common opening mistakes trigger instant "pass" responses from industry readers
• Professional Example: Openings that feel fresh and original while still establishing necessary information
• Amateur Mistake: "Character wakes up to alarm clock" or "It was all a dream" openings

10. Make Every Line Count

Each word, sentence, and paragraph must earn its place through purpose and impact.

• What It Means: No filler, no wasted space, no self-indulgent description
• Why It Matters: Readers evaluate efficiency and craft through economy of language
• Professional Example: The Social Network screenplay - Every line of dialogue serves multiple purposes simultaneously
• Amateur Mistake: Purple prose, redundant description, or over-explaining visual elements

11. Create a Sense of Urgency

Establish forward momentum and make reader feel compelled to keep reading immediately.

• What It Means: Opening should create pressure, tension, or momentum that demands continuation
• Why It Matters: Without urgency, reader has no reason to keep turning pages
• Professional Example: Gravity - Opening space disaster creates immediate life-or-death urgency
• Amateur Mistake: Leisurely, meandering openings with no forward drive or pressure

Analysis Interface

The Page One Checklist tool provides a comprehensive tabbed interface with actionable insights:

Summary Tab

• Overall Assessment: Professional evaluation of opening quality
• Score: X out of 11 principles passed
• Key Strengths: What's working well in your opening
• Priority Improvements: Most important areas to address
• Quick Overview: At-a-glance understanding of opening effectiveness

Checklist Tab

• All 11 Principles: Complete checklist with pass/fail indicators
• Detailed Evaluation: Specific analysis of how your opening addresses each principle
• Pass/Fail Status: Clear indicators showing which principles need work
• Principle Descriptions: Quick reference for what each principle means
• Professional Context: Understanding why each principle matters

Strengths Tab

• What's Working: Detailed breakdown of effective elements in your opening
• Passed Principles: Which checklist items your opening successfully addresses
• Strong Points: Specific examples of professional-level execution
• Build on Success: How to leverage your strengths throughout the screenplay

Recommendations Tab

• Priority Actions: Most important improvements to make first
• Failed Principles: Which checklist items need addressing
• Specific Guidance: Concrete suggestions for strengthening your opening
• Implementation Strategies: How to apply recommendations without losing what works
• Next Steps: Clear action plan for revision

When to Use Page One Checklist

• First Draft Completion: Evaluate if your opening meets professional standards
• Before Cliché Opening Analysis: Get foundational assessment before deeper diagnostic
• Revision Planning: Identify which principles need the most attention
• Pre-Submission: Ensure opening demonstrates professional craft before sending to industry
• Contest Preparation: Verify opening addresses all essential principles
• Query Package Prep: Polish first pages to professional standard
• Rewrite Strategy: Determine whether opening needs tweaking or complete overhaul

Professional Context

Why page one matters: Industry professionals make initial judgments about a screenplay's quality within the first page. The opening must simultaneously:

• Demonstrate professional writing craft
• Establish genre and tone clearly
• Introduce a compelling protagonist
• Create immediate engagement and curiosity
• Promise the kind of story that follows
• Avoid amateur mistakes and clichés

The page one reality: While the entire screenplay matters, most industry readers form their initial impression in the first 60 seconds of reading. A weak page one doesn't necessarily mean rejection, but it creates an uphill battle for the rest of the script. A strong page one creates positive momentum and reader goodwill.

Key Diagnostic Principles

• First Impressions Are Permanent: Your opening is the only chance to make a first impression
• Every Element Matters: Format, word choice, pacing, and content all signal professionalism
• Genre Promises Must Be Kept: Opening establishes a contract with reader that entire script must honor
• Active Over Passive: Opening should demonstrate active storytelling, not passive description
• Visual Thinking: Screenplay openings must think cinematically, not literarily
• Economy is Craft: Professional writing uses minimum words for maximum impact
• Urgency Creates Engagement: Forward momentum is essential from line one

Integration with Other Tools

Page One Checklist works seamlessly with other NoosphereWriter features:

• Cliché Opening: Use Page One Checklist for foundational assessment, then Cliché Opening for detailed diagnostic
• First 10 Pages: Page One establishes foundation that First 10 Pages builds upon
• Character Introduction: Verify protagonist introduction meets checklist standards
• Readability: Ensure page one reads smoothly and professionally
• Common Flaws: Broader screenplay issues that may start on page one
• Pacing Heat-Map: Visual representation of opening momentum

Export and Documentation

Export your Page One Checklist analysis as a professional PDF report including:

• Executive Summary: Overall assessment, score, and key findings
• Complete Checklist: All 11 principles with pass/fail status
• Detailed Evaluation: Specific analysis for each principle
• Strengths Analysis: What's working well in your opening
• Priority Recommendations: Actionable improvement plan
• Professional Formatting: Clean layout suitable for development notes

Smart Caching

The analysis includes intelligent caching to improve performance:

• Content-Based Caching: Re-analyzes only when first pages actually change
• Instant Results: Cached analyses display immediately on reopening
• Automatic Invalidation: Cache clears when screenplay content changes
• Session Persistence: Results persist across dialog open/close cycles

Common Questions

• "Do I need to pass all 11 principles?" - Not necessarily, but each failed principle represents a weakness. Professional openings typically pass 9-11 principles.
• "What if famous scripts fail some principles?" - They may, but established writers have more creative freedom. Emerging writers need to demonstrate mastery before breaking rules.
• "Should I fix everything at once?" - No, prioritize the most critical failures first, typically: compelling protagonist, tone establishment, and avoiding common mistakes.
• "How many pages does this analyze?" - First 1-3 pages (up to 20,000 characters), as page one principles apply to the immediate opening.

Workflow Recommendation

Optimal revision sequence for opening pages:

1. Page One Checklist: Foundational assessment of essential principles
2. Cliché Opening Analysis: Identify and eliminate trust-breaking choices
3. Readability: Ensure smooth, professional writing style
4. Character Introduction: Verify compelling character first appearances
5. First 10 Pages Analysis: Comprehensive evaluation of overall opening quality
6. Pacing Heat-Map: Fine-tune rhythm and momentum
7. Final Polish: Line-by-line refinement of language and clarity

This sequence ensures you're building on a solid foundation and addressing issues in order of importance.

Cliché Opening Analysis

Professional diagnostic tool that identifies cliché openings and trust-breaking choices in your screenplay's first 10 pages. Based on comprehensive industry diagnostic notes, this analysis helps you avoid common opening mistakes that instantly signal amateur writing.

How It Works

Cliché Opening Analysis evaluates your screenplay against professional diagnostic criteria covering four critical categories:

1. Go to Script → Story & Structure → Cliché Opening
2. The tool automatically extracts your first 10 pages
3. Click "Analyze for Clichés"
4. Receive comprehensive diagnostic evaluation
5. Review detected clichés with severity ratings and page locations
6. Export detailed analysis as PDF report

Four Diagnostic Categories

The analysis identifies issues across four major categories based on professional diagnostic frameworks:

1. Foundational Failures (Trust-Breakers)

Critical issues that immediately break reader trust and signal amateur writing:

• Dream Sequences: Opening with "it was all a dream" wastes emotional investment
• Alarm Clock Openings: Character waking up is the most overused opening in amateur scripts
• Prophecy/Voiceover: Telling instead of showing undermines cinematic storytelling
• Flashback Openings: Starting in past tense confuses chronology and momentum
• Freeze-Frame Narration: "You're probably wondering how I got here" is overdone
• News Report Exposition: Using TV/radio to deliver backstory is lazy storytelling

2. Sins of Stasis (Boring Openings)

Passive openings that fail to create forward momentum:

• Establishing Shots Only: Empty cinematography without character or conflict
• Normal Day Routines: Mundane daily activities without dramatic purpose
• Passive Protagonist: Main character observing instead of acting
• Delayed Inciting Incident: Waiting too long to introduce story conflict
• Atmosphere Over Story: Prioritizing mood at the expense of narrative drive

3. Sins of Clumsiness (Craft Issues)

Technical execution problems that reveal lack of professional polish:

• Over-Description: Excessive visual detail that slows reading pace
• On-the-Nose Dialogue: Characters stating subtext explicitly
• Forced Backstory: Awkward exposition dumped into early dialogue
• Camera Direction: Including shots/angles that directors should determine
• Character Labels: Describing characters by occupation instead of behavior
• Purple Prose: Overly flowery or literary writing style

4. Subtle Killers (Advanced Issues)

Sophisticated problems that undermine otherwise competent writing:

• False Promises: Opening tone that doesn't match the actual story
• Generic Imagery: Visual choices that could apply to any similar story
• Unclear Stakes: Reader doesn't understand what matters or why
• Missing Voice: Writing that sounds like every other script in the pile
• Derivative Openings: Copying famous openings without adding originality

Analysis Interface

The Cliché Opening tool provides a comprehensive tabbed interface with actionable insights:

Summary Tab

• Total Clichés Detected: Count of all identified issues
• Severity Breakdown: Critical, warning, and minor issues categorized
• Category Distribution: Visual breakdown across four diagnostic categories
• Overall Assessment: Professional evaluation of opening quality
• Priority Actions: Most important fixes to address first

Detections Tab

• Detailed Findings: Complete list of all detected clichés
• Severity Indicators: Color-coded severity levels (Critical/Warning/Minor)
• Page Locations: Exact page numbers and scene references
• Scene Navigation: Click to jump directly to problematic scenes in editor
• Narrative Flaws: Why each cliché undermines the story
• Corrective Strategies: Specific guidance for fixing each issue
• Examples: Concrete examples for better understanding

Principles Tab

• Core Opening Principles: Assessment of three fundamental requirements
• Immediate Engagement: Does the opening grab attention instantly?
• Clear Direction: Is the story's trajectory obvious and compelling?
• Professional Execution: Does the writing demonstrate craft mastery?
• Detailed Evaluation: In-depth analysis of each principle
• Improvement Guidance: Specific recommendations for strengthening principles

Quick Fixes Tab

• Category-Organized Solutions: Fixes grouped by diagnostic category
• Actionable Recommendations: Clear, concrete steps to eliminate clichés
• Priority Ordering: Most important fixes listed first
• Alternative Approaches: Creative solutions for common problems
• Implementation Guidance: How to apply fixes without losing story essence

Severity Levels

Each detected cliché is rated by severity to help prioritize revisions:

• Critical (Red): Trust-breaking issues that readers immediately recognize as amateur. These must be addressed before submission.
• Warning (Orange): Problematic choices that weaken the opening and should be reconsidered or improved.
• Minor (Yellow): Subtle issues that may not derail the opening but represent missed opportunities for stronger writing.

Scene Navigation Integration

Click any detection's page reference to instantly navigate to that scene in the editor:

• Instant Navigation: Jump directly to problematic scenes
• Context Preservation: See the full scene context around the issue
• Efficient Revision: Fix issues without manually searching for them
• Dialog Integration: Analysis dialog stays open while editing

When to Use Cliché Opening Analysis

• Before First 10 Pages Analysis: Clean up obvious clichés before detailed evaluation
• After First Draft: Identify trust-breaking choices early in the revision process
• Pre-Submission Review: Ensure opening doesn't contain amateur signals
• Competition Preparation: Polish opening to stand out in screenplay contests
• Query Package Prep: Make sample pages as professional as possible
• Rewrite Planning: Prioritize which opening elements need complete rethinking

Professional Context

Why cliché openings matter: Industry readers evaluate dozens of scripts weekly and develop pattern recognition for amateur writing. Cliché openings trigger immediate "pass" responses because they signal a writer who:

• Hasn't studied professional screenwriting craft
• Doesn't understand what makes openings cinematically compelling
• Lacks awareness of industry standards and reader expectations
• May have similar issues throughout the entire screenplay

The first 10 pages paradox: Your opening needs to feel fresh and original while simultaneously establishing genre, tone, character, conflict, and stakes. Clichés are shortcuts that sacrifice originality for familiarity, but professional openings find creative ways to deliver all necessary information without resorting to overused devices.

Key Diagnostic Principles

• Show, Don't Tell: Reveal character and story through action, not exposition
• Active Protagonists: Main character must drive action, not passively observe
• Immediate Stakes: Reader must understand what matters and why, quickly
• Original Execution: Even familiar genres need fresh presentation
• Economy of Style: Every line must earn its place on the page
• Trust Your Reader: Don't over-explain; engage their active participation
• Tonal Consistency: Opening must authentically represent the story to follow

Integration with Other Tools

Cliché Opening Analysis works seamlessly with other NoosphereWriter features:

• First 10 Pages: Use cliché analysis first, then evaluate overall opening quality
• Common Flaws: Broader screenplay issues that may extend beyond the opening
• Readability: Ensure smooth reading experience after fixing clichés
• Character Introduction: Verify character first appearances aren't clichéd
• Theme Structure: Ensure opening introduces thematic elements effectively
• Pacing Heat-Map: Visual representation of opening momentum

Export and Documentation

Export your Cliché Opening analysis as a professional PDF report including:

• Executive Summary: Total clichés, severity breakdown, overall assessment
• Detailed Detections: Complete list with page locations and narrative flaws
• Core Principles Evaluation: Assessment of fundamental opening requirements
• Corrective Strategies: Specific guidance for fixing each detected cliché
• Priority Recommendations: Actionable improvement plan organized by urgency
• Professional Formatting: Clean layout suitable for development notes

Smart Caching

The analysis includes intelligent caching to improve performance:

• Content-Based Caching: Re-analyzes only when first 10 pages actually change
• Instant Results: Cached analyses display immediately on reopening
• Automatic Invalidation: Cache clears when screenplay content changes
• Session Persistence: Results persist across dialog open/close cycles

Common Misconceptions

• "But successful movies use these openings!" - Famous films earned the right to use clichés through other strengths. Unproduced writers can't afford the same risks.
• "It's subversive/meta usage!" - Subversion only works when readers trust you've earned it, which first-time writers haven't yet demonstrated.
• "Readers should judge the whole script!" - They will, but only if the opening doesn't immediately signal amateur work.
• "I'm putting a fresh spin on it!" - The burden of proof is much higher when starting from a clichéd foundation.

Workflow Recommendation

Optimal revision sequence for opening pages:

1. Cliché Opening Analysis: Identify and eliminate trust-breaking choices
2. Readability: Ensure smooth, professional writing style
3. Character Introduction: Verify compelling character first appearances
4. First 10 Pages Analysis: Comprehensive evaluation of overall opening quality
5. Pacing Heat-Map: Fine-tune rhythm and momentum
6. Final Polish: Line-by-line refinement of language and clarity

This sequence ensures you're building on a solid foundation rather than polishing clichéd material.

First 10 Pages Analysis

Professional evaluation of your screenplay's opening pages using industry-standard criteria. The first 10 pages are critical for engaging readers, establishing your story world, and demonstrating professional writing ability.

How It Works

First 10 Pages Analysis evaluates your screenplay's opening against professional standards used by industry readers:

1. Go to Script → Story & Structure → First 10 Pages
2. The tool automatically extracts your first 10 pages
3. Click "Analyze First 10 Pages"
4. Receive comprehensive professional evaluation
5. Review detailed assessment across multiple categories
6. Export analysis as PDF report

Professional Evaluation Framework

The analysis evaluates your opening across four critical categories that determine reader engagement:

1. Technical Execution & Professionalism

• Professional Formatting: Industry-standard screenplay format and presentation
• Clear Scene Description: Concise, visual action lines that paint clear pictures
• Dialogue Quality: Natural, character-specific voices without exposition dumps
• Pacing & Flow: Appropriate rhythm for genre and story type
• Page Economy: Efficient use of page space without overwriting

2. Protagonist & Character Introduction

• Clear Protagonist Identification: Reader knows who to follow
• Compelling Character Introduction: Memorable first impression
• Character Goals & Motivations: What the protagonist wants
• Emotional Connection: Reasons to care about the character
• Unique Voice: Distinctive personality and perspective

3. Narrative Foundation & The Hook

• Opening Image: Powerful first impression that sets tone
• Genre Establishment: Clear genre signals and expectations
• Story Questions: Compelling mysteries that demand answers
• Conflict Introduction: Central tension or problem emerging
• Narrative Momentum: Forward movement and escalation

4. World-Building & Thematic Depth

• World Establishment: Clear sense of time, place, and rules
• Atmospheric Tone: Consistent mood and feeling
• Thematic Introduction: Hints at deeper meaning and themes
• Visual Storytelling: Show don't tell approach
• Unique Elements: Fresh perspective or original concepts

The Page 11 Test

The analysis includes the critical "Page 11 Test" - a key industry benchmark that asks: "After reading the first 10 pages, do I want to read page 11?"

What Makes Readers Want Page 11

• Unanswered Questions: Mysteries that demand resolution
• Character Investment: Caring about what happens to the protagonist
• Escalating Stakes: Sense that something important is at risk
• Professional Execution: Confidence in the writer's ability
• Fresh Voice: Unique perspective worth experiencing

Analysis Interface

The First 10 Pages tool provides a comprehensive tabbed interface with detailed insights:

Assessment Tab

• Overall Score: 0-100 professional evaluation score
• Effectiveness Level: Exceptional/Good/Developing/Needs Work
• Key Strengths: What's working well in your opening
• Critical Weaknesses: Priority areas for improvement
• Opening Image Analysis: Evaluation of your first scene
• Page 11 Test Result: Pass/Needs Work with detailed reasoning

Framework Parts Tab

• Category Scores: Individual ratings for each evaluation category
• Detailed Checklist: Pass/fail on specific professional criteria
• Analysis Details: In-depth explanation for each evaluation point
• Missing Elements: What's absent from your opening

Recommendations Tab

• Priority Improvements: Most critical fixes needed
• Category-Specific Suggestions: Targeted advice for each framework part
• Professional Standards: How to meet industry expectations
• Next Steps: Actionable revision strategy

Page 11 Test Tab

• Pass/Fail Result: Clear verdict on the Page 11 Test
• Detailed Reasoning: Comprehensive explanation of the assessment
• Reader Psychology: What makes readers continue or stop
• Industry Context: Why the Page 11 Test matters professionally
• Improvement Strategy: How to pass the test on revision

Effectiveness Levels

Your opening pages are rated on a professional scale:

• Exceptional (85-100): Industry-ready opening that demands attention
• Good (70-84): Solid professional opening with minor improvements needed
• Developing (50-69): Shows promise but needs significant strengthening
• Needs Work (0-49): Requires major revision to meet professional standards

When to Use First 10 Pages Analysis

• Before Submission: Ensure your opening meets professional standards
• After First Draft: Evaluate if your opening effectively launches the story
• During Revision: Focus improvements where they matter most
• Competition Prep: Polish your opening for contests and queries
• Reader Testing: Understand how industry readers will react

Professional Tips for Strong Openings

• Start with Conflict: Begin in the middle of action or tension
• Establish Voice Immediately: Your unique perspective should be clear from page 1
• Show Character Through Action: Reveal personality through choices, not description
• Create Visual Interest: Paint compelling pictures that directors can see
• Plant Questions: Give readers mysteries they must see resolved
• Trust Your Reader: Don't over-explain; let them engage actively
• Economy Matters: Every line should earn its place on the page

Integration with Other Tools

First 10 Pages Analysis works seamlessly with other NoosphereWriter features:

• Character Introduction: Detailed analysis of character first appearances
• Pacing Heat-Map: Visual representation of your opening's rhythm
• Common Flaws: Identify and fix typical opening mistakes
• Readability: Ensure smooth reading experience
• Theme Structure: Verify thematic elements are introduced effectively
• Coverage Report: Get complete professional screenplay evaluation

Export and Documentation

Export your First 10 Pages analysis as a professional PDF report including:

• Executive Summary: Overall score and key findings
• Detailed Assessment: Complete evaluation across all categories
• Page 11 Test Results: Pass/fail with comprehensive reasoning
• Framework Scores: Individual ratings for each evaluation area
• Priority Recommendations: Actionable improvement strategy
• Professional Formatting: Clean layout for development notes

Understanding Industry Standards

The First 10 Pages Analysis is based on how professional readers evaluate screenplays:

• First Impressions Matter: Readers often decide within 10 pages whether to continue
• Professional Polish: Technical execution signals your experience level
• Story Promise: Your opening makes implicit promises about the story to come
• Reader Engagement: Industry readers have limited time and many scripts to evaluate
• Competition Reality: Your opening competes with thousands of other scripts

Movie Ending

Analyze your screenplay's conclusion against a proven 7-point framework to ensure a satisfying and thematically resonant ending.

How It Works

The Movie Ending tool evaluates the final pages of your script (typically the last 5-10 pages) to assess how well they resolve the story's setup and deliver a powerful payoff:

1. Go to Script → Story & Structure → Movie Ending
2. The tool automatically extracts the ending scenes
3. Click "Analyze Ending"
4. Review the assessment of Setup Pillars and Payoff Steps
5. Export a detailed PDF report

The 7-Point Framework

The analysis is based on two key phases:

Phase 1: Setup Pillars

Ensures the ending effectively addresses the core elements established at the beginning:

• External Goal: Does the protagonist achieve or fail their conscious objective?
• Internal Flaw: Is the protagonist's fatal flaw addressed or overcome?
• Thematic Question: Does the ending provide a definitive answer to the story's central philosophical question?

Phase 2: Payoff Steps

Evaluates the structural beats of the climax and resolution:

• The Final Test: The ultimate challenge that forces the protagonist to prove their growth.
• Point of No Return: The moment where the protagonist commits fully, burning bridges to the past.
• The Choice: A defining decision that proves the protagonist has changed (or failed to change).
• The Transformation: The final state of the protagonist, contrasting with who they were at the start.

Features

• Pass/Fail Assessment: Clear evaluation for each of the 7 principles.
• Detailed Feedback: Specific insights on why a principle passed or failed.
• Recommendations: Actionable advice to strengthen weak areas.
• Scene Navigation: Jump directly to relevant scenes in your script.
• PDF Export: Save the analysis for offline review or sharing.

Plot Templates

Compare your screenplay against established plot structure templates to identify missing story beats and strengthen your narrative architecture. This AI-powered tool maps your scenes to classic storytelling frameworks and provides actionable insights for structural improvement.

How It Works

Plot Templates analysis evaluates your screenplay against proven story structures used by successful films:

1. Go to Script → Story & Structure → Plot Templates
2. Select a plot template from the dropdown (e.g., 15-Beat Blueprint, Hero's Journey)
3. Click "Analyze Screenplay" to start the AI analysis
4. Review the comprehensive structural analysis
5. Explore mapped beats and missing elements by expanding act sections
6. Export the complete analysis as a PDF report

Available Templates

Choose from industry-standard story structures:

• 15-Beat Blueprint: Blake Snyder's Save the Cat structure with precise beat timing
• Three-Act Structure: Classic beginning, middle, and end with plot points
• Hero's Journey: Joseph Campbell's monomyth for transformational stories
• Five-Act Structure: Shakespearean dramatic structure for complex narratives
• Seven-Act Structure: Television and episodic storytelling framework
• Dan Harmon's Story Circle: Simplified hero's journey for character-driven stories
• Fichtean Curve: Crisis-driven structure with escalating tension
• Save the Cat: Genre-specific beat sheets for different story types

Analysis Components

Coverage Summary

• Coverage Percentage: How much of the template your screenplay fulfills
• Mapped Beats: Template beats successfully found in your script
• Missing Beats: Critical story elements not yet present
• Structural Alignment: Overall assessment (Excellent/Good/Fair/Poor)

Acts Analysis

Detailed breakdown by act showing:

• Expected vs Actual Beats: What the template requires vs what you have
• Completeness Percentage: How fully each act is developed
• Mapped Scenes: Your scenes that correspond to template beats
• Missing Elements: Beats needed to complete each act
• Structural Notes: Act-specific observations and suggestions

Beat Mapping

For each template beat found in your screenplay:

• Template Beat: Name and description of the structural element
• Your Scene: Scene number, heading, and content that matches
• Confidence Level: How well your scene fulfills the beat (High/Medium/Low)
• Alignment Notes: Specific observations about the match
• Click to Navigate: Jump directly to the scene in your screenplay

Missing Beats Analysis

For beats not found in your screenplay:

• Beat Description: What story purpose this beat serves
• Importance Level: Critical, Important, or Beneficial
• Suggested Placement: Where in your script to add this beat
• Implementation Suggestions: Specific ideas for incorporating the beat

Structural Analysis Features

Pacing Analysis

• Pacing Assessment: How well your story rhythm follows the template
• Timing Issues: Beats that occur too early or too late
• Flow Suggestions: How to improve story momentum

Strengths and Weaknesses

• Structural Strengths: What your screenplay does well structurally
• Structural Weaknesses: Areas needing improvement
• Key Missing Elements: Most important beats to add

Recommendations

• Priority Actions: Most important structural fixes
• Beat-Specific Advice: How to strengthen existing beats
• Scene Suggestions: Ideas for new scenes to fill gaps
• Revision Strategy: Order of operations for improvements

Interactive Features

• Expandable Acts: Click act headers to view detailed beat information
• Scene Navigation: Click any mapped scene to jump to it in the editor
• Auto-Expansion: Acts with missing beats automatically expand
• Confidence Indicators: Color-coded badges show mapping strength
• Importance Badges: Visual priority levels for missing beats

When to Use Plot Templates

• Story Development: Ensure your narrative has all essential elements
• Structural Revision: Identify and fix pacing problems
• Genre Alignment: Match genre expectations with appropriate templates
• Coverage Preparation: Anticipate reader expectations for structure
• Learning Tool: Understand how successful films use these structures

Best Practices

• Choose the Right Template: Select based on your genre and story type
• Don't Force It: Templates are guides, not rigid rules
• Focus on Missing Critical Beats: Prioritize "Critical" importance items
• Maintain Your Voice: Add beats while preserving your unique style
• Iterate Analysis: Re-run after revisions to track improvement

Integration with Other Tools

Plot Templates analysis complements other NoosphereWriter features:

• Plot Board: Visualize your structure with the same templates
• Pacing Heat-Map: See how structure affects story rhythm
• Coverage Report: Get professional assessment of structure
• Scene Optimizer: Improve individual scenes within the structure
• Theme Structure: Ensure themes align with plot beats

Export Options

Export your Plot Templates analysis as a comprehensive PDF including:

• Executive Summary: Coverage percentage and alignment assessment
• Acts Breakdown: Detailed analysis of each act with beats
• Mapped Beats: Complete list of found template elements
• Missing Beats: Prioritized list with implementation guidance
• Structural Analysis: Strengths, weaknesses, and recommendations
• Visual Progress: Charts showing coverage and completeness

Understanding Template Analysis

Important considerations when using Plot Templates:

• Templates as Tools: They reveal structure but don't replace creativity
• Flexibility Matters: Great films often bend or break template "rules"
• Context Sensitive: AI considers your genre and style when mapping
• Confidence Levels: Not all matches are perfect - review medium/low confidence mappings
• Evolution Friendly: Your structure can evolve beyond initial templates

Continuity Check

AI-powered analysis to detect timeline inconsistencies, character errors, and plot holes.

What It Analyzes

• Timeline Consistency: Day/night progression, time references
• Character Continuity: Names, relationships, presence in scenes
• Plot Logic: Story cause-and-effect, setups and payoffs
• Prop Tracking: Important objects and their locations
• Location Logic: Geographic consistency

Severity Levels

• 🔴 High: Major continuity errors
• 🟡 Medium: Potential issues to review
• 🔵 Low: Minor suggestions

Using Continuity Check

1. Go to Script → Story & Structure → Continuity Check
2. AI analyzes your entire screenplay
3. Review issues by category
4. Click any issue to jump to that scene
5. Export report as PDF

World-building Dossier

Comprehensive AI-powered analysis of your screenplay's world using the Five Pillars of World-Building framework. Extract every detail that defines your story world, identify gaps, and discover opportunities for deeper world-building.

The Five Pillars Framework

The dossier organizes world-building elements into five comprehensive categories:

I. Physical Realm

• Cosmology & Astronomy: Planets, suns, moons, celestial events, night sky appearance
• Geography & Geology: Continents, oceans, mountains, biomes, climate, weather patterns, natural resources
• Flora & Fauna: Plants, animals, ecosystem food chains, domesticated species, medicinal/poisonous plants

II. Societal Construct

• Government & Politics: Government form, rulers, political factions, legal system, law enforcement
• Economy & Commerce: Economic system, currency, wealth distribution, class systems, major industries
• Factions & Organizations: Military structure, corporations, guilds, criminal syndicates, secret societies

III. Cultural Fabric

• History & Lore: Timeline of major events, creation myths, wars, disasters, discoveries, legendary figures
• Religion & Mythology: Major religions, gods/deities, core beliefs, sacred texts, worship practices
• Language & Communication: Primary languages, dialects, slang, colloquialisms, written language
• Daily Life & Customs: Family structure, marriage/birth/death customs, gender roles, foods, clothing, entertainment

IV. Rules of Reality

• Physics & Natural Laws: Does physics mirror reality? Gravity differences? Unique physical principles?
• Technology & Science: Tech level, common tools/devices, transportation, communication, medical science
• Magic & Metaphysics: Does magic exist? Source, rules, limitations, costs, types, societal view

V. Inhabitants

• Races & Species: Sentient species, physical traits, lifespans, unique abilities, origins, cultural norms
• Key Character Dossiers: Main characters' backstory connections to world history, motivations shaped by culture

What The Analysis Provides

• Extracted Elements: Every detail mentioned in your screenplay, organized by pillar and category
• Scene References: Each element references the specific scene where it appears (e.g., "Scene 5")
• Completeness Score: 0-100% score based on how thoroughly your world is defined
• Gaps Identified: Categories that need more development for a richer world
• Consistency Issues: Contradictions or conflicts between different scenes

Using World-building Dossier

1. Go to Script → Story & Structure → World-building Dossier
2. AI analyzes your entire screenplay using the Five Pillars framework
3. Review the completeness score and total elements found
4. Expand each pillar to see extracted details organized by category
5. Review "Gaps Identified" to see where your world needs more development
6. Check "Consistency Issues" to find potential contradictions
7. Export complete dossier as PDF for production reference

Best Practices

• Run After Major Revisions: Generate a new dossier after significant screenplay changes
• Use for Production Bible: Export the PDF as reference material for production teams
• Address Gaps Strategically: Not every category needs development - focus on what serves your story
• Check Consistency Early: Catching contradictions early prevents larger continuity issues
• Reference Scene Numbers: Use the scene references to quickly locate and enhance world-building moments

When to Use World-building Dossier

• Fantasy/Sci-Fi Projects: Essential for stories with complex invented worlds
• Period Pieces: Verify historical and cultural details are consistently portrayed
• Pre-Production Planning: Create comprehensive production bibles for art departments
• Series Development: Establish consistent world rules across multiple episodes/films
• World Expansion: Identify opportunities to deepen your story world organically

Reverse Outline

AI-powered scene-by-scene structural analysis that extracts your screenplay's skeleton to diagnose structural issues. Includes action summary, character beats, and value changes for each scene.

What It Analyzes

The Reverse Outline examines your screenplay and generates:

• Scene-by-Scene Breakdown: Each scene analyzed for its narrative function
• Action Summary: What physically happens in each scene ("The Plot")
• Character Beat: Character development moments ("The Arc")
• Value Change: Emotional/dramatic shift from beginning to end of scene (e.g., "Security (+) → Insecurity (-)")
• Structural Function: Where the scene fits in classic story structure (Catalyst, Midpoint, etc.)
• Scene Purpose: Classification of what the scene accomplishes (Plot Advancement, Character Development, Exposition, etc.)
• Flagged Scenes: Potential problem areas requiring attention

Understanding Value Changes

Value changes indicate the dramatic shift within a scene. Professional screenwriters use this technique to ensure every scene moves the story forward:

• Positive to Negative: Hope → Despair, Trust → Betrayal, Safety → Danger
• Negative to Positive: Fear → Courage, Isolation → Connection, Failure → Success
• Neutral to Charged: Calm → Tension, Ordinary → Extraordinary

Scenes without clear value changes often indicate structural issues that need attention.

Structure Analysis

The tool provides act-level analysis including:

• Act Length Distribution: Percentage breakdown of Acts One, Two, and Three
• Pacing Issues: Areas where structure may be unbalanced
• Missing Beats: Key story beats not clearly present
• Structure Notes: Overall observations about your screenplay's architecture

Scene Purpose Categories

Each scene is classified into one of these narrative purposes:

• Plot Advancement: Moves the story forward with new events or information
• Character Development: Deepens understanding of characters
• World Building: Establishes setting, rules, or atmosphere
• Exposition: Delivers necessary background information
• Conflict Escalation: Raises stakes or intensifies obstacles
• Emotional Beat: Creates specific emotional response
• Setup/Payoff: Plants or delivers on narrative promises
• Transition: Connects between major sequences
• Unclear: Purpose not immediately evident (potential problem)

Redundancies Detection

The analysis identifies potential scene redundancies:

• Scenes serving the same narrative purpose
• Similar dialogue patterns across scenes
• Repeated information delivery
• Suggestions for consolidation or differentiation

How to Use Reverse Outline

1. Access: Go to Script → Story & Structure → Reverse Outline
2. Analyze: Click "Analyze Screenplay" to process your script
3. Review Summary: Check total scenes, flagged scenes, and completeness score
4. Explore Scenes: Expand scene sections to see detailed breakdowns
5. Check Structure: Review the Structure Analysis section for act balance
6. Address Issues: Focus on flagged scenes and scenes with "Unclear" purposes
7. Export: Generate a PDF report for offline review or collaboration

Interpreting the Completeness Score

The completeness score (0-100) indicates how well-structured your screenplay appears:

• 85-100: Excellent structure with clear scene purposes throughout
• 70-84: Good structure with minor areas for improvement
• 50-69: Moderate structural issues requiring attention
• Below 50: Significant structural concerns to address

PDF Export

Generate a comprehensive PDF report including:

• Summary statistics and completeness score
• Complete scene-by-scene breakdown
• Value changes for each scene
• Flagged scenes with explanations
• Structure analysis with act breakdowns
• Redundancy observations

When to Use Reverse Outline

• First Draft Diagnosis: Identify structural issues before major rewrites
• Pacing Problems: Find scenes that slow momentum or lack purpose
• Act Balance: Ensure proper weight distribution across your story
• Pre-Revision Planning: Create a roadmap for structural improvements
• Collaboration: Share structural overview with collaborators or coverage readers

Causality Inspector

A diagnostic tool that analyzes scene transitions to distinguish between episodic plotting ("And Then") and causal plotting ("Therefore" / "But"). Ideally, scenes should be causally linked to create narrative momentum.

Transition Types

• 🔗 Therefore (Causal): The previous scene causes this scene to happen. (High narrative drive)
• ↔️ But (Conflict): The previous scene's goal is blocked, forcing a new direction. (High narrative drive)
• ⏸️ Meanwhile (Parallel): A shift to a parallel storyline. (Neutral)
• ⏱️ And Then (Episodic): Something happens next, but not necessarily because of the previous scene. (Weak narrative drive)

How to Use

1. Access: Go to Script → Story & Structure → Causality Inspector.
2. Analyze: Click "Analyze Script". Returns a list of scene pairs (A → B).
3. Review: Expand any pair to see the AI's reasoning for the transition classification.
4. Filter: Toggle "Show Weak Links Only" to identify "And Then" transitions that need tightening.

Features

• Causality Score: A percentage indicating how strong the causal chain is.
• Episodic Drift: A count of non-causal transitions ("And Then").
• Fix Suggestions: For weak links, the AI offers suggestions on how to rewrite the transition to be causal.
• PDF Export: Download a report of the analysis.
• Privacy: Analysis is cached locally to minimize API usage.

Escalation Monitor

A diagnostic tool that tracks the "Global Danger Gradient" across your screenplay to detect "Premature De-escalation" - a common issue where stakes inadvertently drop in the latter half of a script.

The Problem It Solves

Writers often front-load danger. After a strong Midpoint crisis, scenes can relax into logistical planning or "gathering allies" that accidentally lowers tension. This tool identifies where your danger gradient plateaus or dips when it should be climbing.

How It Works

The Escalation Monitor analyzes your screenplay at key structural landmarks:

• 10% (Inciting Incident): Where stakes are first introduced
• 25% (End of Act 1): Complication that locks the protagonist in
• 50% (Midpoint): Point of no return or major revelation
• 75% (End of Act 2): All is lost / lowest point
• 90% (Climax): Maximum danger - should be the highest score

How to Use

1. Access: Go to Script → Story & Structure → Escalation Monitor.
2. Analyze: Click "Analyze Escalation". The AI evaluates danger levels at each landmark.
3. Review Chart: The Danger Gradient chart shows your actual danger curve vs. the ideal rising action.
4. Check Comparisons: Section comparison cards show whether each pair escalates properly (PASS/FAIL).
5. Fix Issues: Expand failed comparisons for reasoning and fix suggestions.

Features

• Escalation Score: A percentage (0-100%) indicating overall escalation health.
• Trend Status: Overall assessment - "Healthy Climb", "Plateau Detected", or "Critical De-escalation".
• Danger Gradient Chart: Visual line chart comparing your danger curve to ideal rising action.
• Section Comparisons:
  • Act 1 → Midpoint
  • Midpoint → End of Act 2
  • Climax supremacy check
• De-escalation Issues: Specific problem areas with intensity drop percentages.
• Fix Suggestions: AI recommendations for increasing tension in weak areas.
• PDF Export: Download the complete analysis report.
• Privacy: Analysis is cached locally to minimize API usage.

Interpreting Results

• Green (75%+): Strong escalation pattern - stakes rise appropriately
• Yellow (50-74%): Some plateau areas detected - review comparisons
• Red (<50%): Significant de-escalation issues - urgent attention needed

Cliché and Trope Identifier

AI-powered analysis to identify overused story elements, predictable plot devices, and derivative content. Get specific suggestions for fresh, original alternatives that maintain story integrity while increasing audience surprise.

What It Analyzes

• Story Structure Clichés:
  • "Chosen One" narratives without fresh twists
  • Love triangles as primary conflict drivers
  • Mentor death as character motivation
  • Deus ex machina resolutions
  • Hero's journey without innovation
• Character Archetype Clichés:
  • Manic pixie dream girls
  • Wise old mentors with cryptic advice
  • Evil corporations as faceless antagonists
  • Perfect villains without depth
  • Strong female characters that are just male characters with different pronouns
• Dialogue Clichés:
  • One-liners at inappropriate dramatic moments
  • Exposition speeches disguised as conversation
  • Genre-specific jargon ("We've got company!", "It's quiet... too quiet")
  • Characters stating themes directly
• Plot Device Clichés:
  • MacGuffins with no thematic relevance
  • Convenient coincidences driving plot
  • Misunderstandings that could be resolved with one conversation
  • Technology that works exactly when needed
• Visual Clichés:
  • Slow-motion explosions without emotional context
  • Rain during emotional confrontations
  • Dutch angles for "edginess"
  • Flashbacks as exposition delivery
• Theme Treatment Clichés:
  • Heavy-handed symbolism with no subtlety
  • Obvious moral lessons stated directly
  • Redemption arcs that feel unearned
  • "Power of love" solving complex problems

Originality Assessment

• Originality Score: 0-100 rating for overall creativity
• Creativity Levels:
  • 🔴 Derivative: Heavy reliance on overused elements
  • 🟡 Conventional: Some clichés but functional story
  • 🟢 Fresh: Original approach with minor clichés
  • ✨ Highly Original: Innovative storytelling throughout
• Creative Alternatives: Specific suggestions for each identified cliché
• Industry Insights: Professional perspective on marketability impact

Using Cliché and Trope Identifier

1. Go to Script → Craft & Style → Cliché and Trope Identifier
2. Click "Analyze for Clichés and Tropes"
3. AI analyzes your screenplay for derivative content
4. Review originality summary and creativity level
5. Explore issues by category (click to expand details)
6. Read creative alternatives for each identified cliché
7. Jump to specific scenes using navigation links
8. Focus on priority recommendations for maximum impact
9. Export comprehensive report as PDF

Understanding Results

• Priority Recommendations: High-impact changes ranked by importance
• Issues by Category: Detailed breakdown with specific examples
• Creative Suggestions: Fresh approaches that maintain story function
• Unique Strengths: Original elements already working well
• Scene Navigation: Click any scene reference to jump directly to that location

Best Practices

• Focus on High-Priority Issues: Address critical clichés first for maximum originality improvement
• Maintain Story Integrity: Use suggested alternatives that serve your story goals
• Consider Genre Expectations: Some "clichés" may be necessary genre conventions
• Preserve Your Voice: Adapt suggestions to fit your unique writing style
• Test with Fresh Eyes: Re-analyze after making changes to measure improvement

Common Flaws Report

Identifies frequent screenplay issues and provides specific suggestions for improvement.

Categories Analyzed

• Dialogue Issues:
  • On-the-nose dialogue
  • Excessive exposition
  • Repetitive speech patterns
  • Unnatural conversations
• Action Line Problems:
  • Overwritten descriptions
  • Camera directions
  • Unfilmable elements
  • Passive voice overuse
• Structure Issues:
  • Pacing problems
  • Scene length imbalances
  • Missing conflict
  • Weak openings/endings

Improvement Suggestions

Each identified flaw includes:

• Specific location in script
• Explanation of the issue
• Concrete improvement suggestion
• Example of better approach

Readability

AI-powered analysis that simulates the table read experience to identify text that disrupts smooth reading flow.

What It Analyzes

• Action Lines:
  • Overly long sentences that leave readers breathless
  • Convoluted descriptions requiring re-reading
  • Passive voice that weakens impact
  • Dense technical language
• Dialogue:
  • Robotic speech patterns lacking natural flow
  • Missing contractions in casual conversation
  • On-the-nose exposition without subtext
  • Overly formal or stilted language
• Repetitive Language:
  • Overused words and phrases
  • Repeated sentence structures
  • Monotonous rhythm patterns
  • Limited vocabulary usage
• Flow Issues:
  • Awkward transitions between scenes
  • Inconsistent pacing
  • Jarring tonal shifts
  • Reader fatigue triggers

Understanding the Analysis

• Readability Score: 0-100 scale measuring overall reading ease
  • 90-100: Excellent - Flows effortlessly
  • 80-89: Good - Minor improvements possible
  • 70-79: Fair - Notable issues to address
  • 60-69: Poor - Significant revision needed
  • Below 60: Critical - Major rewrite recommended
• Severity Levels:
  • 🔴 Critical: Major readability barriers
  • 🟡 Warning: Noticeable flow disruptions
  • ⚪ Minor: Small refinements suggested

Using Readability Analysis

1. Go to Script → Craft & Style → Readability
2. Click "Analyze Readability" to start the AI analysis
3. Review your overall readability score and level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific issues
6. Click "→ Go to Scene X" to jump directly to problems
7. Export a PDF report for detailed review

Table Read Benefits

This analysis specifically helps prepare for table reads by:

• Ensuring actors can deliver lines naturally
• Preventing stumbling over complex action lines
• Maintaining audience engagement throughout
• Creating smooth narrative flow
• Reducing the need for on-the-fly rewrites

Improvement Tips

• For Action Lines: Break sentences at 25-30 words, use active voice, focus on what the camera sees
• For Dialogue: Read aloud, use contractions naturally, layer in subtext, match character voice
• For Repetition: Vary sentence structure, expand vocabulary, use pronouns effectively
• For Flow: Ensure smooth transitions, maintain consistent tone, balance pacing

On-the-Nose Detector

AI-powered analysis that identifies dialogue where characters explicitly state emotions, intentions, or information without subtext, helping you write more engaging and professional dialogue.

What It Analyzes

• Emotion Stating:
  • Characters directly stating their emotions ("I'm angry", "I feel sad")
  • Explicit emotional declarations without nuance
  • Telling feelings instead of showing through behavior
  • Lack of emotional subtext in dialogue
• Motivation Explaining:
  • Characters announcing their goals and motivations
  • Direct statements of intent ("I want revenge")
  • Explicit declaration of character objectives
  • Missing opportunity for audience inference
• Backstory Dumping:
  • Unnatural exposition through dialogue
  • "As you know" style information dumps
  • Characters stating shared knowledge
  • Forced exposition that disrupts conversation flow
• Theme Announcing:
  • Characters explicitly stating the story's theme
  • Direct moral or lesson declarations
  • Obvious thematic statements ("The lesson here is...")
  • Removing subtlety from thematic elements
• Intent Declaring:
  • Characters announcing what they're about to do
  • Telegraphing actions before performing them
  • Removing dramatic tension through pre-announcement
  • Stating plans instead of revealing through action

Understanding the Analysis

• Subtext Score: 0-100 scale measuring how well your dialogue uses subtext
  • 91-100: Excellent - Rich subtext throughout
  • 71-90: Good - Mostly subtle with minor on-the-nose moments
  • 41-70: Fair - Mix of subtle and explicit dialogue
  • 0-40: Poor - Heavy reliance on explicit statements
• Severity Levels:
  • 🔴 Critical: Dialogue that would never be spoken naturally, completely lacks subtext
  • 🟡 Warning: On-the-nose but could work with strong performance, moderately explicit
  • ⚪ Minor: Slightly too direct, easy to fix with subtle rewording

Using On-the-Nose Detector

1. Go to Script → Craft & Style → On-the-Nose Detector
2. Click "Analyze Dialogue" to start the AI analysis
3. Review your overall subtext score and level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific dialogue issues
6. Review the Subtext Alternatives provided for each issue (2-3 suggestions per problem)
7. Click "→ Go to Scene X" to jump directly to the dialogue
8. Click "Regenerate" to re-analyze with fresh AI perspective
9. Export a PDF report for detailed review

Why Subtext Matters

On-the-nose dialogue is considered one of the most fundamental weaknesses in screenwriting because:

• Unrealistic: People rarely state emotions or intentions directly in real conversations
• Dramatically Flat: Removes tension and mystery from character interactions
• Unengaging: Doesn't give audiences the satisfaction of inferring meaning
• Amateur Signal: Immediately marks a script as written by an inexperienced writer
• Performance Limiting: Doesn't give actors room to bring depth to the character
• Emotionally Shallow: Tells instead of shows, reducing emotional impact

Improvement Strategies

• For Emotion Stating:
  • Show emotion through actions, tone, or physical reactions instead of stating it
  • Use sharp, defensive, or evasive dialogue to imply emotional states
  • Let silence, pauses, or what's NOT said reveal feelings
  • Example: Instead of "I'm angry at you" → "[Slams door] We're done talking."
• For Motivation Explaining:
  • Reveal motivations through character choices and actions
  • Use hints, implications, and subtle foreshadowing
  • Let the audience piece together what drives the character
  • Example: Instead of "I want revenge" → "[Studies photo] Everyone pays eventually."
• For Backstory Dumping:
  • Avoid "as you know" and similar exposition phrases
  • Reveal backstory through conflict or emotional moments
  • Only include backstory when it creates present-moment tension
  • Example: Instead of "As you know, we've been partners for 5 years" → "Five years. Can you believe it?"
• For Theme Announcing:
  • Let the story demonstrate the theme through character arcs
  • Never have characters state the moral or lesson explicitly
  • Trust the audience to understand the thematic elements
  • Example: Instead of "The lesson is that family comes first" → "They were there when no one else was."
• For Intent Declaring:
  • Show intent through preparation, body language, or hints
  • Build suspense by revealing plans through action, not dialogue
  • Use sudden action instead of pre-announcement
  • Example: Instead of "I'm going to kill you" → "[Pulls weapon silently]"

Professional Dialogue Techniques

• Iceberg Principle: What's said is only 10% of what's meant - the real meaning is below the surface
• Evasion and Deflection: Characters avoid direct answers, revealing discomfort or hidden agendas
• Contradiction: Words say one thing, actions or tone say another
• Implication: Meaning is suggested through context, not stated directly
• Silence and Pauses: What's NOT said can be more powerful than dialogue
• Indirect Expression: Characters talk around subjects rather than addressing them head-on

Working with Subtext Alternatives

Each on-the-nose issue includes 2-3 alternative dialogue suggestions that demonstrate:

• How to imply the same meaning without stating it directly
• Different approaches (action-based, tone-based, indirect statement)
• Ways to maintain character voice while adding subtext
• Techniques for creating dramatic tension through implication

Note: These alternatives are starting points for your own creativity, not prescriptive rewrites. Adapt them to your character's unique voice and the specific dramatic context.

Unfilmables

AI-powered analysis that identifies content that cannot be filmed or heard by the audience, helping you create production-ready screenplays.

What It Analyzes

• Internal Thoughts & Emotions:
  • Character internal monologue and thoughts
  • Unspoken feelings and emotions
  • Mental realizations and epiphanies
  • Memory flashbacks described in text
• Un-visualized Backstory:
  • Character history told rather than shown
  • Past events described in action lines
  • Exposition about previous relationships
  • Context that exists only in narration
• Abstract Descriptions:
  • Literary language too abstract for cameras
  • Metaphorical descriptions of emotions
  • Concepts that cannot be visualized
  • Prose-style writing unsuitable for film

Understanding the Analysis

• Filmability Score: 0-100 scale measuring how well your script translates to screen
  • 90-100: Excellent - Highly filmable content
  • 80-89: Good - Minor unfilmable elements
  • 70-79: Fair - Some content needs revision
  • 60-69: Poor - Significant unfilmable content
  • Below 60: Critical - Major revision needed
• Severity Levels:
  • 🔴 Critical: Content impossible to film
  • 🟡 Warning: Difficult to convey visually
  • ⚪ Minor: Could be improved for clarity

Using Unfilmables Analysis

1. Go to Script → Craft & Style → Unfilmables
2. Click "Analyze Filmability" to start the AI analysis
3. Review your overall filmability score and level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific issues
6. Click "→ Go to Scene X" to jump directly to problems
7. Use suggested fixes to improve filmability
8. Export a PDF report for production teams

Production Benefits

This analysis specifically helps prepare for production by:

• Ensuring all content can be captured on camera
• Preventing costly script revisions during filming
• Creating clear direction for actors and crew
• Identifying scenes that need visual storytelling
• Helping directors translate story to screen

Common Issues Found

• Character Thoughts: "She remembered her childhood" → Show through actions or dialogue
• Abstract Emotions: "His soul felt heavy" → Use visual metaphors or behavior
• Exposition Dumps: Backstory in action lines → Reveal through scenes
• Literary Style: Prose descriptions → Concrete, visual actions

Improvement Strategies

• Show Don't Tell: Convert internal states to external actions
• Visual Storytelling: Use props, settings, and behavior to convey meaning
• Dialogue Integration: Move exposition into character conversations
• Concrete Language: Replace abstract concepts with specific, filmable actions

Scene Navigation

Click any issue to jump directly to that location in your script. The analysis provides scene references in the format "Scene X: LOCATION" for easy navigation and production coordination.

PDF Export

Generate comprehensive reports including:

• Executive summary with filmability score
• Complete issue breakdown by category
• Scene-specific problem locations
• Suggested improvements for each issue
• Production-ready format for department sharing

Exposition Flagger

The Exposition Flagger helps you identify and fix clumsy exposition, often referred to as "Maid and Butler" dialogue. It detects instances where characters tell each other things they already know, which can break the audience's suspension of disbelief.

What It Detects

• Maid and Butler Dialogue: Characters explaining facts they both know to force-feed information to the audience (e.g., "As you know, you're my brother...").
• Relationship Stating: Characters explicitly stating their relationship (e.g., "Since we are married...").
• Fact Dumping: Characters reciting technical or historical facts they both know.
• Forced Recap: Characters summarizing recent events they both witnessed.

How to Use It

1. Go to Script → Craft & Style → Exposition Flagger.
2. The AI will analyze your script and flag potential issues.
3. Review the flagged dialogue. The tool provides:
   • Explanation: Why the dialogue feels forced.
   • "Show, Don't Tell" Alternatives: Suggestions to reveal the information through subtext, conflict, or action.
4. Use the suggestions to rewrite the dialogue and improve naturalism.

Anachronism Detective

The Anachronism Detective helps you maintain historical accuracy and internal consistency within your screenplay. It analyzes your script to identify elements that may be out of place for the setting or contradict your established world rules.

Modes

• Historical Accuracy: Checks for anachronisms in a specific time period and location (e.g., "New York, 1920"). It flags technology, language, or objects that didn't exist yet.
• World-Building Consistency: Checks for contradictions based on your custom world rules (e.g., "Mars Colony 2050, no paper allowed"). It ensures your story adheres to its own internal logic.

Using the Detective

1. Go to Script → Craft & Style → Anachronism Detective.
2. Select your mode: Historical or World-Building.
3. For Historical: Enter the Year (e.g., 1890) and Location (e.g., London).
4. For World-Building: Enter your World Context (e.g., "Steampunk universe where electricity is banned").
5. Click Run Analysis.

Understanding Results

The analysis provides an Authenticity Score and a breakdown of issues categorized by severity:

• Critical: Major contradictions or impossible elements.
• Warning: Plausible but unlikely elements, or minor inconsistencies.
• Nitpick: Very minor details or linguistic anachronisms.

Each issue includes a description, context, and a "Locate" button to jump to the specific scene in your script.

Exporting Reports

You can export a detailed PDF report of the findings by clicking the Export PDF button. This report includes the score, settings, and a full list of detected issues.

Red Teaming

The Red Teaming feature simulates a high-stakes studio development meeting. Instead of generic feedback, it subjects your screenplay to three distinct, often conflicting adversarial personas to stress-test your work from every angle.

The Studio Simulation

Your script is analyzed in parallel by three AI agents, each with a specific agenda:

• 🕴️ The Suit (Marketability): Focuses purely on commercial viability, audience demographics, pacing, and trailer moments. They want a hit.
• 🎨 The Auteur (Artistry): Focuses on theme, subtext, character depth, and originality. They want a masterpiece.
• 📋 The Producer (Feasibility): Focuses on budget, logistics, and production realities. They want to know if it can actually be filmed.

The Showrunner's Verdict

After the agents argue, the system synthesizes their feedback into a Showrunner's Verdict—a strategic plan to balance these conflicting demands. It highlights:

• Active Conflicts: Specific scenes where Artistry clashes with Budget, or Marketing clashes with Tone.
• Winning Strategy: A actionable path forward to satisfy all stakeholders.

New in v2.0

• Chunking Support: Automatically handles large screenplays by splitting them into chunks, analyzing them in parallel, and synthesizing the results.
• PDF Export: Download a beautifully formatted "Red Teaming Report" to share with collaborators.
• Regenerate: One-click re-simulation to test your edits against the Studio Team.

Using Red Teaming

1. Go to Script → Craft & Style → Red Teaming.
2. Click Analyze Script to assemble the "Studio Team".
3. Review the Executive Summary scores from the Suit, Auteur, and Producer.
4. Check the Showrunner's Verdict for a synthesized strategy to resolve conflicts.
5. Click Export PDF to save a permanent record of the feedback.
6. After making edits to your script, click Regenerate in the dialog header to see if you've won over the room.

Tip: Don't run Red Teaming too early. It is most effective when you have a complete draft and are ready for the "kill your darlings" phase of professional revision.

Audience Simulator

The Audience Simulator uses cognitive modeling to predict how different types of viewers will experience your story in real-time. Unlike static reports, it simulates the dynamic flow of attention, memory load, and emotional engagement scene by scene.

Audience Personas

Test your screenplay against three distinct viewer archetypes:

• 🍿 Popcorn Viewer: Craves novelty, fast pacing, and clear emotional stakes. They possess average attention spans and will "change the channel" if bored.
• 🧠 Deep Reader: Values logical consistency, complex plot mechanics, and lore. They track every detail and will flag continuity errors or plot holes others miss.
• ⚡ Hardened Critic: Highly cynical and resistant to clichés. They punish unoriginal tropes severely but reward genuine subversion and thematic depth.

Simulation Metrics

The simulator tracks three core cognitive signals:

• Attention: The viewer's raw engagement level. Drops when pacing drags or confusion spikes.
• Cognitive Load: How hard the viewer's brain is working to track characters and plot threads. High load without payoff leads to exhaustion.
• Empathy: The emotional connection to the protagonist's goals and struggles.

Churn Points

The system identifies specific "Churn Points"—moments where a significant portion of the audience is likely to stop watching/reading. Each point includes:

• The Trigger: What caused the disengagement (e.g., "Logic Overload", "Cliche Fatigue").
• The Fix: Actionable advice to repair the scene and retain the audience.

Using the Simulator

1. Go to Tools → Validation & Cleaning → Audience Simulator (or search via Command Palette).
2. Click Generate Simulation to model the audience response.
3. Switch between Personas to see how different segments react.
4. Click on any scene in the chart to jump directly to that moment in the editor.
5. Use Export PDF to save a comprehensive report of the findings.

Cinematic Language

AI-powered analysis that evaluates how well your screenplay uses the visual and auditory language of cinema, ensuring your script maximizes the medium's storytelling potential.

Six Core Principles Analyzed

I. Visual Storytelling

• Show Don't Tell:
  • External actions revealing internal states
  • Visual metaphors instead of exposition
  • Character behavior showing emotion
• Externalization:
  • Making invisible conflicts visible
  • Physical manifestations of abstract concepts
  • Symbolic objects representing themes
• Subtext:
  • What's unsaid beneath dialogue
  • Actions contradicting words
  • Meaningful silences and pauses

II. Mise-en-scène

• Setting & Props:
  • Locations that reinforce theme
  • Symbolic objects advancing story
  • Environmental storytelling
• Lighting & Color:
  • Mood through lighting descriptions
  • Color palette supporting tone
  • Visual atmosphere creation
• Staging & Blocking:
  • Character positioning revealing relationships
  • Physical distance showing emotional distance
  • Movement patterns creating meaning

III. Cinematography

• Framing & Composition:
  • Suggested camera angles enhancing drama
  • Visual focus directing audience attention
  • Compositional balance and tension
• Point of View:
  • Perspective choices revealing character
  • Subjective camera moments
  • Visual POV shifts
• Dynamic Movement:
  • Action and motion in scenes
  • Camera movement suggestions
  • Visual energy and rhythm

IV. Editing & Rhythm

• Pacing:
  • Scene length variation
  • Beat timing and rhythm
  • Narrative momentum
• Condensation:
  • Economical storytelling
  • Eliminating redundancy
  • Every scene earning its place
• Scene Entry/Exit:
  • Starting scenes late
  • Ending scenes early
  • In medias res openings

V. Sound Design

• Sound Cues:
  • Off-screen sounds creating atmosphere
  • Diegetic sound advancing story
  • Audio foreshadowing
• Silence & Music:
  • Strategic use of quiet moments
  • Music suggestions for tone
  • Sound/silence contrast
• Dialogue Quality:
  • Naturalistic vs. stylized speech
  • Subtext in conversations
  • Silence speaking louder than words

VI. Screenplay Mechanics

• Action Line Economy:
  • Concise, visual descriptions
  • Active voice and strong verbs
  • White space and readability
• Parenthetical Usage:
  • Minimal, only when necessary
  • Trusting director and actor
  • Avoiding over-direction
• Conflict Focus:
  • Dramatic tension in every scene
  • Opposing forces colliding
  • Stakes clear and present

Understanding the Analysis

• Cinematic Score: 0-100 scale measuring cinematic language mastery
  • 90-100: Excellent - Masterful use of cinema language
  • 80-89: Good - Strong cinematic storytelling
  • 70-79: Fair - Adequate, room for improvement
  • 60-69: Poor - Needs significant cinematic enhancement
  • Below 60: Critical - Major revision needed
• Cinematic Level:
  • 🏆 Excellent: Professional mastery of cinema
  • ✅ Good: Solid understanding
  • ⚠️ Fair: Basic competence
  • ❌ Poor: Needs fundamental work
• Severity Levels:
  • 🔴 Critical: Major missed opportunities
  • 🟡 Warning: Could be more cinematic
  • ⚪ Minor: Small improvements possible

Using Cinematic Language Analysis

1. Go to Script → Craft & Style → Cinematic Language
2. Click "Analyze Cinematic Language" to start the AI analysis
3. Review your overall cinematic score and level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Explore issues organized by the six principles
6. Click "→ Go to Scene X" to jump directly to each issue
7. Read suggested improvements and implementation strategies
8. Review overall recommendations prioritized by impact
9. Export a PDF report for script revision planning

Why Cinematic Language Matters

Film is a visual and auditory medium. This analysis helps you:

• Leverage the full power of cinema rather than just dialogue
• Create memorable, visceral storytelling experiences
• Trust your audience to understand subtext
• Provide directors with rich material to interpret
• Ensure your script reads like a movie, not a novel
• Maximize emotional impact through technique

Common Issues Found

• Over-reliance on dialogue: Characters explaining instead of showing
• Missing visual details: Generic action lines lacking specificity
• Telling emotions: "She is sad" instead of showing crying, slumped posture
• Static scenes: No movement, blocking, or visual interest
• Ignoring sound: Missing opportunities for ambient audio storytelling
• Verbose action: Novelistic prose instead of clean, visual description

Improvement Strategies

• For Visual Storytelling: Convert telling to showing, add visual metaphors, use behavior
• For Mise-en-scène: Specify meaningful settings, use symbolic props, describe staging
• For Cinematography: Suggest important angles, create visual POV moments, add movement
• For Editing/Rhythm: Vary scene length, start late/end early, maintain momentum
• For Sound Design: Add ambient sounds, use silence strategically, enhance dialogue subtext
• For Mechanics: Tighten action lines, minimize parentheticals, ensure conflict

Scene Navigation

Click any issue to jump directly to that scene in your screenplay. Each issue includes the scene reference, exact problematic content, detailed explanation, and specific suggested improvement.

PDF Export

Generate comprehensive cinematic language reports including:

• Executive summary with cinematic score and level
• Complete breakdown by six core principles
• Scene-specific issue locations with context
• Prioritized recommendations by impact
• Identified strengths to maintain
• Professional format for revision planning

Strengths Recognition

The analysis also identifies what you're doing well cinematically, helping you understand your unique voice and maintain your screenplay's strongest elements during revision.

Cadence Analyzer

AI-powered analysis that examines your screenplay's dramatic tension, stakes escalation, urgency, and narrative momentum to identify "flatlines"—sequences where tension plateaus and engagement fades.

What It Analyzes

The Cadence Analyzer evaluates your screenplay scene-by-scene to identify four critical pacing issues:

• Tension Flatlines:
  • Sequences where tension plateaus for 2+ consecutive scenes
  • Static conflict with no escalation
  • Predictable outcomes that reduce suspense
  • Passive scenes where protagonist makes no progress
  • Tension plateau where stakes remain unchanged
• Stakes Static:
  • Unchanged stakes across multiple scenes
  • Low or abstract consequences
  • No risk escalation as story progresses
  • Missing personal stakes for the protagonist
  • Consequences that don't increase in severity
• Urgency Missing:
  • No time pressure forcing immediate action
  • Missing deadlines or ticking clocks
  • Characters passively waiting instead of acting
  • "We'll deal with this later" moments
  • Delayed action that reduces momentum
• Momentum Loss:
  • Narrative stalls after major scenes
  • Weak transitions between story beats
  • Anticlimactic moments that deflate tension
  • Energy drops following victories or reveals
  • False victories that don't trigger new problems

Understanding the Analysis

• Cadence Score: 0-100 scale measuring dramatic tension and pacing
  • 90-100: Excellent - Strong tension escalation throughout
  • 75-89: Good - Solid pacing with minor flat spots
  • 50-74: Fair - Several sequences need tension boost
  • Below 50: Poor - Significant cadence issues affecting engagement
• Tension Level:
  • 🟢 Excellent: Tension builds consistently, stakes escalate effectively
  • 🔵 Good: Strong narrative momentum with occasional plateaus
  • 🟡 Fair: Multiple flatlines reduce dramatic impact
  • 🔴 Poor: Static tension and stakes throughout
• Severity Levels:
  • 🔴 Critical: Flatlines spanning 3+ scenes that significantly harm engagement
  • 🟡 Warning: 2-scene plateaus that could benefit from escalation
  • ⚪ Minor: Isolated moments lacking urgency or stakes

Using Cadence Analyzer

1. Go to Script → Optimization → Cadence
2. Click "Analyze Cadence" to start the AI analysis
3. Review your cadence score and tension level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific tension/stakes issues
6. Click on any issue to jump directly to that scene
7. Review suggested techniques for boosting tension
8. Export a PDF report for revision planning

The Eight Tension-Boosting Techniques

When the Cadence Analyzer identifies flatlines or static stakes, it references these proven dramatic techniques for escalation:

1. Introduce Time Pressure (The Ticking Clock)

This is one of the most direct ways to create urgency. By imposing a deadline, you force characters to act immediately. The consequences of running out of time must be made clear and significant to the audience.

Example: A bomb set to explode or a ransom that must be paid by midnight creates instant tension.

Application: Look for scenes where characters can delay action indefinitely. Add a specific time constraint that forces immediate decisions.

2. Unleash an Antagonist Countermove

A passive villain leads to a static story. A flatline can be shattered when the antagonist makes a proactive and intelligent countermove that directly complicates the hero's plan or raises the stakes. This creates a dynamic push-pull that prevents stagnation.

Ask yourself: "What could the opposing force do right now to make things worse for the protagonist?"

Application: In sequences where tension plateaus, have the antagonist discover the hero's plan, strike preemptively, or reveal a hidden advantage.

3. Impose a Moral Dilemma

Escalate the emotional and psychological tension by forcing your protagonist into a no-win choice. A moral dilemma is a situation where any available option violates a core personal value, forcing the character to decide what they are willing to sacrifice.

Shift: The tension shifts from "Will they succeed?" to "What will this choice cost them?"

Application: When stakes feel abstract, create a choice that forces the protagonist to compromise their values or betray someone they care about.

4. Use Reversals and Surprises

A reversal is a powerful tool that upends audience expectations and turns the story on its head. If a scene is playing out predictably, inject a twist that changes everything.

Examples:

• A trusted ally is revealed to be a traitor
• A clue incriminates a friend instead of a suspect
• An escape route leads directly into a trap

Application: In predictable sequences, subvert expectations with reveals that complicate the protagonist's situation.

5. Force a Hard Decision

Corner your protagonist in a situation where they cannot have it all and must make a difficult choice under pressure. This is not always about morality but can be strategic or personal.

Example: Having to choose which of two allies to save when there isn't time to save both.

Application: The lack of a safe, easy option immediately amplifies the conflict. Remove the middle ground.

6. Create a False Victory

Allow your characters to achieve a goal, giving the audience a moment of relief, only to reveal that their success has triggered a new, more dangerous problem.

Example: The heroes retrieve the sought-after item, but it turns out to be a decoy that activates a trap.

Application: This "win, then oh-no" cadence is highly effective at maintaining momentum. Every success should carry a hidden cost or complication.

7. Narrow the Options

Systematically strip away the protagonist's resources, allies, or escape routes. By eliminating their safety nets, you funnel them into a tighter, more desperate corner.

Effect: As their options dwindle, the risk associated with each remaining choice increases, heightening the tension.

Application: Have the protagonist lose backup plans, communication devices, trusted allies, or safe havens. Make each loss meaningful.

8. Raise the Personal Stakes

A scene can feel flat if the consequences are too abstract. Make the conflict intensely personal by putting something or someone the protagonist deeply cares about in direct jeopardy.

Example: A city-wide threat becomes far more compelling when the hero's own family is in the blast radius.

Application: This reminds the audience why the conflict matters on a human level. Connect abstract threats to specific people or values the protagonist holds dear.

Understanding "Flatlines"

A flatline is a sequence of 2-3+ scenes where stakes and urgency remain static. These are dangerous narrative lulls where audience engagement fades because conflict has stalled. The Cadence Analyzer specifically identifies these patterns by tracking:

• Conflict/Goal: What does the protagonist want in each scene? What obstacle stands in their way?
• Stakes: What is at risk? Have the stakes been raised, lowered, or remained the same compared to the previous scene?
• Urgency: Is there time-sensitive pressure forcing action NOW? Any deadlines or ticking clocks?

When these elements remain unchanged across consecutive scenes, tension flatlines and the story loses momentum.

Cadence Benefits

Analyzing and improving cadence creates more engaging screenplays by:

• Identifying specific sequences where tension plateaus
• Revealing where stakes fail to escalate
• Highlighting missing urgency and time pressure
• Pinpointing momentum loss after major beats
• Providing scene-specific techniques for escalation
• Ensuring consistent dramatic engagement throughout

Context-Aware Analysis

The Cadence Analyzer uses your project context for targeted suggestions:

• Genre: Applies genre-appropriate tension patterns (thriller ticking clocks vs. drama emotional escalation)
• Character Arcs: References character relationships and arcs for personal stakes analysis
• Theme Structure: Considers your story's thematic framework when identifying meaningful escalation
• Plot Board: Uses your story structure to identify where tension should naturally escalate

Actionable Issue Details

Each cadence issue includes:

• Scene Location: Exact scene reference for quick navigation
• Issue Type: Specific flatline pattern (static conflict, no escalation, missing deadline, etc.)
• Explanation: Why this sequence creates a flatline and which technique to apply
• Original Text: The problematic sequence for reference
• Suggested Fix: Specific technique from the eight boosting strategies
• Examples: Current version vs. improved version showing escalation

PDF Export

Export a comprehensive cadence report including:

• Overall cadence score and tension level
• Scene-by-scene issue breakdown
• Specific technique recommendations
• Issue locations with context
• Before/after examples
• Identified strengths to maintain
• Professional format for revision planning

Strengths Recognition

The analysis also identifies what you're doing well with pacing and tension, helping you understand your unique voice and maintain your screenplay's strongest dramatic elements during revision.

When to Use Cadence Analyzer

• After First Draft: Identify major tension flatlines before detailed revision
• Mid-Revision: Check if your escalation attempts are working
• Before Table Read: Ensure consistent engagement throughout
• After Feedback: Address specific "boring" or "slow" notes with targeted techniques
• Before Production: Final verification that dramatic tension builds effectively

Integration with Other Tools

Cadence analysis works seamlessly with your existing workflow:

• Scene Optimizer: Use Cadence to identify where to add tension, Scene Optimizer to identify what to cut
• Character Voice: Personal stakes techniques reference character relationships and arcs
• Theme Excavation: Moral dilemma techniques tie to your thematic framework
• Plot Board: Tension escalation aligns with your story structure beats

Chunked Processing

For screenplays over 50KB, Cadence Analyzer automatically uses chunked processing:

• Splits screenplay into manageable sections
• Analyzes each section with full context
• Aggregates results across all chunks
• Maintains scene number references throughout
• Tracks tension arc across the entire screenplay

This ensures comprehensive analysis regardless of screenplay length while maintaining accuracy and performance.

Scene Optimizer

AI-powered analysis that identifies unnecessary scenes, repetitive dialogue, redundant descriptions, and pacing issues to make your screenplay more efficient and impactful.

What It Analyzes

• Unnecessary Scenes:
  • Scenes that serve no story purpose
  • Redundant scenes that repeat information
  • Mergeable scenes that can be combined
  • Scene padding that slows narrative momentum
  • Filler content that doesn't advance plot or character
• Repetitive Dialogue:
  • Characters saying the same information multiple times
  • Circular conversations that don't progress
  • Redundant exposition in dialogue
  • Similar dialogue exchanges across scenes
  • Verbose dialogue that could be streamlined
• Redundant Descriptions:
  • Repeated action descriptions
  • Over-description of simple actions
  • Unnecessary detail in action lines
  • Redundant character business
  • Verbose action lines that could be simplified
• Pacing Issues:
  • Scenes that drag and slow momentum
  • Rushed transitions between scenes
  • Loss of narrative momentum
  • Scene length problems affecting flow
  • Narrative drag that affects engagement

Understanding the Analysis

• Optimization Score: 0-100 scale measuring script efficiency
  • 90-100: Excellent - Highly efficient screenplay
  • 80-89: Good - Minor optimization opportunities
  • 70-79: Fair - Some scenes need tightening
  • 60-69: Poor - Significant optimization needed
  • Below 60: Critical - Major revision required
• Efficiency Level:
  • 🟢 Excellent: Script is lean and impactful
  • 🔵 Good: Well-structured with minor issues
  • 🟡 Fair: Needs tightening in several areas
  • 🔴 Poor: Requires significant optimization
• Severity Levels:
  • 🔴 Critical: Scenes that significantly harm pacing
  • 🟡 Warning: Elements that could be improved
  • ⚪ Minor: Small optimizations for better flow

Using Scene Optimizer

1. Go to Script → Optimization → Scene Optimizer
2. Click "Analyze Scene Efficiency" to start the AI analysis
3. Review your optimization score and efficiency level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific optimization opportunities
6. Click on any issue to jump directly to that scene
7. Review recommendations for improving script efficiency
8. Export a PDF report for production planning

Optimization Benefits

Scene optimization helps create more engaging screenplays by:

• Eliminating scenes that don't serve the story
• Tightening dialogue for better pacing
• Reducing redundant descriptions and actions
• Improving overall narrative momentum
• Creating more impactful, focused storytelling
• Helping maintain audience engagement

Common Issues Found

• Redundant Scenes: Two scenes showing the same character trait → Combine or cut one
• Repeated Information: Character explains backstory multiple times → Choose most impactful moment
• Verbose Action: "She slowly walks across the room" → "She crosses the room"
• Circular Dialogue: Characters discussing same topic without progression → Focus conversation

Optimization Strategies

• Scene Purpose: Every scene must advance plot or reveal character
• Dialogue Efficiency: Each line should serve multiple purposes
• Action Economy: Use concise, visual descriptions
• Narrative Flow: Maintain momentum through tight pacing
• Character Revelation: Show character through conflict, not exposition

Context-Aware Analysis

The Scene Optimizer uses your project context for targeted suggestions:

• Movie Concept: Considers your genre and theme for relevant optimization
• Character Data: Understands character arcs for better scene evaluation
• Plot Structure: Uses your story beats to assess scene necessity
• Theme Integration: Ensures optimizations support thematic elements

Scene Navigation

Click any optimization issue to jump directly to that location in your script. The analysis provides scene references and specific line locations for precise editing.

PDF Export

Generate detailed optimization reports including:

• Executive summary with optimization score
• Category breakdown of all identified issues
• Specific scene locations and recommendations
• Optimization strategies tailored to your script
• Production-ready format for development discussions

Working with Recommendations

The Scene Optimizer provides actionable recommendations prioritized by impact:

• High Priority: Critical changes that significantly improve pacing
• Medium Priority: Important optimizations for better flow
• Low Priority: Minor tweaks for polish

Best Practices

• Run analysis after completing your first draft
• Focus on high-priority issues first
• Consider the cumulative effect of multiple small optimizations
• Preserve essential character moments and thematic beats
• Re-run analysis after major revisions to track improvement

Final Polish

AI-powered dialogue and parenthetical analysis that ensures your screenplay is ready for production by identifying and fixing common dialogue issues.

What It Analyzes

• Overuse of Parentheticals:
  • Redundant parentheticals that repeat dialogue emotion
  • Excessive acting directions
  • Unnecessary mood indicators
  • Micro-directing through parentheticals
• Micro-Directing:
  • Overly specific acting instructions
  • Camera angle suggestions in dialogue
  • Detailed emotional expressions
  • Performance directions that limit actor interpretation
• Character Voice Issues:
  • Indistinct character speech patterns
  • Characters that sound too similar
  • Missing unique vocal characteristics
  • Inconsistent character vocabulary
• On-the-Nose Dialogue:
  • Characters stating emotions directly
  • Exposition without subtext
  • Overly literal conversations
  • Missing dramatic irony

Understanding the Analysis

• Polish Score: 0-100 scale measuring dialogue and parenthetical quality
  • 90-100: Excellent - Production-ready dialogue
  • 80-89: Good - Minor refinements needed
  • 70-79: Fair - Notable issues to address
  • 60-69: Poor - Significant revision required
  • Below 60: Critical - Major dialogue rewrite needed
• Severity Levels:
  • 🔴 Critical: Issues that significantly impact production
  • 🟡 Warning: Problems that should be addressed
  • ⚪ Minor: Small improvements that enhance quality

Using Final Polish Analysis

1. Go to Script → Optimization → Final Polish
2. Click "Analyze Final Polish" to start the AI analysis
3. Review your overall polish score and level
4. Check the severity breakdown (Critical/Warning/Minor)
5. Expand each category to see specific issues
6. Click "Go to Scene" to jump directly to problems
7. Use the copy buttons to copy current text or suggested fixes
8. Export a PDF report for reference during rewrites

Key Features

• Scene Navigation: Click any issue to jump directly to that location in your script
• Copy Assistance: Copy current text or suggested improvements with one click
• Context Awareness: Analysis considers your movie concept, theme, and characters
• Chunked Processing: Handles large screenplays by analyzing in manageable sections
• Professional Reports: Export comprehensive PDF reports with all findings

Production Benefits

Final Polish analysis specifically helps prepare for production by:

• Ensuring actors can deliver natural, believable dialogue
• Removing micro-directing that limits performance choices
• Creating distinct, memorable character voices
• Eliminating parentheticals that slow down reads
• Improving dialogue flow for table reads
• Identifying script elements that may cause production delays

Understanding the Feedback

Each identified issue includes:

• Location: Specific scene reference for easy navigation
• Current Text: The problematic dialogue or parenthetical
• Suggested Fix: Concrete improvement recommendation
• Explanation: Why the change improves the script
• Industry Context: Professional standards and best practices

Common Issues Found

• Redundant Parentheticals: "(angrily)" when dialogue already shows anger
• Micro-Directing: "(with a slight pause, then smiling)" - too specific for actors
• Character Voice: All characters speaking with same vocabulary/rhythm
• On-the-Nose: "I'm so angry!" instead of showing anger through subtext

Best Practices for Dialogue

• Trust Your Actors: Avoid over-directing performances
• Show Don't Tell: Let dialogue reveal emotion through subtext
• Unique Voices: Give each character distinct speech patterns
• Natural Flow: Write dialogue that sounds conversational when read aloud
• Less is More: Use parentheticals sparingly and only when essential

Integration with Other Tools

Final Polish works seamlessly with your existing workflow:

• Considers character profiles from your Characters section
• References movie concept and theme structure for context
• Complements Readability and Common Flaws analyses
• Integrates with scene navigation and commenting systems

Large Screenplay Support

For screenplays over 50KB, Final Polish automatically uses chunked processing:

• Breaks screenplay into manageable sections
• Maintains analysis quality across all chunks
• Provides progress tracking during analysis
• Consolidates results into unified report
• Ensures no content is missed or duplicated

PDF Export Features

Generate comprehensive reports including:

• Executive summary with polish score and recommendations
• Complete issue breakdown by category and severity
• Scene-specific problem locations with examples
• Before/after text comparisons
• Detailed explanations for each suggested improvement
• Professional format suitable for sharing with collaborators

When to Use Final Polish

• Before Table Reads: Ensure smooth dialogue delivery
• Pre-Production: Eliminate potential on-set confusion
• After Major Rewrites: Check dialogue consistency
• Before Submissions: Professional-quality dialogue polish
• Collaboration Reviews: Standardize dialogue quality

Production Menu Overview

The Production menu provides comprehensive tools for taking your screenplay from pitch to screen, organized by production workflow phases:

Marketing

Business and promotional materials:

• Pitch Deck - Professional presentation for investors and studios
• Trailer - AI-generated promotional trailer with voiceover and music

Pre-Production

Essential preparation and planning tools:

• Table Read - AI-powered voice performances of your screenplay
• Logistical Breakdown - Production scheduling and resource planning

Design System

Comprehensive visual design and continuity management:

• Visual Themes - Color palettes, lighting styles, and visual motifs
• Location Design - Detailed location references and requirements
• Character Styling - Wardrobe, makeup, and character appearance
• Prop Library - Prop references and tracking
• Continuity Check - Validate design consistency across screenplay

Creative Planning

Detailed creative and production planning documents:

• Look Book - Visual inspiration and reference collection
• Creative Breakdown - Scene-by-scene creative analysis
• Actor Breakdown - Character descriptions for casting

Shot Planning

Cinematography and visual storytelling tools:

• Shot List - Detailed shot-by-shot planning
• Staging & Blocking - Actor movement and camera positioning
• Storyboard - AI-generated visual pre-visualization

Table Read

Generate AI-powered table reads of your screenplay with professional-quality voices using Google Cloud Text-to-Speech technology. Perfect for hearing your dialogue performed before production.

Setup Requirements

To use Table Read, you'll need a Google Cloud Text-to-Speech API key:

1. Visit the Google Cloud Text-to-Speech page
2. Create a Google Cloud project and enable the Text-to-Speech API
3. Generate an API key with Text-to-Speech permissions
4. In NoosphereWriter, go to Settings → Text-to-Speech
5. Enter your API key and enable the service

Voice Selection Features

• Automatic Character Detection: Identifies all speaking characters in your screenplay
• Smart Voice Matching: Suggests appropriate voices based on character gender and role
• 50+ Professional Voices: Access to Google's premium Chirp HD voice collection
• Voice Preview: Test each voice before generating the full table read
• Custom Assignments: Manually assign specific voices to each character

Audio Generation Process

1. Go to Production → Pre-Production → Table Read
2. Review detected characters and their assigned voices
3. Click preview buttons to test voice selections
4. Adjust voice assignments as needed
5. Click "Generate Table Read" to create the audio
6. Use playback controls to listen to your screenplay
7. Download the complete audio file for offline use

What Gets Voiced

• Scene Headings: Narrated with a professional, neutral voice (Iapetus)
• Action Lines: Read by the narrator to provide scene context
• Character Dialogue: Spoken by the assigned character voices
• Parentheticals: Integrated naturally into dialogue delivery
• Transitions: Announced by the narrator for scene flow

Audio Controls

• Play/Pause: Start and stop playback at any time
• Progress Tracking: Visual indicator of current position
• Scene Navigation: Jump to specific scenes or dialogue
• Volume Control: Adjust playback volume
• Download Option: Save the complete table read as an MP3 file

Voice Quality Features

• Chirp HD Technology: Google's highest-quality neural voices
• Natural Delivery: Advanced prosody and emotion recognition
• Consistent Performance: Reliable voice characteristics throughout
• Professional Quality: Studio-grade audio output at 24kHz
• Character Distinction: Clear vocal differences between characters

Production Benefits

Table Read helps your production process by:

• Dialogue Testing: Hear how lines sound when spoken aloud
• Pacing Review: Identify scenes that drag or rush
• Character Voice Development: Inspire actors with vocal direction
• Script Timing: Estimate actual performance duration
• Remote Collaboration: Share table reads with distributed teams
• Investor Presentations: Engaging script demos for funding pitches

Character Voice Assignments

The system automatically suggests voices based on:

• Character Gender: Male/female voice matching from character data
• Age Appropriateness: Young adult, mature, and senior vocal qualities
• Role Importance: Distinctive voices for main characters
• Conflict Avoidance: Ensures different characters have distinct voices
• Professional Standards: All voices suitable for industry presentations

Best Practices

• Clean Scripts: Ensure proper formatting for best voice recognition
• Character Consistency: Use consistent character names throughout
• Preview First: Test voice assignments before full generation
• Save Audio: Download important table reads for future reference
• Share Thoughtfully: Consider voice rights when sharing with third parties

Integration with Other Features

Table Read works seamlessly with:

• Character Profiles: Uses character data for voice matching
• Scene Navigation: Jump to specific scenes during playback
• Google Drive Sync: Character data syncs across devices
• Export Functions: Include table read notes in script exports

When to Generate Table Reads

• First Draft Complete: Initial script review and dialogue testing
• Before Pitch Meetings: Engaging presentation material
• Pre-Production Planning: Timing and pacing assessment
• Actor Auditions: Reference material for character voices
• Remote Collaboration: Share script experience with distant partners

Privacy and Usage

• Your API Key: Stored encrypted in browser local storage only
• Script Privacy: Your screenplay text is sent only to Google's TTS service
• No Server Storage: Audio files are generated client-side
• Local Caching: Generated audio stored in browser cache for replay
• Commercial Use: Follow Google Cloud TTS terms for commercial projects

Troubleshooting

• No Audio Generated: Check API key configuration in Settings
• Poor Voice Quality: Ensure stable internet connection
• Missing Characters: Verify character names are properly formatted
• Playback Issues: Clear browser cache and regenerate audio
• Download Problems: Check browser permissions for file downloads

Shot List

Generate professional industry-standard shot lists for your screenplay using AI-powered analysis. Creates production-ready shot lists that match the format used by 1st ADs, DPs, and professional production teams.

Overview

The Shot List feature transforms your written screenplay into a detailed visual production plan using industry-standard formatting. Using expert cinematography knowledge and a systematic 5-step process, it analyzes each scene to create comprehensive shot breakdowns with all the technical specifications production teams need.

Industry-Standard Format

Shot lists follow the professional production worksheet format used in film and television, including all fields required for:

• 1st Assistant Director: Setup numbers for scheduling and crew coordination
• Director of Photography: Lens specifications, equipment requirements, and technical notes
• Sound Department: Recording requirements (dialogue, MOS, playback, wild track)
• Script Supervisor: Continuity notes and shot dependencies
• Production Designer: VFX requirements and special elements

How It Works

The AI follows a proven 5-step cinematographic process for each scene:

1. Analyze the Core Drama: Identifies the emotional beats, conflicts, and story objectives
2. Visualize the Space and Blocking: Maps character movements and spatial relationships
3. Identify Key Visual Moments: Pinpoints crucial story beats that need specific coverage
4. Select Appropriate Shots: Chooses optimal shot types, angles, equipment, and camera movements
5. Assemble the Shot List: Creates a production-ready sequence with complete technical specifications

Cinematographer's Toolkit Integration

Each shot recommendation draws from professional cinematography knowledge including:

• Shot Types: From extreme wide establishing shots to extreme close-ups
• Camera Angles: Eye level, high angle, low angle, bird's eye, worm's eye
• Framing Options: Wide, medium, close-up, extreme variations
• Camera Movements: Static, pan, tilt, dolly, crane, steadicam, handheld
• Equipment Types: Tripod, handheld, dolly, steadicam, crane, drone
• Lens Selection: Standardized focal lengths (e.g., 28mm, 35mm, 50mm, 85mm)
• Sound Recording: Dialogue, MOS, playback, wild track
• Transitions: Cut, fade, dissolve, wipe, match cut, jump cut

Using Shot List

1. Go to Production → Shot Planning → Shot List
2. The system automatically analyzes your entire screenplay
3. Review the generated shot list in the interactive table with industry-standard columns:
• Shot #: Shot number in final edit sequence
• Setup #: Camera setup position (e.g., "1A", "1B", "2A") for 1st AD scheduling
• Shot Type: Camera distance (Wide Shot, Medium Shot, Close Up, etc.)
• Characters: Which characters appear in the shot
• Lens: Focal length specification (e.g., "35mm", "85mm")
• Equipment: Required camera support (Tripod, Dolly, Crane, Steadicam, etc.)
• Movement: Camera movement type (Static, Pan, Tilt, Push In, etc.)
• Sound: Recording requirements (Dialogue, MOS, Playback, Wild Track)
• Duration: Estimated shot duration in seconds
• Content: Action description and dialogue
• Notes: Department-specific notes organized by role
4. View structured notes organized by department:
   • Director Notes: Performance direction, timing, emotional intent
   • DP Notes: Lighting, camera technical specifications
   • Continuity Notes: Script supervisor tracking, shot dependencies
   • VFX Notes: Special effects, post-production requirements
   • General Notes: Other production information
5. Export results as CSV or PDF for production use

Shot List Output

Each generated shot list includes complete production specifications:

• Executive Summary: Total scenes, shots, average shots per scene, and total estimated duration
• Scene-by-Scene Breakdown: Detailed shot lists organized by scene
• Complete Shot Details:
  • Shot Number: Sequential numbering for final edit
  • Setup Number: Camera position grouping for efficient shooting
  • Shot Type: Camera distance (Establishing, Wide, Medium, Close Up, etc.)
  • Camera Angle: Vertical positioning (Eye Level, High Angle, Low Angle, etc.)
  • Lens Specification: Standardized focal length (e.g., "35mm", "85mm")
  • Equipment Required: Camera support system needed
  • Camera Movement: Movement type and direction
  • Sound Recording: Audio recording requirements
  • Estimated Duration: Calculated shot length based on content
  • Character Action: What happens in the shot
  • Dialogue: Lines spoken in the shot
  • Location Details: Setting and spatial information
  • Structured Notes: Department-specific production information
• Production-Ready Format: Industry-standard terminology and organization

Context-Aware Analysis

Shot List generation considers your screenplay's context for more accurate recommendations:

• Movie Concept: Genre and theme influence shot selection
• Character Profiles: Character relationships affect coverage choices
• Theme Structure: Thematic elements guide visual emphasis
• Location Details: Setting information impacts shot possibilities

Large Screenplay Support

For screenplays over 50,000 characters, the system automatically uses chunked processing:

• Scene-Based Chunking: Maintains story continuity
• Rate-Limited Processing: Respects API limits with 2-second delays
• Progress Tracking: Real-time status updates during processing
• Comprehensive Results: Aggregated shot lists with summary statistics

Export Options

• CSV Export: Tab-separated format perfect for spreadsheet applications with all 16 industry-standard columns:
  • Scene, Shot #, Setup #, Description, Shot Size, Angle, Movement
  • Lens (mm), Equipment, Sound, Duration (s)
  • Director Notes, DP Notes, Continuity, VFX, General Notes
• PDF Export: Professional formatted document including:
  • Shot headers with setup numbers and technical specifications
  • Complete technical specs line (Lens | Equipment | Movement | Sound | Duration)
  • Characters, location, action description, and dialogue
  • Structured notes organized by department
• Production-Ready: Industry-standard formatting matching professional production worksheets
• Department-Specific: Organized information for 1st AD, DP, Sound, Script Supervisor, and VFX teams
• Shareable: Easy distribution to all production departments and crew heads

Production Benefits

Shot List helps your production process by:

• Pre-Production Planning: Complete technical specifications before cameras roll
• 1st AD Scheduling: Setup numbers enable efficient shooting order and crew coordination
• Director Preparation: Visual roadmap with performance notes for each scene
• Cinematographer Collaboration: Equipment and lens specifications for technical planning
• Equipment Planning: Know exactly what camera support is needed (dolly, crane, steadicam, etc.)
• Sound Department Coordination: Clear recording requirements for every shot
• Budget Estimation: Equipment needs and duration estimates for accurate scheduling
• Crew Communication: Department-specific notes for all production roles
• Script Supervisor Support: Continuity notes and shot dependencies tracked
• Storyboard Foundation: Technical details inform detailed visual planning

Intelligent Technical Specifications

The system automatically infers technical requirements based on creative choices:

• Equipment Inference: Camera movements automatically determine equipment needs:
  • Dolly, Push In, Truck movements → Dolly track required
  • Crane Up/Down → Crane or jib needed
  • Handheld, Shake → Handheld operation
  • Smooth tracking shots → Steadicam recommended
  • Static or simple pan/tilt → Tripod sufficient
• Duration Calculation: Shot length estimated based on content:
  • Dialogue length (150 words per minute average speaking rate)
  • Shot type (close-ups typically 2-3s, establishing shots 6-8s)
  • Action complexity (longer descriptions = more time needed)
• Sound Recording: Automatically determined by shot content:
  • Shots with dialogue → Dialogue recording required
  • Extreme close-ups → Wild track for ambient sound
  • Shots without dialogue → MOS (Motor Only Sync - silent take)
• Lens Selection: Appropriate focal lengths for shot types:
  • Wide/establishing shots → 28mm or 35mm
  • Standard coverage → 50mm
  • Close-ups and portraits → 85mm
• Setup Grouping: Shots with similar camera positions share setup numbers for efficient shooting order

Integration with Other Features

Shot List works seamlessly with:

• Character Profiles: Uses character data for coverage decisions
• Location Manager: Considers setting details for shot selection
• Theme Structure: Aligns visual choices with thematic elements
• Script Breakdown: References breakdown data for prop and wardrobe continuity
• Storyboard Generation: Shot lists serve as foundation for visual storyboards
• Google Drive Sync: Shot lists sync across devices

When to Generate Shot Lists

• Pre-Production: Essential step before filming begins
• Director Prep: Visual planning with performance notes for scene execution
• Cinematographer Meetings: Discussion foundation with technical specifications
• Production Meetings: Department coordination with setup numbers and notes
• Budget Planning: Equipment needs and duration estimates for cost analysis
• Equipment Rental: Specific list of camera support equipment needed (dolly, crane, steadicam)
• Storyboard Planning: Technical details inform detailed visual planning
• Schedule Creation: Setup numbers and durations for accurate call sheets
• Sound Department Prep: Recording requirements for each shot

Professional Guidelines

• Starting Point: Shot lists are professional suggestions, not rigid requirements
• Creative Flexibility: Directors should adapt recommendations to their vision
• Production Reality: Consider budget, time, and location constraints when modifying
• Collaboration Tool: Use shot lists to facilitate creative discussions between departments
• Department Communication: Structured notes help each department understand their requirements
• Iterative Process: Refine shot lists through pre-production development and tech scouts
• Technical Verification: Always verify equipment availability and location feasibility

Privacy and Usage

• Your API Key: Stored encrypted in browser local storage only
• Script Privacy: Your screenplay content is processed only for shot analysis
• No Server Storage: Shot lists are generated and stored locally
• Professional Use: Generated shot lists are suitable for commercial productions
• Export Freedom: Download and use shot lists in any production workflow

Troubleshooting

• No Shot List Generated: Check API key configuration in AI Assistant Settings
• Incomplete Analysis: Ensure screenplay has proper scene formatting
• Processing Errors: Verify stable internet connection for large screenplays
• Export Issues: Check browser permissions for file downloads
• Performance: Large screenplays may take several minutes to process

Storyboard

Transform your screenplay into professional-quality visual storyboards using advanced AI image generation. Create cinematic visual previews that help directors, cinematographers, and production teams visualize scenes before filming.

Overview

The Storyboard feature uses a sophisticated two-stage generation process combining shot list analysis with high-quality image generation. First, it creates consistent character and location assets, then composes them into storyboard panels that maintain visual continuity throughout your entire screenplay.

How It Works

The storyboard generation follows a professional two-stage process:

1. Asset Generation: Creates high-quality character and location assets using Imagen 4, ensuring visual consistency across all panels
2. Panel Composition: Composes individual storyboard panels using Nano Banana, combining assets with proper framing and cinematography
3. Smart Caching: Reuses generated assets across multiple panels for consistency and faster generation
4. Progressive Generation: Creates panels scene by scene with real-time progress updates

Three-Tab Workflow

The storyboard interface is organized into three main tabs:

• Shot Selection: Choose which scenes and shots to visualize from your shot list
• Assets: View and manage generated character and location reference images
• Results: Review your completed storyboard panels and export to PDF

Using Storyboard

1. Go to Production → Shot Planning → Storyboard
2. The system automatically generates a shot list for your screenplay
3. In the Shot Selection tab:
• Review the generated shots organized by scene
• Select individual shots or entire scenes to visualize
• Click "Generate Storyboard" to begin the process
4. Monitor progress through two phases:
• Phase 1: Asset generation (characters, locations, props)
• Phase 2: Panel composition (combining assets into storyboard frames)
5. Review results in the Results tab and export as PDF

Asset Management

The Assets tab provides powerful control over visual consistency:

• Character Assets: Reference sheets showing main characters with consistent appearance, clothing, and accessories
• Location Assets: Environmental backgrounds for interior and exterior settings
• Smart Caching: Assets are automatically reused across panels for visual consistency
• Asset Regeneration: Clear and regenerate assets when character or location data changes
• Rich Data Integration: Uses detailed character and location information from Script menus

Advanced Features

• Over the Shoulder Shots: Specialized handling for OTS shots that properly show characters from behind
• Character Consistency: Maintains accessories like glasses, hats, and distinctive clothing across panels
• Spatial Coherence: Advanced occlusion rules ensure characters sit properly in furniture without clipping through structures, with realistic depth layering
• Location Extraction: Automatically parses scene headings to identify locations, including compound locations
• Professional Style: Black and white line drawing style suitable for production use
• Cinematographer Integration: Works with shot list data for proper framing, camera angles, and camera movements
• Camera Movement Visualization: Each panel displays the camera movement (static, pan, dolly, push in, etc.) for production reference

Shot Selection Features

• Scene-Level Selection: Select all shots in a scene with one click
• Individual Shot Control: Choose specific shots for targeted visualization
• Shot Details: Each shot shows type, camera angle, camera movement, action, and character information
• Camera Specifications: Displays shot type (close-up, medium, wide), camera angle (straight on, down shot, up shot), and camera movement (static, pan, dolly, push in, etc.)
• Smart Filtering: Focus on key dramatic moments or specific scenes
• Batch Processing: Generate multiple panels efficiently with progress tracking

Asset Regeneration

When you update character profiles or location details in the Script menus:

1. Go to the Assets tab
2. Click "Clear Assets" to remove cached character and location images
3. Confirm the action in the dialog
4. Return to Shot Selection and generate fresh storyboards
5. New assets will incorporate your updated character and location information

Over the Shoulder Shot Handling

The system includes specialized processing for Over the Shoulder (OTS) shots:

• Automatic Detection: Identifies OTS shots from camera angle information
• Proper Framing: Shows foreground character from behind looking toward the subject
• Relaxed Requirements: Doesn't enforce facial accessories (glasses, etc.) for back-facing characters
• Cinematic Composition: Maintains proper OTS framing conventions

Export and Sharing

• PDF Export: Professional-quality PDF suitable for production teams
• Panel Organization: Storyboards organized by scene with clear labeling
• Complete Shot Information: Each panel includes shot type, camera angle, camera movement, characters, and action description
• Production Ready: Industry-standard format for pre-production planning with full cinematography specifications
• High Resolution: Generated images maintain quality for presentation
• Shareable: Easy distribution to directors, cinematographers, and department heads

Integration with Script Data

Storyboard generation leverages comprehensive script data:

• Character Profiles: Uses character descriptions, relationships, and physical details
• Location Manager: Incorporates location descriptions, props, and atmosphere notes
• Scene Analysis: Considers dialogue, action, and dramatic context
• Movie Concept: Adapts visual style to genre and tone
• Theme Structure: Aligns visual choices with thematic elements

Production Benefits

Storyboards enhance your production workflow by providing:

• Visual Clarity: Clear visual reference for complex scenes
• Director Preparation: Pre-visualization for shot planning
• Crew Communication: Shared visual language across departments
• Problem Identification: Spot potential blocking or staging issues early
• Client Presentations: Professional visuals for pitch meetings
• Budget Planning: Visual complexity assessment for cost estimation
• Schedule Optimization: Better understanding of shot requirements

Output Specifications

• Aspect Ratio: 16:9 widescreen format suitable for film production
• Style: Black and white line drawings in professional storyboard style
• Resolution: High-resolution images suitable for presentation and print

Recent Enhancements

• Camera Movement Integration: Shot list now includes structured camera movement data (static, pan, dolly, push in, etc.) displayed with each panel
• Enhanced Spatial Coherence: Advanced occlusion rules prevent characters from sitting through furniture structures like chair frames
• Improved Depth Layering: Characters properly positioned between furniture elements with realistic front/back relationships
• Furniture-Specific Handling: Specialized processing for beach chairs, office chairs, cockpits, and desks ensures realistic character placement
• PDF Export Enhancement: Camera angle and movement information now included in exported storyboard PDFs
• Text-Free Panels: Improved prompting eliminates dialogue overlays and subtitle-like text from visual compositions

Best Practices

• Start Small: Begin with key scenes to test the visual style
• Update Script Data: Ensure character and location profiles are detailed
• Review Assets: Check generated assets before creating multiple panels
• Selective Generation: Focus on complex scenes that benefit from visualization
• Iterative Process: Generate, review, and refine as needed

When to Use Storyboards

• Pre-Production: Visual planning for complex scenes
• Director Meetings: Communicate vision to department heads
• Client Pitches: Visual presentation of key scenes
• Action Sequences: Complex choreography and staging
• VFX Planning: Visual effects integration planning
• Location Scouting: Reference for desired visual compositions
• Budget Meetings: Visual complexity assessment

Troubleshooting

• Assets Not Generating: Check API key configuration and internet connection
• Inconsistent Characters: Use "Clear Assets" to regenerate with updated character data
• Wrong Locations: Verify scene headings use standard format (INT./EXT. LOCATION - TIME)
• Generation Failures: Large batches may require multiple attempts due to rate limits
• Export Issues: Check browser permissions for PDF downloads
• Performance: Generation time depends on number of selected shots and asset complexity

Privacy and Data Usage

• Your API Key: Stored encrypted in browser local storage only
• Script Privacy: Screenplay content processed only for storyboard generation
• Image Generation: Generated images are created specifically for your project
• No Server Storage: Storyboards generated and stored locally in your browser
• Professional Use: Generated storyboards suitable for commercial productions
• Export Freedom: Download and use storyboards in any production workflow

Staging & Blocking

Professional scene staging and blocking visualizer using a 2D canvas interface. Plan actor movements, camera positions, and set piece placements with precise control for every shot in your screenplay.

Overview

The Staging & Blocking feature provides a visual workspace where you can plan the physical choreography of your scenes. Using an intuitive 2D top-down canvas, you can position characters, place cameras with field-of-view visualization, add props and set pieces, and map out movement paths—all integrated with your Shot List data for shot-by-shot precision.

How It Works

Staging & Blocking uses a shot-based approach integrated with your Shot List:

1. Scene Selection: Choose a scene from your screenplay to stage
2. Shot List Integration: Automatically loads shots from your Shot List for the selected scene
3. Shot-by-Shot Staging: Create independent staging diagrams for each shot (setup) with unique token positions
4. Token Placement: Add characters, cameras, and props to the canvas with visual representations
5. Canvas Controls: Use grid snapping, zoom, pan, and rotation controls for precise positioning
6. PDF Export: Generate professional staging documents with diagrams for production teams

Three Types of Tokens

The canvas supports three types of staging elements:

• Character Tokens (Blue): Represent actors with directional facing, character levels (standing, sitting, kneeling, lying), and power dynamics visualization
• Camera Tokens (Red): Represent camera positions with field-of-view cones, lens types (wide, medium, tight), and rotation control
• Prop Tokens (Green): Represent set pieces, furniture, and interactive props with static or interactive designations

Using Staging & Blocking

1. Go to Production → Shot Planning → Staging & Blocking
2. In the Select Scene tab:
• Choose a scene from your screenplay
• The system automatically loads Shot List data for that scene
• Select a specific shot (setup) to stage
3. In the Stage Design tab:
• Add character tokens using the "Add Character" button
• Add camera tokens using the "Add Camera" button
• Add prop tokens using the "Add Prop" button
• Click tokens to select and modify their properties
• Drag tokens on the canvas to reposition them
• Add staging notes specific to each shot
4. Export your staging diagrams as PDF for production distribution

Character Token Features

Character tokens provide detailed actor positioning controls:

• Character Levels: Standing, sitting, kneeling, or lying positions for power dynamics visualization
• Facing Direction: 360-degree rotation control to show which direction the character faces
• Visual Scaling: Automatic size adjustment based on character level (sitting characters appear smaller)
• Character Integration: Links to Character data from Script menu for reference
• Color Coding: Blue coloring for easy identification on the canvas
• Name Labels: Character names displayed on each token

Camera Token Features

Camera tokens visualize shot framing and coverage:

• Field of View Cone: Visual representation of what the camera sees based on lens type
• Lens Types: Wide (75° FOV), medium (50° FOV), or tight (30° FOV) lens settings
• Rotation Control: 360-degree rotation to aim the camera at subjects
• Camera Labels: Custom labels like "A-Cam", "B-Cam", or "Shot 1A"
• Shot List Integration: Camera type and angle from Shot List metadata
• Color Coding: Red coloring for easy identification on the canvas

Prop Token Features

Prop tokens represent set pieces and interactive objects:

• Static vs Interactive: Distinguish between set dressing and hero props
• Prop Categories: Hand props, personal items, set pieces, and hero props
• Spatial Roles: Define furniture, obstacles, or interactive elements
• Prop Library Integration: Links to Prop Library data when available
• Color Coding: Green for interactive props, gray for static set pieces
• Scale Control: Adjust size to represent different prop dimensions

Canvas Controls

The staging canvas provides professional-grade positioning tools:

• Grid System: Configurable grid with adjustable cell size for precise placement
• Snap to Grid: Toggle grid snapping for aligned positioning or freeform placement
• Zoom Control: Zoom in/out to work at different detail levels
• Pan Control: Pan the canvas to focus on different areas of the stage
• Show/Hide Grid: Toggle grid visibility for cleaner export diagrams
• Independent Settings: Each shot has its own canvas settings (zoom, pan, grid)

Shot-Based Staging Architecture

Unlike traditional stage plotting, this system uses shot-based staging for maximum precision:

• Shot List Integration: Each shot from your Shot List gets its own staging diagram
• Independent Canvas State: Token positions, camera placement, and canvas settings are unique per shot
• Setup Numbers: Supports multiple setups per scene (1A, 1B, 2A, etc.)
• Shot Metadata: Displays shot type, camera angle, and camera movement for each shot
• Sequential Workflow: Move through shots in sequence to plan coverage systematically

PDF Export Features

Export professional staging documents for your production team:

• Title Page: Includes script title, total scenes, and staged shots count
• Scene Organization: Scenes sorted numerically with proper page breaks
• Shot Details: Each shot includes panel number, setup number, shot type, camera angle, and camera movement
• Canvas Diagrams: High-resolution canvas images showing token positions (2x resolution for print quality)
• Token Lists: Lists of characters, cameras, and props for each shot
• Staging Notes: Shot-specific and scene-level notes included
• Summary Page: Overview with scene breakdown and staging statistics
• Optional Diagrams: Choose to include or exclude canvas images in the export

Integration with Other Features

Staging & Blocking works seamlessly with other production tools:

• Shot List: Automatically loads shot data including type, angle, and movement
• Characters: Access character data from Script → Characters for reference
• Locations: Reference location information from Script → Locations
• Location Design: Import static props and set pieces from location designs
• Prop Library: Reference prop data from Production → Design System → Prop Library
• Creative Breakdown: Use scene breakdown data for character and prop context

Data Persistence

Your staging work is automatically saved and managed:

• Auto-Save: Staging data automatically saved to browser local storage
• Script-Specific Storage: Each screenplay maintains its own staging data
• Timestamped Changes: Last edited timestamps track when each shot was modified
• No Server Upload: All data stored locally in your browser for privacy

Workflow Example

Typical workflow for staging a scene:

1. Open Staging & Blocking and select Scene 5
2. Shot List shows 6 shots for this scene (setups 1A through 3B)
3. Select Shot 1A (wide establishing shot):
• Add camera token, position it for wide angle coverage
• Set lens to "wide" for 75° field of view
• Add two character tokens at their starting positions
• Set both characters to "standing" level
• Add desk and chair prop tokens from location design
• Add staging note: "Both characters enter frame from stage right"
4. Move to Shot 1B (over-the-shoulder on Character A):
• Reposition camera token for OTS framing
• Set lens to "medium" for 50° field of view
• Rotate Character A to face Character B
• Update staging note: "A listens while B delivers exposition"
5. Continue through remaining shots, building coverage
6. Export PDF with diagrams for director and AD review

Production Benefits

Staging & Blocking enhances your pre-production workflow:

• Visual Communication: Clear diagrams for director-DP collaboration
• Coverage Planning: Ensure complete scene coverage with no gaps
• Blocking Preparation: Pre-plan actor movements and marks
• Continuity Reference: Visual record for matching shots during filming
• Efficient Shooting: Optimize camera setups and lighting transitions
• Problem Detection: Identify staging conflicts before the shoot day
• Crew Briefing: Share diagrams with camera, grip, and lighting teams

Best Practices

• Start with Master Shots: Establish overall geography before coverage
• Use Shot List First: Generate Shot List before staging for complete shot data
• Consistent Scale: Maintain token scale proportions for spatial accuracy
• Clear Labels: Use descriptive camera labels (A-Cam, B-Cam, etc.)
• Stage Key Scenes: Focus on complex blocking and action sequences
• Add Context Notes: Use staging notes to clarify actor motivations
• Export with Diagrams: Include canvas images for visual reference

Character Level Reference

Understanding character levels for power dynamics:

• Standing: Full height, dominant position, visual scale 1.0
• Sitting: Reduced height, neutral position, visual scale 0.75
• Kneeling: Low position, submissive or searching, visual scale 0.5
• Lying: Prone position, vulnerable or deceased, visual scale 0.3

Camera Lens Reference

Understanding lens types and their field of view:

• Wide Lens: 75° FOV, equivalent to 35mm lens, shows broad environment
• Medium Lens: 50° FOV, equivalent to 50mm lens, natural perspective
• Tight Lens: 30° FOV, equivalent to 85mm lens, compressed depth, close-ups

When to Use Staging & Blocking

• Complex Action: Fight scenes, chase sequences, large group movements
• Emotional Choreography: Scenes where physical distance reflects emotional state
• Coverage Planning: Ensure you have all angles for proper editing
• Location Scouting: Reference diagrams for space requirements
• Director Prep: Visual planning before rehearsals
• Production Meetings: Share staging plans with department heads
• Multi-Camera Shoots: Plan simultaneous camera positions

Troubleshooting

• No Shots Appearing: Generate Shot List first (Production → Shot Planning → Shot List)
• Canvas Too Small: Increase grid width/height in canvas settings
• Tokens Not Snapping: Toggle "Snap to Grid" in canvas settings
• PDF Missing Diagrams: Ensure "Include Canvas Images" is checked during export
• Token Positioning Reset: Each shot has independent token positions—verify you're on the correct shot
• Export Not Working: Check browser permissions for PDF downloads

Privacy and Data Storage

• Local Storage Only: All staging data stored in browser local storage
• No Cloud Sync: Staging diagrams never uploaded to external servers
• Script-Specific Keys: Staging data organized by script title
• Canvas Privacy: PDF exports generated locally without external rendering

Logistical Breakdown

Industry-standard production breakdown analysis following 1st Assistant Director conventions. Generate comprehensive scene breakdowns with cast, props, wardrobe, vehicles, stunts, visual effects, and detailed visual descriptions for production planning.

Two-Phase Generation Process

The Logistical Breakdown feature uses an advanced two-phase AI generation system to create complete production breakdowns:

• Phase 1 - Standard Breakdown: Analyzes screenplay for all production elements following industry-standard categories
• Phase 2 - Visual Descriptions: Generates detailed visual profiles for characters and locations
• Scene-by-Scene Processing: Progressive generation with real-time updates for each scene
• Smart Caching: Results saved locally for instant access without regeneration
• Production-Ready Output: Professional formatting suitable for department distribution

Logistical Breakdown Categories

Every scene breakdown includes these industry-standard production elements:

• Cast: Speaking and non-speaking characters for talent scheduling
• Extras: Featured extras and atmosphere players with estimated counts
• Props: Hand props, personal props, set props, and hero props with character associations
• Set Dressing: Environmental items and background elements
• Wardrobe: Costume requirements per character with scene-specific details
• Makeup & Hair: Special makeup effects, prosthetics, and hair styling needs
• Vehicles & Animals: Picture vehicles, stunt vehicles, and animal talent
• Stunts: Stunt requirements with safety considerations
• Special Effects (SFX): Practical effects, pyrotechnics, and mechanical effects
• Visual Effects (VFX): Digital effects, green screen, and post-production needs
• Sound: Diegetic sound effects and special audio requirements
• Special Equipment: Cameras, cranes, dollies, and specialty gear
• Production Notes: Scheduling concerns, safety notes, and departmental coordination

Visual Descriptions Architecture

Phase 2 generates detailed visual profiles using a two-tier system:

Persistent Character Traits

• Physical Appearance: Build, height, distinguishing features
• Age: Approximate age or age range
• Personality: Core character traits and demeanor
• Signature Wardrobe: Typical costume style across the script
• Characteristic Mannerisms: Recurring behaviors and gestures
• First Appearance Propagation: Traits from character's first scene used for later appearances

Scene-Specific Character State

• Emotional State: How the character feels in this particular scene
• Physical Condition: Current health, energy level, injuries
• Scene Wardrobe: Specific costume for this scene (if different from signature)

Persistent Location Traits

• General Atmosphere: Overall feeling and tone of the space
• Architectural Style: Design period, materials, construction type
• INT/EXT Classification: Interior or exterior designation

Scene-Specific Location State

• Scene Lighting: Natural light, time of day, artificial lighting for this scene
• Scene Atmosphere: Weather, environmental conditions in this moment
• Scene Mood: How the location feels in this particular scene

Key Visual Moments

• Important Actions: Critical visual beats that drive the story
• Significant Props: Objects featured prominently in the scene
• Visual Storytelling: Non-dialogue moments that convey meaning

How to Use the Logistical Breakdown Feature

1. Open the Dialog: Click "Logistical Breakdown" in the Production menu
2. Start Generation: Click "Start Breakdown" to begin the two-phase analysis
   • Progress bar shows real-time status
   • Scene-by-scene updates display as processing completes
   • Generation continues in background if dialog closed
3. Review Results: Switch between tabs to explore breakdown data
   • Summary Tab: Overall statistics and production totals
   • Scene-by-Scene Tab: Complete breakdown for each scene
   • Expand individual scenes to view full details
   • Visual descriptions shown when available
4. Regenerate: Click "Regenerate" to create fresh breakdown with updated screenplay
5. Export: Download as PDF for production use

Summary View

The Summary tab provides production-level overview:

• Total Scenes: Complete scene count from screenplay
• Total Pages: Estimated page count
• Unique Cast: All speaking characters requiring talent contracts
• Unique Locations: All shooting locations for scouting and budgeting
• Production Totals: Aggregate counts for props, vehicles, animals, stunts, VFX shots, SFX needs
• Visual Completion Rate: Percentage of scenes with detailed visual descriptions
• Processing Information: Generation timestamp, AI model used, processing method, total time

Scene-by-Scene View

Each scene breakdown includes:

• Scene Header: Number, slug line, page count
• Synopsis: Brief scene description
• Production Elements: All 13 breakdown categories with detailed items
• Visual Descriptions: Character and location profiles (when Phase 2 completed)
• Expandable Interface: Click scene headers to expand/collapse full details

Export Options

PDF Export

• Professional Formatting: Industry-standard breakdown sheet layout
• Complete Data: All breakdown categories and visual descriptions
• Department Ready: Suitable for distribution to production departments
• Print Quality: Formatted for physical printing and binder storage
• Metadata: Script title, generation date, page numbers

Integration with Production Pipeline

Breakdown data powers other production features:

• Storyboard Generation: Visual descriptions provide character and location details for AI image generation
• Trailer Creation: Character profiles and key visual moments inform trailer shot composition
• Shot List Enhancement: Props, wardrobe, and production elements reference breakdown data
• Character Consistency: First appearance traits propagate to all later scenes for visual consistency
• Location Profiles: Persistent location architecture maintains visual continuity

Smart Caching System

• Automatic Storage: Completed breakdowns saved to browser localStorage
• Instant Loading: Previously generated breakdowns appear immediately on dialog open
• Per-Script Storage: Each screenplay maintains separate breakdown cache
• Regeneration Available: Clear cache and regenerate with updated screenplay content

Best Practices

• Scene Heading Format: Use standard format (INT./EXT. LOCATION - TIME) for accurate location extraction
• Complete Screenplay: Generate breakdown on finished draft for comprehensive results
• Review and Supplement: AI-generated breakdowns provide excellent foundation; add manual notes for specific requirements
• Regenerate After Revisions: Significant screenplay changes should trigger fresh breakdown generation
• Export for Collaboration: Share PDF with department heads for production planning
• Visual Descriptions for Storyboards: Phase 2 completion recommended before generating storyboards
• Character Consistency: Review first appearance descriptions carefully as they propagate to later scenes

Progressive Generation Details

Understanding the two-phase process:

Phase 1: Standard Breakdown (Required)

• Processes scenes sequentially with progress updates
• Extracts all 13 breakdown categories per scene
• Generates summary statistics and production totals
• Typically completes in 30-90 seconds depending on screenplay length
• Results immediately viewable in Summary and Scene-by-Scene tabs

Phase 2: Visual Descriptions (Optional, Recommended)

• Begins automatically after Phase 1 completion
• Generates detailed character and location profiles
• Separates persistent traits from scene-specific state
• Takes additional 30-60 seconds beyond Phase 1
• Critical for high-quality storyboard and trailer generation
• Visual completion rate shown in Summary tab

Understanding Breakdown Categories

Cast

• Speaking Characters: Characters with dialogue requiring SAG-AFTRA contracts
• Non-Speaking Characters: Named characters without dialogue in specific scenes

Props

• Hand Props: Items actors directly handle or manipulate
• Personal Props: Items associated with specific characters (watches, phones, keys)
• Set Props: Functional items on set (furniture, appliances)
• Hero Props: Featured prominently, may require multiples or special construction

Stunts

• Stunt description with safety requirements
• Performer type (stunt double, professional driver, etc.)
• Safety considerations and equipment needs

Visual Effects (VFX)

• Digital effects requiring post-production
• Green screen and compositing needs
• CG characters, environments, or elements
• Enhancement effects (set extensions, sky replacements)

Special Effects (SFX)

• Practical effects achieved on-set
• Pyrotechnics and explosions
• Mechanical effects (rain, wind, fog)
• Practical prop effects

Privacy

• Your Data: Screenplay content and breakdown results never leave your browser without explicit export
• API Key Security: Your API key stored encrypted locally, never transmitted except to Google AI

Troubleshooting

• Generation Fails: Check API key configuration in AI Assistant settings
• Incomplete Results: Try regenerating; occasional AI parsing issues may occur
• Missing Visual Descriptions: Ensure Phase 2 completed (check progress bar reached 100%)
• Incorrect Elements: Verify scene heading format matches industry standard
• Slow Generation: Long screenplays (100+ pages) may take several minutes
• Export Issues: Check browser popup blocker and download permissions
• Cache Issues: Click "Regenerate" to clear cache and create fresh breakdown
• Dialog Closed During Generation: Safe to close; generation continues in background
• Parse Errors: AI uses 4-tier repair strategy to recover from malformed responses

Production Workflow Example

1. Complete Screenplay: Finish your script in the editor
2. Generate Breakdown: Run both Phase 1 and Phase 2 for complete analysis
3. Export PDF: Share with department heads (Props, Wardrobe, Locations, etc.)
4. Generate Storyboards: Visual descriptions power character and location consistency
5. Create Shot List: Reference breakdown for production elements per shot
6. Update as Needed: Regenerate breakdown after script revisions

Visual Themes

Establish the visual identity and color language for your production. Visual Themes is the foundation of your design system, creating a cohesive aesthetic that guides all visual decisions from pre-production through post-production.

What are Visual Themes?

Visual Themes define the aesthetic DNA of your project:

• Color Palette: Primary, secondary, and accent colors that establish your visual signature
• Visual Style Language: Descriptive aesthetic approach (e.g., "Industrial decay meets sci-fi minimalism")
• Mood Descriptors: Emotional qualities that guide visual choices (dark, tense, warm, futuristic, etc.)
• Designer Notes: Additional guidance for production design, cinematography, and post-production teams

Why Use Visual Themes?

Visual Themes provide critical benefits throughout production:

• Consistency: Ensures cohesive visual language across all departments
• Communication: Common visual vocabulary for directors, cinematographers, production designers, and VFX teams
• Efficiency: Pre-established aesthetic decisions accelerate on-set choices
• Quality: Professional-level visual planning elevates production value
• Budget Optimization: Clear visual direction prevents costly on-set revisions

How to Create Visual Themes

1. Open Visual Themes: Go to Production → Design System → Visual Themes
2. AI Generation (Recommended):
   • Complete your Movie Concept first (provides genre, tone, and story context)
   • Click "Generate Visual Themes" to create AI-assisted theme based on your concept
   • AI analyzes your logline, genre, and tone to suggest appropriate visual language
3. Manual Creation:
   • Enter a descriptive Theme Name (e.g., "Cyberpunk Noir," "Warm Nostalgia")
   • Define your Visual Style Language with specific aesthetic descriptors
   • Build your Color Palette using hex codes or color picker
   • Select Mood Descriptors from common options or add custom ones
   • Add Designer Notes with additional context and references
4. Save:
   • Click "Save Themes" to persist to browser storage

Color Palette Management

Build comprehensive color palettes organized by role:

• Primary Colors: Dominant palette (typically 2-3 colors) - establishes overall tone
  • Example: Dark blues and grays for sci-fi thriller
  • Example: Warm earth tones for period Western
• Secondary Colors: Supporting palette (2-3 colors) - adds visual complexity
  • Complements primary colors without overwhelming
  • Often used for locations, wardrobe details, or time-of-day shifts
• Accent Colors: Highlight palette (1-3 colors) - draws attention to key elements
  • High-contrast colors for focal points
  • Emotional emphasis (danger, hope, mystery)
  • Character-specific signature colors

Adding Colors

• Click the color picker to select colors visually
• Colors are added individually - click multiple times to add multiple colors
• Each color displays as a swatch with its hex code
• Remove colors by clicking the X button on the swatch

Mood Descriptors

Select emotional qualities that capture your visual aesthetic:

• 20 Common Moods: Quick-select from industry-standard descriptors
  • Atmosphere: gritty, pristine, claustrophobic, expansive
  • Temperature: warm, cold
  • Style: industrial, organic, minimalist, ornate
  • Temporal: futuristic, decaying
  • Tone: romantic, melancholic, tense, mysterious, ominous, cheerful, dark, bright
• AI-Generated Moods: Additional descriptors from AI theme generation appear first
• Toggle Selection: Click mood badges to add/remove from your theme

Sensory Influences (The Vibe Check)

Define your production's unique "vibe" using non-film sensory references. The Sensory Influence Aggregator translates abstract sensory inputs into concrete cinematographic visual instructions.

Sensory Input Categories

• 🎵 Music/Audio: Sound references that evoke specific moods and energy
  • Examples: "David Bowie", "Industrial Techno", "Silence", "Jazz"
  • Effect: Translates to camera rhythm, editing pace, atmospheric density
• 🍲 Cuisine/Taste: Flavor profiles that suggest visual intensity
  • Examples: "Spicy Szechuan", "Stale Coffee", "Cotton Candy", "Bitter Espresso"
  • Effect: Translates to color saturation, contrast levels, texture emphasis
• 🎨 Art/Texture: Visual art references and tactile qualities
  • Examples: "Oil Painting", "Rusted Metal", "Velvet", "Watercolor"
  • Effect: Translates to surface detail, material palette, lighting approach
• 🏛️ Architecture/Place: Spatial and structural references
  • Examples: "Brutalist", "Overgrown Garden", "Art Deco", "Gothic Cathedral"
  • Effect: Translates to framing geometry, shadow patterns, spatial composition

How to Use Sensory Influences

1. Add Sensory Tags: Type a reference in any category and press Enter or click +
   • Add multiple tags to each category for layered vibe definition
   • Click X on any tag to remove it
2. Generate Visual Style: Click "Generate Visual Style from Senses"
   • AI synthesizes all sensory inputs into cinematographic instructions
   • Visual Style Language field is updated with specific guidance
   • Mood Descriptors are merged with AI-suggested moods
   • Color palette suggestions added to accent colors
3. Refine Results: Manually adjust the generated content as needed

Synesthesia Transformation Examples

The AI "Synesthesia Engine" uses transformation rules to translate sensory inputs:

• Spicy/Hot: → High contrast, saturated warm colors, close-up emphasis, sweating textures
• Industrial Techno: → Cold lighting, rhythmic editing, metallic surfaces, sharp geometric framing
• Soft Jazz: → Smoky atmosphere, shallow depth of field, warm practicals, soft focus
• Silence: → Stark minimalism, negative space, still camera, desaturated palette
• Brutalist: → Strong geometric shadows, cold concrete textures, wide angles, sparse framing
• Oil Painting: → Rich textures, visible brushstroke-like detail, classical composition, saturated colors
• Cotton Candy: → Pastel saturation, soft lighting, dreamy bokeh, rounded shapes
• Velvet: → Deep saturation, luxurious tactile quality, dramatic shadows, intimate framing

Integration Benefits

• Look Book: Sensory influences are included in image generation prompts for consistent vibe across all visuals
• Storyboard: Panel compositions reflect the synthesized aesthetic
• Communication: Non-film references help communicate visual intent to collaborators who may not have formal cinematography training

Visual Style Language

Describe your overall aesthetic approach in concrete, evocative terms:

• Be Specific: "Blade Runner meets art deco elegance" > "futuristic"
• Reference Architecture: "Brutalist concrete with neon accents"
• Combine Influences: "80s synth-wave aesthetic meets noir lighting"
• Include Texture: "Weathered industrial textures with organic decay"
• Consider Lighting: "High-contrast chiaroscuro with practical light sources"

AI-Assisted Generation

Generate professional visual themes automatically based on your Movie Concept:

• Context-Aware: Analyzes your logline, genre, and tone to create appropriate aesthetic
• Genre-Appropriate: Different approaches for sci-fi, horror, romance, thriller, etc.
• Comprehensive Output: Generates complete theme including:
  • Thematic name
  • 3-color primary palette
  • Secondary and accent color suggestions
  • Multiple mood descriptors
  • Detailed visual style description
• Editable Results: AI-generated themes serve as starting points - refine all elements

Integration with Production Pipeline

Visual Themes power other production features and inform AI-generated content:

• Location Design: Each location can reference the primary theme or custom location-specific themes
  • Theme mood descriptors inform AI-generated environmental storytelling
  • Visual style language guides set evolution suggestions
  • Color palette influences set dressing and prop recommendations
• Character Styling: Character wardrobes and appearances align with theme palette
• Prop Library: Props inherit theme colors for consistency
• Storyboard Generation: AI uses theme colors and mood in visual composition
• Trailer Generation: Color grading and visual effects reference theme palette

Production Benefits

Visual Themes enhance every stage of production:

• Pre-Production:
  • Production design references for set decoration and construction
  • Wardrobe department color palette for costume design
  • Lighting department mood and atmosphere guidance
  • VFX team color references for post-production
  • AI-Powered Location Design: Theme mood descriptors and visual style inform environmental storytelling, set evolution, and prop classification suggestions
• Production:
  • On-set color references for quick decision-making
  • Consistent visual language across shooting days
  • Director and DP alignment on aesthetic approach
• Post-Production:
  • Color grading reference for consistent look
  • VFX integration with established palette
  • Title design and graphics coordination

Best Practices

• Start Early: Establish visual themes in pre-production before location scouting
• Create Before Location Design: Visual themes inform AI-generated environmental storytelling, set evolution, and prop narratives in Location Design
• Test Against Story: Ensure visual choices support narrative and emotional beats
• Consider Genre: Horror needs different palette than romantic comedy
• Think Practically: Can your locations and budget support your visual choices?
• Use Descriptive Moods: Specific mood descriptors produce better AI-generated location storytelling suggestions
• Collaborate: Share themes with DP, production designer, and wardrobe early
• Stay Flexible: Themes guide decisions but shouldn't prevent creative opportunities
• Document Evolution: Export versions as themes develop through pre-production

When to Create Visual Themes

• After Movie Concept: Once genre, tone, and story are established
• Before Location Design: Theme mood descriptors and visual style inform AI-generated environmental storytelling and set evolution
• Before Location Scouting: Guide location selection with aesthetic criteria
• Before Casting: Inform character appearance discussions
• Before Storyboarding: Provide visual foundation for shot planning
• Before Production Design Meetings: Establish common visual vocabulary

Example Workflows

Sci-Fi Thriller Example

1. Movie Concept: "When AI becomes sentient, humanity must choose between control and coexistence"
2. AI Generation: Creates "Decaying Futurism" theme
   • Primary: Dark blues (#1a1a2e, #16213e, #0f3460)
   • Secondary: Cool grays (#464646, #2c2c2c)
   • Accent: Electric cyan (#0ff)
   • Moods: dark, futuristic, tense, claustrophobic, industrial
   • Style: "Industrial decay meets sci-fi minimalism with brutalist architecture"
3. Manual Refinement: Add orange accent (#ff6b35) for human warmth contrast
4. Designer Notes: "Contrast sterile AI environments (blues) with warm human spaces (oranges)"
5. Impact on Location Design: When generating environmental storytelling for "AI Command Center" location:
   • Theme moods "dark, tense, claustrophobic" inform storytelling tone
   • Visual style "industrial decay meets sci-fi minimalism" guides set evolution from pristine to deteriorating
   • Color palette (blues/grays) influences prop and set dressing recommendations

Period Drama Example

1. Theme Name: "Victorian Elegance"
2. Color Palette:
   • Primary: Rich burgundy (#800020), forest green (#2d5016), gold (#d4af37)
   • Secondary: Cream (#fffdd0), mahogany brown (#c04000)
   • Accent: Royal purple (#7851a9)
3. Moods: ornate, warm, romantic, elegant, nostalgic
4. Visual Style: "Victorian opulence with authentic period textures and natural lighting"

Common Pitfalls to Avoid

• Too Many Colors: Limit total palette to 6-8 colors for cohesion
• Generic Descriptions: "Dark and moody" < "Film noir lighting with venetian blind shadows"
• Ignoring Practical Constraints: Can your locations actually deliver this aesthetic?
• Disconnected from Story: Visual themes should enhance narrative, not distract
• Too Rigid: Themes guide but shouldn't prevent spontaneous creative decisions

Location Design

Define spatial layouts, dimensions, and technical specifications for each filming location. Location Design translates your breakdown's location data into production-ready spatial and technical documentation.

What is Location Design?

Location Design captures the physical, functional, and narrative characteristics of each location:

• Functional Type: Purpose classification (spaceship, cockpit, office, warehouse, etc.)
• Spatial Layout: Physical arrangement and key features with measurements
• Dimensions: Width, depth, height, and shape specifications (in feet)
• Environmental Storytelling: Who lives/works here, how the space defines them, what story it tells (AI-powered)
• Prop Placements: Specific positioning of props within the space (position, spatial role, story relevance, key prop classification)
• Set Arc/Evolution: How the location changes throughout the story (AI-powered)
• Lighting Notes: Natural and artificial lighting sources and characteristics
• Designer Notes: Additional production design guidance and references

Why Use Location Design?

Location Design provides critical benefits for production planning:

• Narrative Context (AI): Environmental storytelling analysis ensures locations support character arcs and story themes
• Set Evolution Planning (AI): Track visual transformations throughout the story for multi-state set planning
• Prop Classification (AI): Distinguish key props from set dressing for budget and quality prioritization
• Pre-Visualization: Clear spatial understanding before scouting or building sets
• Camera Planning: Dimensions inform shot composition and camera placement
• Set Construction: Exact specifications for building practical sets
• Prop Department: Placement guides and narrative context for set dressing and prop positioning
• Lighting Design: Notes inform gaffer and cinematographer planning
• Budget Accuracy: Detailed spatial data and set evolution states enable precise cost estimates
• Location Scouting: Functional requirements and character relationships guide location selection

How to Use Location Design

1. Complete Breakdown First: Run Breakdown to generate location data with visual descriptions
2. Open Location Design: Go to Production → Design System → Location Design
3. Auto-Import (Automatic):
   • Locations automatically import from Breakdown on first open
   • Hierarchical names preserved (e.g., "The Rust Bucket - Cockpit")
   • Props auto-populated with smart defaults based on category
   • Functional types extracted from breakdown persistent data
4. Select Location: Click a location from the sidebar to edit its design
5. Define Spatial Details:
   • Functional Type: Classify the location's purpose (auto-populated from breakdown)
   • Spatial Layout: Describe the physical arrangement with key features and measurements
   • Dimensions: Enter width, depth, height (feet), and shape (rectangular, circular, etc.)
6. Place Props:
   • Props auto-import from breakdown with intelligent defaults
   • Position: Where the prop is located (e.g., "center front," "near character")
   • Spatial Role: Layering designation (foreground-interactive, midground-static, background-dressing)
   • Notes: Additional placement guidance and visual appearance
7. Add Production Notes:
   • Lighting Notes: Natural and artificial light sources
   • Designer Notes: Additional production design guidance
8. Save: Save to browser storage for production planning

Environmental Storytelling (AI-Powered)

Location Design now includes environmental storytelling analysis to answer three critical production design questions:

• Who lives/works here? Which character(s) inhabit or use this space, their relationship to it (ownership, work, temporary)
• How does this space define them? What the spatial layout and prop choices reveal about character personality, values, history, or emotional state
• What story does this space tell? The narrative significance, emotional resonance, and thematic elements the space embodies

AI Generation: Click "Generate Storytelling" to analyze your location using character data, genre context, and spatial layout to produce contextual storytelling insights (2-4 sentences per question).

Benefits of Environmental Storytelling

• Character-Space Connection: Clarifies how locations reflect character psychology and arc
• Production Designer Guidance: Provides specific visual storytelling opportunities
• Set Dressing Direction: Informs prop selection based on character definition
• Genre-Aware Analysis: Considers genre conventions in spatial storytelling
• Thematic Coherence: Ensures locations support overall story themes

Set Arc/Evolution (AI-Powered)

Track how locations transform visually throughout your story:

• Physical Transformation: Damage, deterioration, renovation, or improvement over time
• Atmospheric Shifts: Changes in lighting, temperature, or mood
• Ownership Changes: Control of the space shifting between characters
• Accumulation/Depletion: Objects accumulating or disappearing, clutter building or being cleaned
• Symbolic Evolution: Visual changes reflecting character arcs or story themes
• Temporal Markers: Visual cues showing time passing (wear, weathering, repairs)

AI Generation: Click "Generate Set Evolution" to analyze how your location should change over the story. AI provides 3-5 sentences describing key transformation moments with genre-specific examples (thriller, drama, action, sci-fi, horror).

Production Benefits of Set Evolution

• Multi-State Set Planning: Production design knows which states of the set to build/prepare
• Continuity Planning: Clear timeline of visual changes prevents continuity errors
• Budget Accuracy: Understand full scope of set modifications needed
• Schedule Optimization: Shoot scenes in order of set states to minimize set changes
• VFX Planning: Identify which transformations need practical vs. digital execution

Prop Placement System

Location Design includes an intelligent prop placement system with smart defaults and narrative analysis:

• Hand & Personal Props: Auto-set to "foreground-interactive" near associated characters
• Hero Props: Auto-set to "foreground-interactive" in prominent positions (plot-critical)
• Set Props: Auto-set to "background-dressing" for environmental context
• Spatial Roles:
  • Foreground-interactive: Props characters interact with directly
  • Midground-static: Props visible but not interactive
  • Background-dressing: Environmental set dressing
• Story Relevance (AI-Powered): Each prop can have a narrative significance description explaining how it supports storytelling
• Key Prop Classification (AI-Powered):
  • KEY PROP: Plot-critical item that characters interact with, drives story forward, or has symbolic importance (e.g., murder weapon, love letter, MacGuffin)
  • SET DRESSING: Environmental detail that establishes atmosphere, character, or world but doesn't drive plot (e.g., books on shelf, posters, decorative items)

AI Generation: Click "Generate Narratives" to analyze ALL props in the location. AI determines each prop's story relevance and classifies it as key prop vs. set dressing based on narrative function.

Key Prop vs. Set Dressing Guidelines

• Key Props Have: Direct plot impact, mentioned in dialogue, held/used by characters, emotional significance, specific irreplaceability
• Set Dressing Has: Background presence, establishes mood/character, worldbuilding function, could be replaced without story impact
• Examples:
  • "Wedding ring on nightstand" → KEY PROP if evidence of affair; SET DRESSING if just showing character is married
  • "Vintage typewriter" → KEY PROP if character writes crucial letter on it; SET DRESSING if just shows they're a writer
  • "Family photo" → KEY PROP if reveals hidden relationship; SET DRESSING if just decoration

Smart Auto-Import Features

Location Design's auto-import system provides intelligent defaults:

• Vehicle Detection: Recognizes vehicle interiors from breakdown (cockpits, bridges)
• Hierarchical Names: Preserves parent-child relationships ("Ship - Room")
• Prop Metadata: Imports full prop data including category, visual appearance, plot significance
• Smart Positioning: Infers prop placement based on category and character association
• Filtered Keywords: Removes generic functional type keywords, keeps descriptive ones

Dimensions and Measurements

Accurate dimensions are critical for production planning:

• Width: Side-to-side measurement (perpendicular to camera)
• Depth: Front-to-back measurement (toward/away from camera)
• Height: Floor-to-ceiling measurement (vertical clearance)
• Shape: Overall geometry (rectangular, circular, irregular, L-shaped, etc.)
• Standard Unit: All measurements in feet for consistency

Production Benefits

Pre-Production

• Location Scouting: Specific requirements guide location selection
• Set Design: Dimensions and layouts inform set construction blueprints
• Budget Estimates: Accurate spatial data enables precise cost projections
• Tech Scouts: Detailed notes guide cinematographer and gaffer planning

Production

• Set Dressing: Prop placement guides ensure consistency across takes
• Camera Planning: Dimensions inform lens choices and camera positions
• Blocking: Spatial layout helps director plan character movement
• Continuity: Documented placements prevent continuity errors

Post-Production

• VFX Planning: Spatial data informs set extensions and CG environments
• Reshoots: Documented layouts enable accurate set reconstruction

Best Practices

• Complete Breakdown First: Location Design depends on breakdown data for auto-import and AI context
• Use AI Features Early: Generate environmental storytelling, set evolution, and prop narratives to guide spatial layout decisions
• Use Exact Measurements: Precise dimensions prevent costly on-set surprises
• Classify Props Correctly: AI-generated key prop classifications help prop department prioritize what needs close-up quality vs. background detail
• Plan Set Evolution States: Use AI-generated set evolution to identify how many versions/states of the set need to be built or prepared
• Document Lighting: Light sources impact cinematography and mood
• Consider Camera Access: Note spatial constraints that affect shot composition
• Reference Real Spaces: Base dimensions on actual rooms when possible for realism
• Update After Changes: Refresh from breakdown after script revisions, then regenerate AI storytelling analysis
• Review AI Suggestions: AI-generated content should be reviewed and edited to match your specific creative vision

When to Create Location Designs

• After Breakdown: Auto-import requires completed breakdown with visual descriptions
• Before Tech Scout: Spatial data guides cinematographer and gaffer planning
• Before Set Construction: Dimensions and layouts inform build specifications
• During Prep: Props and lighting notes guide department planning
• Before Location Scouting: Requirements guide location selection criteria

Example Workflow: Sci-Fi Spaceship Interior

1. Complete Breakdown: Generate breakdown with "The Rust Bucket - Cockpit" location
2. Auto-Import: Open Location Design, location auto-imports with props
3. Select Location: Click "The Rust Bucket - Cockpit" in sidebar
4. Review Auto-Populated Data:
   • Functional Type: (vehicle_interior cleared - generic keyword)
   • Props: Control Panel (set, background-dressing), Captain's Chair (hero, foreground-interactive)
5. Add Spatial Layout: "15ft x 8ft cramped cockpit with pilot's chair centered 3ft from main control panel. Curved walls with display panels. Single entry hatch rear-left."
6. Enter Dimensions:
   • Width: 15 ft, Depth: 8 ft, Height: 7 ft, Shape: rectangular
7. Generate Environmental Storytelling (AI): Click "Generate Storytelling" →
   • Who lives/works here? "This cockpit is primarily inhabited by the maverick captain and their small crew, serving as their command center and lifeline in the vast galaxy."
   • How does this space define them? "The cockpit's cramped yet functional layout reveals a resourceful crew unafraid to improvise. Mismatched panels and personal trinkets speak to daring escapades and pragmatic affection for their aging ship."
   • What story does this space tell? "This cockpit tells a story of relentless perseverance against overwhelming odds, evoking the resilience of underdogs fighting for freedom across the cosmos."
8. Generate Prop Narratives (AI): Click "Generate Narratives" →
   • Control Panel: Story Relevance "Navigation and life support controls that crew depends on for survival," KEY PROP (critical for ship operation)
   • Captain's Chair: Story Relevance "Command seat representing captain's authority and burden of leadership," SET DRESSING (establishes character role but not plot-critical)
9. Generate Set Evolution (AI): Click "Generate Set Evolution" →
   • "Initially pristine and well-maintained, the cockpit accumulates battle damage and jury-rigged repairs over the course of the story. Sparking wires and patched hull plates reflect escalating conflict. By the climax, the space shows visible wear but remains functional, embodying the crew's determination despite mounting challenges."
10. Refine Prop Placements:
    • Control Panel: Position "forward wall centered," Spatial Role "foreground-interactive"
    • Captain's Chair: Position "center, 3ft from control panel," Spatial Role "foreground-interactive"
11. Add Lighting Notes: "Overhead LED panels (cool blue), control panel practicals (cyan glow), emergency lighting (red accents)"
12. Add Designer Notes: "Inspired by Apollo command module - functional minimalism with worn industrial aesthetic"
13. Save: Save to browser storage for production planning

Example Workflow: Contemporary Office

1. Complete Breakdown: Generate breakdown with "Corporate Headquarters - Executive Office" location
2. Auto-Import: Location imports with props (desk, chairs, laptop, artwork)
3. Add Functional Type: "executive office"
4. Spatial Layout: "20ft x 15ft corner office with floor-to-ceiling windows on two walls. Mahogany desk centered facing door. Seating area with leather sofa and chairs near windows."
5. Dimensions: Width: 20 ft, Depth: 15 ft, Height: 10 ft, Shape: rectangular
6. Prop Placements:
   • Executive Desk: "center, facing door," foreground-interactive
   • Laptop: "desk surface, left side," foreground-interactive
   • Artwork: "wall behind desk," background-dressing
   • Seating Area: "near windows," midground-static
7. Lighting Notes: "Natural light from floor-to-ceiling windows (south and west exposure), recessed ceiling LED (warm white 3000K), desk lamp practical"
8. Export: Share with location scout and production designer

Common Pitfalls

• Skipping Breakdown: Auto-import depends on completed breakdown data
• Vague Measurements: Imprecise dimensions lead to on-set problems
• Ignoring Prop Placement: Undocumented placements cause continuity errors
• Missing Lighting Notes: Unplanned lighting causes production delays
• Outdated Data: Failing to refresh after script changes leads to mismatches

Character Styling

Define consistent character appearance, wardrobe, and visual staging across all scenes. Character Styling ensures visual continuity and provides production departments with clear wardrobe and styling specifications.

What is Character Styling?

Character Styling captures the visual identity and staging characteristics of each character:

• Base Appearance: Core wardrobe description and color palette
• Wardrobe Colors: Hex color codes for costume design consistency
• Staging Archetype: Natural positioning in frame (hero, antagonist, supporting, ensemble, background)
• Occupational Styling: Profession-based styling notes (uniform, tools, accessories)
• Consistency Rules: Guidelines for maintaining visual continuity across scenes
• Evolution Notes: How appearance changes throughout the story arc
• Scene Variations: Scene-specific appearance overrides
• Theme Binding: Link character styling to Visual Themes for cohesive palette

Why Use Character Styling?

Character Styling provides critical benefits for production planning:

• Wardrobe Continuity: Prevents costume errors across shooting days
• Department Communication: Clear specifications for wardrobe, hair, and makeup teams
• Budget Planning: Detailed wardrobe requirements enable accurate costume budgets
• Visual Consistency: Maintains character identity throughout production
• Scene Blocking: Staging archetypes guide director and cinematographer positioning
• Color Grading: Wardrobe color palette informs post-production color workflow
• Reshoots: Documented styling enables accurate wardrobe recreation

How to Use Character Styling

1. Complete Breakdown First: Run Breakdown to generate character data with visual descriptions
2. Open Character Styling: Go to Production → Design System → Character Styling
3. Auto-Import (Automatic):
   • Characters automatically import from Breakdown on first open
   • Persistent characters only (excludes non-speaking roles like "VOICE (O.S.)")
   • Base appearance and occupational styling auto-populated from breakdown
   • Staging archetypes intelligently inferred from character roles
4. Select Character: Click a character from the sidebar to edit their styling
5. Define Base Appearance:
   • Wardrobe: Core costume description (e.g., "Brown leather jacket, dark pants, worn boots")
   • Wardrobe Colors: Add hex color codes for key costume elements
   • Occupational Styling: Profession-specific details (e.g., "Pilot uniform with insignia patches")
   • Theme Binding: Link to Visual Theme for color palette consistency
6. Set Staging Archetype:
   • Hero (Center): Protagonist, centered in frame
   • Hero (Offset): Protagonist, dynamic positioning
   • Antagonist: Oppositional framing to hero
   • Supporting: Near protagonist, secondary focus
   • Ensemble: Varied positioning, equal importance
   • Background: Edge of frame, minimal focus
7. Add Consistency Rules: Guidelines for maintaining visual continuity (e.g., "Always wears dog tags," "Hair tied back during action scenes")
8. Document Evolution: Note how appearance changes through story (e.g., "Clean uniform → battle-damaged → civilian clothes")
9. Save: Save to browser storage for wardrobe planning