Import Script: Difference between revisions

From ACT3ai MediaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
* From [[Getting_Started|Getting Started]] → '''[[New_Project|New Project]]''' setup, choose **Import Script**.   
* From [[Getting_Started|Getting Started]] → '''[[New_Project|New Project]]''' setup, choose **Import Script**.   
* Inside the [[Editor|Editor]]: **File → Import → Script** (adds to the current project).
* Inside the [[Editor|Editor]]: **File → Import → Script** (adds to the current project).
== Supported Formats ==
* '''[[Final_Draft|Final Draft (FDX)]]''' – preserves scene numbers, title page, and notes where available. 
* '''[[Fountain|Fountain]]''' – plain‑text screenplay syntax. 
* '''[[Markdown_Support|Markdown]]''' – headings and lists mapped to scenes and beats. 
* '''[[Plain_Text|Plain Text]]''' – best‑effort parsing with format hints. 
* (Optional) '''[[PDF_Import|PDF]]''' – when enabled, uses OCR + heuristics (review carefully after import).


== How Imports Are Structured ==
== How Imports Are Structured ==

Revision as of 11:47, 19 August 2025

Import Script

Overview

The Import Script feature lets you bring existing screenplays and outlines into ACT 3 AI so you can immediately continue in the Editor with structured acts, scenes, and shots. Imports are parsed, auto‑formatted, and linked to downstream tools like AI Wizard, Digital Actors, and the Rendering System.

Where to Find It

How Imports Are Structured

  • Script elements are mapped to the ACT 3 hierarchy: ActSceneShot.
  • Scene Headings (e.g., INT./EXT.) become Scene cards.
  • Action & Dialogue flow into the Script Editor with speaker attribution.
  • Beat Markers (from Fountain/Markdown) populate Story Beats.
  • Optional page/line notes become annotations in the Editor.

How to Use

  1. Open Import Script from the project creation flow or the Editor.
  2. Choose your file type: FDX, Fountain, Markdown, or TXT.
  3. Select parsing options:
    1. Map # headings to beats (Markdown/Fountain).
    2. Preserve original scene numbers.
    3. Detect languages for subtitles and dubs.
  4. Click Import to preview the parsed structure.
  5. Confirm to create Acts, Scenes, Shots and open in the Script Editor.
  6. (Optional) Run AI Wizard to fill missing beats, logline, or theme.

Formatting Hints (For Best Results)

  • Use proper Scene Headings (e.g., `INT. LAB – NIGHT`) so the parser can segment reliably.
  • Keep character names on their own lines in ALL CAPS for accurate dialogue mapping.
  • In Markdown/Fountain, use `#` / `##` for beats and sub‑beats to seed Story Beats.
  • Avoid embedding images in text imports—attach reference art separately to Storyboard & Panels.

After Import: Next Steps

Troubleshooting

  • Missing scenes or wrong splits → Check scene heading syntax; re‑run import with “Preserve scene numbers.”
  • Dialogue misattributed → Ensure character names are uppercase and on their own lines.
  • Excessive paragraphs in one scene → Add blank lines between action blocks for clearer segmentation.
  • Non‑English scripts → Enable language detection to prep subtitles and dubbing tracks.

Credits & Storage

  • Importing text is free; AI cleanup or auto‑structure prompts may use small credits.
  • Resulting previews and generated media count toward plan storage (see Billing Model and Credit System).

Privacy & Rights

  • Imported files are stored within your Organization and follow project‑level permissions.
  • Use only material you have the rights to process; see Documentation → Legal/Usage.

See Also

Contact Us if you have any problems using our product, or if you have questions.