Import Script: Difference between revisions

From ACT3ai MediaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
= Script Import =
== Overview ==
== Overview ==
The '''Import Script''' feature lets you upload and parse existing screenplay documents so you can start editing and planning in ACT 3 AI without retyping. It automatically converts industry‑standard formats into the Editor’s structured script view.
The Script Import feature in ACT 3 AI allows creators to bring existing scripts into the platform for editing, pre-visualization, and AI-assisted production. 
It supports industry-standard screenplay formats and automatically adapts imported content to the ACT 3 AI scene structure.
 
== Key Benefits ==
1. Work with scripts written in external screenwriting tools.
2. Preserve scene formatting, dialogue, and stage directions.
3. Reduce setup time by automatically generating scenes from imported content.
4. Support for popular formats such as Final Draft, Fountain, and PDF.
5. Enable AI to immediately begin generating visuals and storyboards from your script.
 
== Workflow for Script Import ==
1. **Open the Script Import Tool** 
  Navigate to the [[Import_Script|Script Import]] option in the project dashboard.


== Supported Formats ==
2. **Select Your File**   
* **Final Draft (.fdx)** 
  Upload from your computer or import directly from integrated services (e.g., Google Drive, Dropbox).
* **Plain Text (.txt)** with Fountain or Markdown screenplay syntax  
* **PDF (.pdf)** (text‑based only; images/hand‑written pages not supported)


== How It Works ==
3. **Choose File Format**   
# Click the **Import Script** button in the main navigation or on the Editor’s start screen.  
  Supported formats include:
# Select your file or drag‑and‑drop into the upload area.
  * **FDX** – Final Draft.
# ACT 3 AI parses scene headings, character names, dialogue, and action lines.
  * **Fountain** – Plain text screenplay format.
# Review the auto‑mapped elements in a preview dialog; make corrections if needed.
  * **PDF** – Screenplay exports from other tools.
# Confirm to load the structured script into the Editor, ready for writing, shot planning, and AI enhancements.
  * **TXT/DOCX** – Basic text files.


== Preview & Validation ==
4. **Map Script Structure**   
* **Element Mapping** – See a side‑by‑side list of parsed elements (Scenes, Characters, Dialogue).  
  Review and confirm:
* **Error Highlighting** – Lines that failed to parse (e.g., unusual formatting) appear in red; click to edit raw text.
  * Scene headings (INT./EXT.).
* **Character Extraction** – Unique character names auto‑populate the Cast and Characters pages for quick assignment.
  * Action descriptions.
  * Dialogue and character names.


== Integration with Workflow ==
5. **Auto-Generate Scenes**   
* **Immediate Linking** – Imported scripts link to storyboards, shot prompts, and timeline slots as soon as they load.  
  ACT 3 AI will create individual scene entries in your [[Editor|Editor]] for further editing.
* **Auto‑Tagging** – Script elements are tagged with metadata (scene number, shot count) to drive scheduling and budget estimates. 
* **Version Control** – Each import creates a new script version in the project’s history for easy rollback and comparison.


== Tips & Troubleshooting ==
6. **Apply AI Enhancements (Optional)**   
* For best results, use a text‑based PDF or native FDX/CELTX/FPI file.  
  Use [[AI_Wizard|AI Wizard]] to:
* Avoid PDFs that contain scanned images—text extraction will not work.
  * Expand descriptions.
* If character names merge with action lines, edit them in the preview dialog before import.
  * Add visual details.
* Re-run **Import Script** any time you update the source file; new versions appear as separate script drafts in your project.
  * Suggest alternative dialogue.


== See Also ==
7. **Save & Organize**   
* [[Editor]]  
  Store the imported script in the **Script** section of your [[Project_Structure|Project Structure]].
* [[Characters]] 
* [[Cast]]


[[Category:ACT 3 AI Features]]
== Supported Integrations ==
1. **Final Draft** – Direct import of .fdx files.
2. **Google Docs** – Import via copy/paste or export.
3. **Dropbox / Google Drive** – File-based imports.
4. **Screenwriting Software Exports** – Celtx, WriterDuet, StudioBinder.


== Best Practices ==
1. Use properly formatted screenplays for best auto-parsing results.
2. Double-check imported scene breaks and character names.
3. Apply consistent scene naming for smooth AI generation.
4. Keep an untouched copy of your original script for reference.


[https://act3ai.com/contact Contact Us] if you have any problems using our product, or if you have questions.
== Related Pages ==
* [[Import_Script|Import Script]]
* [[AI_Wizard|AI Wizard]]
* [[Editor|Editor]]
* [[Project_Structure|Project Structure]]
* [[Version_Control|Version Control]]
* [[Creating_Movies|Creating Movies]]

Revision as of 11:56, 11 August 2025

Script Import

Overview

The Script Import feature in ACT 3 AI allows creators to bring existing scripts into the platform for editing, pre-visualization, and AI-assisted production. It supports industry-standard screenplay formats and automatically adapts imported content to the ACT 3 AI scene structure.

Key Benefits

1. Work with scripts written in external screenwriting tools. 2. Preserve scene formatting, dialogue, and stage directions. 3. Reduce setup time by automatically generating scenes from imported content. 4. Support for popular formats such as Final Draft, Fountain, and PDF. 5. Enable AI to immediately begin generating visuals and storyboards from your script.

Workflow for Script Import

1. **Open the Script Import Tool**

  Navigate to the Script Import option in the project dashboard.

2. **Select Your File**

  Upload from your computer or import directly from integrated services (e.g., Google Drive, Dropbox).

3. **Choose File Format**

  Supported formats include:
  * **FDX** – Final Draft.
  * **Fountain** – Plain text screenplay format.
  * **PDF** – Screenplay exports from other tools.
  * **TXT/DOCX** – Basic text files.

4. **Map Script Structure**

  Review and confirm:
  * Scene headings (INT./EXT.).
  * Action descriptions.
  * Dialogue and character names.

5. **Auto-Generate Scenes**

  ACT 3 AI will create individual scene entries in your Editor for further editing.

6. **Apply AI Enhancements (Optional)**

  Use AI Wizard to:
  * Expand descriptions.
  * Add visual details.
  * Suggest alternative dialogue.

7. **Save & Organize**

  Store the imported script in the **Script** section of your Project Structure.

Supported Integrations

1. **Final Draft** – Direct import of .fdx files. 2. **Google Docs** – Import via copy/paste or export. 3. **Dropbox / Google Drive** – File-based imports. 4. **Screenwriting Software Exports** – Celtx, WriterDuet, StudioBinder.

Best Practices

1. Use properly formatted screenplays for best auto-parsing results. 2. Double-check imported scene breaks and character names. 3. Apply consistent scene naming for smooth AI generation. 4. Keep an untouched copy of your original script for reference.

Related Pages