Writing Your Script

PrePrompt reads what you give it. A polished screenplay gets cinematic treatment; a paragraph of prose also works. This page covers the formats the Script Node accepts, and a few conventions that make the analysis sharper.

Formats PrePrompt accepts

The Script Node takes four input types:

Fountain (.fountain)

Plain-text screenplay format. Scene headings, action lines, dialogue, and parentheticals are all recognized. If you’ve used Highland, Slugline, or Beat, export as Fountain.

Final Draft (.fdx)

The industry-standard screenplay format. Upload the .fdx directly — PrePrompt reads structure and content from the file.

Plain text (.txt)

A text file. If it looks like a screenplay, PrePrompt treats it as one. If it’s free prose, PrePrompt still reads it and does its best with scene inference.

Markdown (.md)

Same as plain text, with your headings respected as potential scene breaks.

You can paste text directly into the Script Node’s input area, or drag a file onto it.

The one-paragraph shortcut

You don’t need a full screenplay. A single paragraph of prose works:

Sarah walks into an empty coffee shop at dawn. The barista is setting up. She orders a flat white and takes it to a window seat. Outside, a man in a dark coat walks past and stops to look at her.

PrePrompt will extract a scene, infer a few shots, and create the Actors, Props, and Sets it needs. The analysis won’t be as tight as a well-structured screenplay, but it’ll get you to a storyboard fast — especially for testing an idea.

Tip

Starting loose? Use the Eden consult. When your input is a paragraph or an early draft, Eden’s clarifying questions fill in the gaps. See Eden Consult.

Structure that helps analysis

If you want PrePrompt to produce a well-organized breakdown, three conventions make a big difference.

Scene headings

Use the standard format:

INT. KITCHEN — MORNING
EXT. CITY STREET — NIGHT
INT./EXT. CAR — DAY

PrePrompt uses the INT./EXT. prefix, the location, and the time-of-day tag to mark scene boundaries and seed the Set node for that location. Consistent headings produce cleaner scene breaks.

Action lines

Action lines describe what happens in frame. Write them in present tense, one beat per line or paragraph:

SARAH pours coffee. Steam rises.

The DOOR CREAKS open. A SHADOW falls across the floor.

Sarah looks up, frozen.

Each clearly separated action often becomes its own beat. If you want more granularity in your storyboard, break actions into smaller paragraphs.

Character names

Use ALL CAPS for each character’s first appearance and in dialogue cues. PrePrompt uses these names to create Actor nodes automatically:

SARAH (30s, tired eyes) enters the shop.

SARAH
Morning.

Consistent names matter. If your character is sometimes “Sarah” and sometimes “SARAH WALKER,” PrePrompt may create two Actor nodes. Pick a canonical form and stick with it — you can always merge or rename later.

Dialogue

Write dialogue the normal way:

SARAH
You're up early.

BARISTA
So are you.

PrePrompt extracts lines per character and wires them to Audio Nodes for voiceover generation later.

What to leave out

A few conventions the Script Node doesn’t need:

Skip the camera directions

Lines like CLOSE ON SARAH'S HANDS or SLOW PAN ACROSS THE ROOM aren’t wrong, but PrePrompt infers Shots from the structure of your action. Over-specifying camera work early often produces less flexible storyboards. You can always add camera intent per-shot in the Script Node’s analysis view.

You can also skip:

• Page numbers, revision marks, and scene numbers — PrePrompt numbers scenes automatically.
• Transitions like CUT TO: or FADE IN: — they’re ignored in analysis.
• Headers and footers — strip them before uploading if they’d confuse the text.

Tips for better analysis

1. Name every character who has a line or a distinct on-screen moment. Unnamed extras become generic tags; named characters become full Actor nodes.

2. Describe physical traits once, up top. SARAH (30s, sharp features, worn leather jacket) on her first appearance. PrePrompt uses these details for her hero look.

3. Be specific about props that matter. “She pulls out a small silver locket” gives PrePrompt a Prop node. “She pulls out an object” gives it nothing to work with.

4. Use clear scene boundaries. When location or time changes, start a new scene heading. Short scenes are fine; PrePrompt doesn’t mind a 4-line scene.

5. If you’re unsure, let Eden ask. Don’t over-engineer the input. The Eden consult exists to refine ambiguous details after the fact.

Related

Eden Consult The optional clarifier that tightens your script before analysis.

Analysis Results What the Script Node produces once it finishes reading.

Scene, Shot, Beat The hierarchy PrePrompt extracts from your script.

Getting Started The full first-project walkthrough, from script to export.

FAQ

Do I need screenwriting software to write a PrePrompt script? No. A plain text editor is enough. Fountain is a simple plain-text format that gets you professional-looking output in any editor.

What’s the minimum viable input? One paragraph of prose. PrePrompt will extract at least one scene and a few beats. A few lines of dialogue between named characters is usually enough to get useful Actor nodes.

What’s the maximum script length? There’s no hard cap, but very long scripts take longer to analyze and cost more credits. For your first project, start with a single scene or short sequence.

Can I edit the script after analysis? Yes. You can re-run analysis with a changed script. PrePrompt will do its best to preserve Actors, Props, and Sets you’ve already generated — rename carefully to avoid creating duplicates.

Does formatting affect cost? Script analysis cost depends on script length more than format. A longer script takes more tokens to read.

What if my character’s name changes over the course of the script? Add both names to the Actor node after analysis — PrePrompt supports aliases. Downstream nodes will track them as the same Actor.

Can I write in a language other than English? PrePrompt’s analysis is optimized for English today. Other languages may work but expect rougher structure extraction; check the results carefully.