Online documentation‎ > ‎Technical‎ > ‎

Screenplay Import (Text)

Screenplay formatting

When importing screenplays from a text file, Synaesthesia assumes that it is "properly" formatted, with standard use of capitalization and indenting. Specific requirements are outlined below.

Scene detection

During import, Synaesthesia will divide the text into scenes by looking for scene headings on each line.

Scene headings are differentiated from the rest of the text by the following:
  • The line begins with a number and contains only uppercase text for the rest
    • example: 1. THE GREAT OUTDOORS - DAY
    • or even: 1a. THE GREAT OUTDOORS - DAY
    • but not: 1. The Great Outdoors - DAY
    • and not: THE GREAT OUTDOORS - DAY
  • The line specifically begins with "Scene" (or "sc.") and then a number
    • example: Scene 1. The Great Outdoors
    • or even: sc. 1
    • but not: scene one
  • If no scene numbers are specified, the scene will only be detected if the line begins with "INT", "EXT" or "I/E". In this case, Synaesthesia will number the scenes chronologically.

Master scene detection

By default, all scenes detected are master scenes, with the following exception:
  • If a line does not contain "INT", "EXT", or "I/E" (but the very first scene imported did follow this convention), it is marked as a sub-scene of the previous master scene

Removed text

The following text is removed during import:
  • Page numbers (i.e. a line with just a number and no text)
  • Page continuations
    • example:    CONTINUED
    • or even: CONTD
    • but not: PHILIP (CONTD)
In addition:
  • Any text prior to the first scene heading is put on the cover page (page 0)
  • The very first line of the screenplay will be saved as the current screenplay version (if it's not a scene heading)