> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ozu.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Writing Your Script

> What script formats Ozu accepts, how to structure pages for cleaner analysis, and the one paragraph that works when you don't have a full draft.

Ozu 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 Ozu accepts

The Script Node takes four input types:

<Columns cols={2}>
  <Card title="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.
  </Card>

  <Card title="Final Draft (.fdx)">
    The industry-standard screenplay format. Upload the `.fdx` directly — Ozu reads structure and content from the file.
  </Card>

  <Card title="Plain text (.txt)">
    A text file. If it looks like a screenplay, Ozu treats it as one. If it's free prose, Ozu still reads it and does its best with scene inference.
  </Card>

  <Card title="Markdown (.md)">
    Same as plain text, with your headings respected as potential scene breaks.
  </Card>
</Columns>

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.

Ozu 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 Ozu consult.** When your input is a paragraph or an early draft, Ozu's clarifying questions fill in the gaps. See [Ozu Consult](/user/script/ozu-consult/).
</Tip>

## Structure that helps analysis

If you want Ozu 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
```

Ozu 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. Ozu 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," Ozu 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.
```

Ozu 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:

<Warning>
  **Skip the camera directions**

  Lines like `CLOSE ON SARAH'S HANDS` or `SLOW PAN ACROSS THE ROOM` aren't wrong, but Ozu 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.
</Warning>

You can also skip:

* Page numbers, revision marks, and scene numbers — Ozu 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. Ozu uses these details for her hero look.

3. **Be specific about props that matter.** "She pulls out a small silver locket" gives Ozu 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; Ozu doesn't mind a 4-line scene.

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

## Related

<Columns cols={2}>
  <Card title="Ozu Consult" href="/user/script/ozu-consult">
    The optional clarifier that tightens your script before analysis.
  </Card>

  <Card title="Analysis Results" href="/user/script/analysis-results">
    What the Script Node produces once it finishes reading.
  </Card>

  <Card title="Scene, Shot, Beat" href="/user/concepts/scene-shot-beat">
    The hierarchy Ozu extracts from your script.
  </Card>

  <Card title="Getting Started" href="/user/getting-started">
    The full first-project walkthrough, from script to export.
  </Card>
</Columns>

## FAQ

**Do I need screenwriting software to write a Ozu 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. Ozu 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. Ozu 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 — Ozu supports aliases. Downstream nodes will track them as the same Actor.

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