Scripts
A script project is a screenplay. Choose Script project on the first page when you create a project. The format is set at creation and does not change later.
A new script starts with one scene. Every scene sits right under the script in the sidebar, one level deep. Reorder scenes there. The editor shows the whole script as one text. Opening a scene scrolls to it.
Screenplay with a scene creates a short script with three scenes, two characters and a How scripts work page in the wiki. Each feature on this page is used at least once in it.
The line menu
Section titled “The line menu”The handle beside a line opens every action for it: Turn into, New take, Omit scene, Scene number and more. On a scene heading, Delete becomes Delete scene.
To see the script and a wiki page side by side, split the screen with ⌘ShiftS on a Mac, or CtrlShiftS on Windows and Linux.
Writing
Section titled “Writing”Every line of a script is an element: a scene heading, action, a character cue, a parenthetical, dialogue, a transition, a shot or a note. Type, and the next element follows.
| On a line of | Enter gives | Tab gives | Shift+Tab gives |
|---|---|---|---|
| Scene heading | Action | The next part of the heading | Nothing |
| Action | Action | Character | Transition |
| Character | Dialogue | Transition | Action |
| Parenthetical | Dialogue | Dialogue | Character |
| Dialogue | Character | Parenthetical | Action |
| Transition | Scene heading | Action | Character |
| Shot | Action | Action | Action |
| Note | Action | Nothing | Nothing |
- Enter on an empty cue or dialogue line turns it into action. This is the way out of a speech.
- Enter on an empty action line opens the element menu. Type to filter, then press Enter.
- Turning a line into a parenthetical adds the brackets. Turning it into anything else removes them.
- Type
(on an empty dialogue line for a parenthetical. Backspace in the empty brackets goes back to dialogue. - A cue takes no colon. One typed at its end is left out.
- Start an action line with
INT.,EXT.,INT./EXT.,I/EorEST.and it becomes a scene heading. A line in capitals ending withTO:becomes a transition.
These keys turn the current line into an element.
| Element | Mac | Windows and Linux |
|---|---|---|
| Scene heading | ⌘⌥1 | CtrlAlt1 |
| Action | ⌘⌥2 | CtrlAlt2 |
| Character | ⌘⌥3 | CtrlAlt3 |
| Parenthetical | ⌘⌥4 | CtrlAlt4 |
| Dialogue | ⌘⌥5 | CtrlAlt5 |
| Transition | ⌘⌥6 | CtrlAlt6 |
| Shot | ⌘⌥7 | CtrlAlt7 |
| Note | ⌘⌥8 | CtrlAlt8 |
Type in lower case if you like. Cues, headings and transitions show and print in capitals. Format manuscript sets each element’s bold, italic, underline and capitals.
A note line never prints. Neither does text in [[double brackets]] inside any line.
Scenes
Section titled “Scenes”The scene heading is the scene’s name. Rename the scene in the sidebar and the heading follows, and the other way round. A scene heading cannot be turned into another element.
Scenes read as one text. Nothing on the page marks where one ends.
-
Drag any line into another scene. A scene heading stays with its scene.
-
Delete a scene heading and its lines join the scene above. The scene goes to the trash. ModZ brings both back.
-
Backspace at the start of a scene heading joins its scene to the one above, as text does. So does Delete at the end of a scene.
-
In a scene heading, Tab after
INTorEXTcompletes it and lists the places you have used. -
Tab at the end of a place adds
-and lists the times of day. Each Tab adds one more part:INT. HOUSE - KITCHEN - DAY. -
Type a new scene heading below a scene and move on. The heading and what follows become a new scene, right after the current one. ModZ puts it back in one step.
-
Add script page, in a sidebar row’s menu, adds a scene that opens on an empty heading.
Characters
Section titled “Characters”Create a character in one of two ways:
- Type a new name on a cue line. The menu offers New once per template, such as New Character: ZED or New Creature: ZED. Pick the one you want.
- Use the + next to Wiki in the sidebar.
On a cue line, the menu lists the Characters in your project. Pick one and the cue is linked to that character. The scenes they speak in then show in the character’s Mentions. Renaming a character does not change the cues you already wrote.
Settings > Entities adds other kinds of entity, such as Creature or Robot. Cue lines offer them all, whatever their name or icon. Each can have a voice.
After dialogue between two people, Enter offers the other speaker first.
When the same character speaks again after action, the cue gets (CONT'D). It is part of the cue’s text, so you can edit or delete it. Turn it off under Settings > Script. Extensions such as (V.O.) and (O.S.) stay part of the cue.
A line can hold several takes of its text. Only the take on the page prints, exports and counts.
| Action | Mac | Windows and Linux |
|---|---|---|
| New take of this line | ⌘⌥T | CtrlAltT |
| Previous or next take | ⌘⌥↑ or ↓ | CtrlAlt↑ or ↓ |
A badge in the right margin shows which take is on the page, such as 2/3. Its menu has New take, Keep this take only and Delete this take. On a scene heading, the take on the page is also the scene’s name.
Scene numbers
Section titled “Scene numbers”Scenes are numbered 1 to N across the script, in both margins and in the sidebar. Show scene numbers, under Settings > Script, hides or shows them.
The Scene number field in a heading’s line menu takes a number of your own, such as 12A. Leave it empty to go back to the automatic number.
Omitted scenes
Section titled “Omitted scenes”Omit scene, in a heading’s line menu, takes a scene out without deleting it. The editor and the sidebar show its number and OMITTED only. An omitted scene takes no comment. Read aloud skips it. Enter on its heading starts a new scene after it.
The PDF and Fountain export print it as 12 OMITTED 12, so later scenes keep their numbers. Restore scene brings its lines back.
Format issues
Section titled “Format issues”Format issues lists each format slip in the side panel: a cue with no dialogue, dialogue with no cue, a parenthetical without brackets, a cue ending in a colon, an empty line or two blank lines in a row. It also lists a cue spelled almost like a more common one, such as MOIRAH next to MOIRA. The line you are typing on is never listed.
A red dot on the side panel button means there is something to fix. Click a row to scroll to its line. The buttons under it are the fixes. Fix all fixes a whole group at once.
Pages and the title page
Section titled “Pages and the title page”The toolbar shows the page count. It uses the same pagination as the PDF, so the two always agree.
Fill in the title page under Settings > Script: title, credit, author, source, draft date, contact, copyright and notes. An empty title prints the project name.
Export and import
Section titled “Export and import”- PDF: industry format in Courier Prime, with a page number at the top right from page 2.
- Fountain: the plain-text screenplay format most screenwriting apps read.
- DOCX and Markdown are also available.
To bring in a script, choose Import on a script project and pick a .fountain or .spmd file. Its scenes go after the ones already there. A # section comes in as a note line. A file with scene numbers keeps them. Anything that could not be reproduced exactly is listed when the import finishes.
Read aloud
Section titled “Read aloud”Read aloud runs on your computer. Install it once, under Settings > Plugins > Read to me. The speaker button in the toolbar then reads the whole script.
It reads action and dialogue. It skips cues, headings, transitions, shots, notes and omitted scenes.
Each character can have their own voice: open the character and pick one under Voice. Action lines and characters with no voice use the narrator voice, under Settings > Script. Turn on Dialogue only in the reader to hear the dialogue alone.