03 / STORY
Keep exploration separate from production.
Story in 0.72: names in any alphabet
- A name in another alphabet speaks its lines. A cue in another alphabet's capitals, such as ЭМИНА or ВАН ВОРДЕН (V.O.), is a speaker's cue, as EMINA is. So is a name in an alphabet with no capitals, such as ズィベルダ, on its own line over what they say. A line that ends a sentence, such as ズィベルダは走る。, stays action.
- Each name has its own tag, in its own letters, such as
CHAR_ЭМИНАorCHAR_ズィベルダ, and a place too, such asLOC_ВАГОН. Before 0.72 every name with no Latin letter shared one tag,CHAR_UNTITLED, so two people read as one. A project locked before keeps its tags until its next Lock. A name with a Latin letter in it keeps the tag it had. - A sheet answers to its name in its own alphabet. When a sheet named Эмина has another tag, such as
CHAR_EMINA, the lines her cue speaks are hers, and a frame of them sends her picture.
Story in 0.68.7: a PDF's speeches side by side, and its full-width lines
- Two speeches side by side come in as dual dialogue from a PDF too. When a PDF sets two speakers' lines in two columns (Final Draft's dual dialogue), the upload reads them as two speeches, the second speaker's name marked with
^(VAN WORDEN ^), as a Final Draft file already does. One speech may be longer than the other, such as No. beside five lines. A page with VIDEO and AUDIO over its columns is not read as two speakers: upload a commercial's two columns on its brief's page. - A full-width line of action stays action. In a PDF, the left margin is where the scene headings start, so a line of action as wide as the page is never taken for a centered title card, even when the title page sets the writer's contact further left. A line centered on the page after the script has begun is still a title card.
Story in 0.68.6: verbs in every tense, and a line after a parenthetical
- Verbs are known in every tense. Script check no longer reads common verbs as misspellings, such as anticipated, illustrated or communicates. It no longer offers made-up forms of these verbs, such as anticipanted. Latin plurals, such as styli or larvae, are known too.
- A line after a parenthetical is speech. In a speech, the line under (beat) or (he puts his cup down) is spoken, and Script check leaves it alone. It asks only when the line reads as action: the speaker moving or handling something, such as Van Worden puts his cup down. or She turns away., with no I, we or you in it; or a camera direction, such as CLOSE ON the lamp. or The camera pans to the window.
- A title before a name. When someone comes in with a title or a first name, such as CAPTAIN ZIBELDA (50s) or ZIBELDA MARR (50s), and speaks as ZIBELDA or MARR, Script check asks if they are the same character.
- **A name with of in it,** such as The KEEPER OF TIDES, an old harbor clerk, is a character when an age or a description of a person follows it.
Story in 0.68.6: no floor plan for a place your film doesn't use
- Lock drafts floor plans only for places your film uses. That is a place a scene is set in, a place a scene names with its @ tag, a place where a shot's camera stands, or a place joined to one of these, such as a lighthouse someone looks at through a window. A card's place, such as Black, counts only when a scene is set there, its tag is in a scene, or a shot's camera stands there. When you cut the last scene set in a place and nothing else uses it, its sheet stays in Assets, such as the Black sheet after you cut the cards' scene. Lock drafts it no floor plan, and its line doesn't name it. Write a scene there again and the next Lock drafts one. A place you add yourself with + New place in Assets still gets its plan.
Story in 0.68.5: Lock renumbers shots, with an Undo; a card typed at BLACK
- Lock gives shots their scenes' new numbers. When Lock numbers your scenes again (you cut or moved a scene and locked), each shot takes its scene's new number: for example, a shot made as 2A in what is now scene 1 reads 1A, and 2A.1 reads 1A.1. If History still holds 1A (a shot of that scene you deleted, which its Undo can bring back), the shot takes the next free letter, such as 1B. A number of your own (ESTAB) stays as it is, and so does one that was already out of step. Takes, stills and the cut keep their names and their place. Lock's summary says which shots took new numbers (2A → 1A and 3A → 2A), and the old number shows when you hover a shot's number on the Shot List, the Storyboard, Dailies and in Edit's hover card (Was 2A until Draft 2 was locked.).
- Undo brings the old numbers back. Press Put the old numbers back in Lock's summary, or Undo on Lock's line in History on the Shot List or the Storyboard (Shots renumbered at Lock: 2A → 1A). Redo in the Storyboard's History gives the new numbers again, until the next change there. If you changed those shots on the Storyboard since, it asks first and says how many shots get their old numbers back. If another shot has one of the old numbers now, Undo says which, and changes nothing. Edits you made to those shots since stay. If a shot was renamed since, Undo says so and changes nothing.
- A chat's change keeps its shot. A change the Shot List's chat proposed before Lock renumbered the shots goes to the shot it meant when you press Apply, not to the shot that holds that number now. The same for Ask or direct on a shot.
- An administrator can turn renumbering off in Admin › Operations › Caps & usage, Lock renumbers shots. Off, Lock leaves every shot's number as it is; shots renumbered already keep their numbers.
- A card typed at BLACK is a title card. In a scene at BLACK (such as INT. BLACK, BLACK SCREEN, TITLE CARD or CREDITS), or right over a title card, a line in capitals that ends in a full stop is a title card, never a character, when no one by that name speaks elsewhere in the script: THE FERRY SAILED. over the next line shows as a Title card, centered, and the line under it is action. This holds when you type it, and in a plain-text, Word, Final Draft or PDF upload. A speaker's name never ends in a full stop, so NARRATOR (V.O.) or EMINA over a line still speaks, and so does EMINA. when Emina speaks in another scene. OVER BLACK., SILENCE. and DARKNESS. stay plain action. A line in capitals with nothing under it reads as before. To keep a line there as a character, choose Character in the line-type menu; Script check notes each such card that reads like a name. A Character from a Final Draft file stays a character.
Story in 0.68.4: the top stays in reach, on every page
- The top stays in reach, on every page. In a window at least 951 pixels wide and 700 tall, the studio's header, the row of pages (Story, Assets, Shot List…) with Save, and each page's own bar stay at the top as you scroll. Assets, the Storyboard, Dailies and Edit fill the window under them. In a narrower window the row of pages scrolls with the page.
- In a shorter window (a laptop at 125%, say), every page is as before: Story keeps its header, the Shot List keeps its own top from 560 pixels tall (until 0.68.5; since then from 700, like every page), and the rest scroll with the page, so each page keeps all its room.
- A yellow check strip under a picture in Assets is always as tall as its words. Its buttons go under the words when there's no room beside them. When the column under the picture is short, the words box gets smaller first, then the picture, so Generate stays in view.
Story in 0.68.4: Title card in the line-type menu, and what the Breakdown is for
- Title card is a line type. For words on screen in the script, such as a title or a date, put the cursor in the line and choose Title card, last in the line-type menu. The line shows centered, in the case you typed it, and is never spoken. Its hover says: Words on screen, such as a title or a date. Centered, never spoken.
- Enter after a card starts the next card. Enter on an empty card goes back to Action. Shift+Enter gives the card a second line. Tab gives Character, for a narrator over the card. Typing >THE END< on a line of Action makes it a Title card too.
- The cards you already have show as Title cards: every centered line in your script, uploaded or typed, shows centered, without its marks. A card of two lines stays one card when you edit its scene. A card you typed as Action becomes one when you choose Title card.
- A card is never a character or a line, and it names no one. Script check leaves it as you wrote it: a card such as TWO YEARS LATER is never made into a scene heading.
- Download and upload again, and the cards come back the same, in Fountain, Word, Final Draft and PDF. In Word and PDF, that holds once FADE IN: or a heading is above the card, in a script where someone speaks. A card above FADE IN: comes back from Word and PDF as a plain line.
- The Breakdown says what it's for. At the foot of Script check, under its name: Suggests characters, props and places you may have missed, and a mood for each scene. Use it after you write or upload a draft. It's free, and nothing changes until you press Do it on a suggestion.
Story in 0.68.3: title cards on upload, and the scene order
- Centered lines come in as title cards. Upload a script from Word, Final Draft or a PDF, and each centered paragraph comes in as a title card: words the audience reads, never spoken. In the script it reads >THE END<, centered. After the upload, a line says how many came in.
- A title card is never a speaker or a line, and it names no one. A speaker you centered by hand stays a speaker. A heading, a transition or INTERCUT WITH: is never a card.
- Download and upload again, and the cards come back the same, in Word, Final Draft and PDF.
- A card that isn't centered reads as before. Center it, or start it with TITLE:.
- The scene order is your script's. To take out a scene of cards, make a new draft in Story, cut the scene, and press Lock script. The scenes after it move up. Their shots keep their labels: a shot made as 2A stays 2A. If the scene you cut still has shots, Lock asks you to delete them first.
Story in 0.68.1: who Lock tags in a scene, Merge into and LATER
- Lock tags a person where the action names them as a name is written ("Mark", "MARK", "VanWorden"), not where the word is common ("a red mark"). A person called by a role word is there in lower case too ("the waiter", "her mother"), but "a waiter" is another one.
- A short line in capitals is action, and the person in it is there ("VAN WORDEN IS HERE."). So is someone acting under a title's lead ("OPENING TITLES - Zibelda walks the quay at dawn."). The words a card, a caption, a super or a screen shows name no one there ("CARD: Zibelda loves you.").
- A log's line with its day or its length ("MARK - THU 23:04 - 6 MIN") names no one there. A speaker's cue may hold a time ("RADIO 6:00", "ANNOUNCER - 10:15").
- Merging a place into its longer name changes the headings that start with the shorter one, however their time is written ("INT. THE BAKERY - DAY", "INT. THE BAKERY (DAY)", "INT. THE BAKERY-NIGHT"), and never writes the longer name twice.
- Once a LATER heading names its time, in any words ("SUNSET", "MIDNIGHT"), "How much later?" isn't asked again. When the scene's first lines say another time, Check script offers that time in one click, and the heading then names that time only.
Story in 0.68.1: the typewriter font is the script's alone
- The typewriter font is for the script only: the screenplay page, a line of dialogue quoted on the Storyboard and in a shot's Dialogue box, and a chat card's change to the script. Everything else, timecodes and key hints included, is in the studio's normal font, with figures that line up.
Story in 0.68: spelling, Show me, title lines and card scenes
- Spelling is listed last in Script check, as the lightest kind, and never holds up Lock. Check spelling turns it off for the project, and on again any time. Long words (persuasive, productivity) are known, and a suggestion is always a real word.
- Show me takes you to the line the question is about, marked, and marks the question beside it.
- A super, a title, a card or an insert over a line (
SUPER: …,TITLE: …,CARD: …,MAIN TITLE,INSERT - …), a camera's line and a card's sentence are action, never a character. A name over its line is a character wherever it stands, a narrator over black too. A title card written plainly over a line (EMINA'S CROSSING) reads as a name: centre it (>EMINA'S CROSSING<) or writeTITLE:before it. Since 0.68.5, at BLACK or over a title card, one that ends in a full stop (THE FERRY SAILED.) is a title card. Force a character with@, action with!. - A scene at BLACK or over a title card needs no floor plan and no plates. To make a heading another kind of line, use the line-type menu: it stays that kind as you type. Deleting a heading's words leaves the next line as it was, and a heading pasted on one line is a heading, as typed.
Story in 0.68: how long a script can be
- A project's script holds up to 200,000 characters (about 111 pages), and a project up to 500 scenes. A longer script is refused with what to do (shorten it, or split the film into two projects), and nothing is saved; a script of more scenes doesn't lock (join short scenes, or split the film). The studio can raise the script's limit to 500,000 characters (about 277 pages); that is switched off for now.
Story in 0.64: the divider and Full screen
- Wherever two parts share the screen, drag the divider between them; a double-click puts it back, and it's remembered for you, page by page, in this browser. With a divider picked, the arrow keys move it (Shift goes farther) and Home puts it back. On a phone the parts stack, and there's no divider. Here it's between the script and Script check.
- Full screen (on the bar, or F when you aren't typing) gives the script the whole window: the studio's bars step aside, and the Story bar stays, for Find and the flags. F again or Esc comes back, at the same line.
Drafts in 0.63: Import as a new draft, names, Delete, Unlock
- Import is a new draft, and says so first. At the top of Import ▾ a line says what the import does: A new draft, Draft 8, from the file. Draft 7 and its notes stay under Earlier drafts. (on a locked draft: The locked Draft 7 stays as it is, and every other tab reads it until you lock again.; on a draft you restored or unlocked and then changed: Your changes to Draft 7 are kept under Earlier drafts as Draft 8.; on a locked draft whose words tracked edits changed before 0.63, both). The file's words are the new draft's only: nothing of the open draft's words is mixed in, and you don't need a new project to try an import. After it: Draft 8 created from emina.docx. Draft 7's words are kept under Earlier drafts, with its notes. An import into an empty draft still fills it (The uploaded script is Draft 1.). The title page still goes to the Cover page.
- Name a draft. Name this draft… in the Draft pill's menu gives the open draft a short name beside its number (up to 40 characters): Draft 7 · Ferry at dawn. The pencil on a row of Earlier drafts names a kept one. The name shows in the Draft pill's hover and its menu, in Earlier drafts, in Restore, in Compare and in History's made in Draft 5 · Ferry at dawn. The name is the draft's words': it stays with them under Earlier drafts through New draft, Import, Lock and Restore, and Restore brings it back. While the open draft's words are the ones kept under its number, it and its row under Earlier drafts are one draft with one name, the newest you gave either of them (a heading's capitals don't count as a change, and clearing a name counts as giving one). A new number starts with no name and shows where it came from (from Draft 7). A name you give or clear after you changed a draft's words (one you unlocked or restored) is the new words' only: the copy kept under Earlier drafts keeps its own name, and when Lock or New draft makes the next number for your changes, that number takes the name. Rename or clear the kept copy's name while you change the draft, and the open draft shows the new name too, unless you named or cleared your changes' name yourself: then the line says which draft took it (Draft 7 under Earlier drafts is named “Zibelda's pass”. Your changes to Draft 7 keep their name, “Van Worden's cut”.). Put your words back as they were, and a moment later the draft shows the newest name you gave either of them; the next Lock, New draft, Import or Restore keeps that name. Save an empty name to clear it.
- Where each draft came from, and when. Earlier drafts and Restore show locked on the copy every other tab reads, where a draft came from (from emina.docx, from Draft 6) and the day and time it was kept.
- Delete an earlier draft. The bin on a row of Earlier drafts asks first, in the menu: Delete Draft 5 · Ferry at dawn?, with what goes with it (Its 3 margin notes go with it.; Script coverage reports and History lines made on it stay; You can't undo this.), then Delete Draft 5 or Keep it. The open draft and the locked draft (its scenes and shots come from it) can't be deleted: the bin is off, and its hover says why. Earlier drafts with the same words as the locked one (copies earlier Locks made) can be deleted: only the copy the last Lock kept is the locked draft. A deleted draft's number is never used again. Only you delete drafts: a Tarkovsky Director run or an agent is told to ask you.
- Unlock to edit. On a locked draft, Unlock to edit opens the same draft to write in, with its number: no new draft. Every other tab reads its locked words until you lock again. Lock script then keeps Draft 7 if you didn't change its words. A heading Lock fixes for you never makes a new draft: Draft 7 under Earlier drafts then holds the words as locked. If you changed them, they become Draft 8 and Draft 7 stays under Earlier drafts as it was locked (Draft 8 locked. Draft 7's words changed, so Draft 7 stays under Earlier drafts as it was.). New draft works as before. A locked draft's words change only after Unlock to edit or New draft: the script, a save and an agent's tracked edits all wait for one of them. A draft whose words were changed while it was locked (tracked edits accepted before 0.63) says so when you unlock it, and Lock makes those words the next number with the locked draft kept as it was.
- Restore asks first. Restore an earlier draft lists every kept draft, Draft 1 included. A click says what happens before it does: Restore Draft 2? Its words open as Draft 2 · Working. Draft 7's words are kept under Earlier drafts. Every other tab reads the locked Draft 6 until you lock again. Then Restore Draft 2 or Cancel. Lock a restored draft without changing its words and it keeps its number (a heading Lock fixes for you doesn't count); change them, and Lock makes the next draft and the draft you restored stays as it was.
- No new numbers you didn't ask for. Locking a locked draft again with the same words (a Tarkovsky Director run or an agent can) keeps its number; until 0.63 it made a new one with the very same words. Lock's own fixes (a heading it corrects, or Check script corrects before Lock) never make a new number: only a change you make to the words does, after Unlock to edit or Restore too, and on drafts kept before 0.63. New draft, Import and Restore read your words the same way, so a heading fix never makes them keep a second draft either. After Lock fixed a heading, New draft no longer keeps a second copy under the same number: the copy Lock keeps is the words as locked. A draft kept twice before 0.63 (the same words under one number, often one copy with the heading as typed and one as locked) shows once under Earlier drafts from your next New draft, Import, Restore, Unlock or Lock, whichever draft is open: one copy, with the newest name you gave either; the locked draft's copy holds the words as locked, and Restore brings it back with them. Two different texts kept under one number before 0.63 (tracked edits accepted on a locked draft, then New draft) are two drafts, and both stay, through Lock too: locked and the time under Earlier drafts tell them apart, and while another draft is open the bin deletes the one that isn't locked. On the Storyboard, a new shot's new line into a locked draft says first that Make it opens the next draft for it.
Story in 0.63: a proposal's line, and a Lock refusal that goes when its cause does
- No machine's note under a proposal. A card from Ask or direct (PROPOSED CHANGE · SCENE 1, Add to scene 1 · Ignore · Flag) no longer shows the line the model wrote about its own edit (Writes the scene as a single page from the writer's beats…). The reply above the cards says what they do. A line written to you, in the studio's voice (I cut the shrug, so the scene ends on Emina's silence.), shows once that's switched on; until then, none does, on new cards and older ones alike.
- Rename a scene's heading, keep its words, and Lock keeps its shots (since 0.61.1): EXT. FERRY LANDING - DAWN made EXT. FERRY LANDING - DAY is the same scene, its shots and its work kept, marked Script changed, even with a paragraph cut.
- A Lock refusal goes when its cause does. Lock's red notice (The new script leaves out …) is Lock's answer to the script as it's saved; nothing keeps it, in this page or another tab. Once you change the script (put the scene back) or its shots (delete them on the Shot List), the notice goes, on whichever page you're on, and the next Lock asks again. Saving goes on while it shows.
- For the agent. Each edit in
POST /api/projects/:id/story/chat's answer still hasreason.reasonToYou: truebeside it means it was written to the filmmaker (the server'sSTORY_REASON_LINE=on); the page showsreasononly then.
The script in 0.61.1: a renamed scene keeps its shots, and New draft keeps your notes
- Rename a scene's heading and Lock keeps its shots. A scene whose heading you change (INT. FERRY CABIN - NIGHT made INT. FERRY CABIN, BELOW DECK - NIGHT) is the same scene at Lock when its words mostly match and it stays in its place among the other scenes: it keeps its shots, its takes and the work done on it (purpose, beats, lighting, mood), and it's marked Script changed, so you can look at its shots and its plans again. A scene written anew in that place, or a scene of a heading alone, is a new scene.
- A scene you take out of the script, with its shots. Lock says which scene the new script leaves out and how many shots it has (The new script leaves out EXT. CANAL LOCK - DAWN, which has 2 shots. Put the scene back, or delete its shots on the Shot List, then lock again.). A place the film returns to is named with its number (scene 3, INT. HOUSE - DAY).
- New draft takes your margin notes with it. New draft copies the draft's words, and now its notes go with them (camera notes, story notes, coverage flags), so the new draft shows them, still linked to the shots they made. The earlier draft under Earlier drafts is its words: restore it and its notes are the ones written on it since.
The script in 0.61: selections, drafts and title pages
- Tab and Enter never delete selected words. With words selected, Enter puts the cursor at the end of the selection and changes nothing; Tab (and Shift+Tab) gives every line the selection touches the type Tab gives the first of them, and the selection stays. Cmd+Z (Ctrl+Z on Windows) puts the lines back. Where that type can't be kept (Tab on a speech would make it a Character line, leaving its speaker with no speech), nothing changes and the page says Nothing was changed: a character's name needs a speech under it, and a speech needs a name above it.
- A line type for several lines. Select lines (Shift+click, Shift+arrows or drag) and choose a type from the line-type menu: every selected line takes it, and the selection stays. Dialogue and a parenthetical need a character's name above them: with none, nothing changes and the page says Dialogue needs a character's name above it. Add one, then choose Dialogue. (the whole change is refused when the first selected line would have no name above it).
- A line type always saves as you see it. A change the script couldn't keep after a reload is refused whole and said instead: several lines made Character with no speech under them, a Character line or a speech changed so that the other is left alone (the line above), or Shot for words that name no camera (Nothing was changed: a shot line starts with the camera's words, such as CLOSE ON, ANGLE ON or POV.). Choosing Character for one line still works: it waits for the speech you type under it.
- The first script is Draft 1. Importing a script into an empty project makes it Draft 1 (The uploaded script is Draft 1.), and no empty draft is kept. An import into a project with words is a new draft, as before, and the words you had are kept under Earlier drafts.
- Restore an earlier draft keeps its number. Restoring Draft 2 brings back its words as Draft 2 · Working (Restored Draft 2. Draft 3 is kept under Earlier drafts.), with the margin notes still on Draft 2 (since 0.61.1, none if a New draft from it took them on). A new number (New draft, an import, Lock of a locked draft) is always the highest so far plus one, so no two drafts share a number: a restored draft you change and then import over, restore past or lock takes the next number, with the notes you wrote on it since the restore, and the kept Draft 2 keeps its words and its own notes. New draft takes every note the draft shows with it (0.61.1).
- A title page from any file. A plain-text, Markdown or Fountain file's title page now goes to the Cover page too, as Word, PDF and Final Draft did, and on every kind of file the writer's name and address go to the Cover page's Contact instead of staying in the script: the street, the town, a flat number, the email and the phone, from the first of those lines to the last, with the name above them. Only the lines above the script's own first line are read: a scene heading, FADE IN, a page break, or a script that starts on BLACK, OVER BLACK:, a speaker (EMINA (V.O.)) or a sentence of action ends the title page, so a title card, a date or a phone number in the script stays in the script. Those lines must read as a title page (a credit with its author, or a contact line); everything else stays in the script, as written.
Ask or direct in 0.61: a live waiting line, and more room when an answer needs it
- You see it working. While the chat answers, its line moves and counts the time (Thinking · 0:12), and on Tarkovsky credits the model's newest thought runs under it in gray, as it thinks. Once the answer itself starts arriving, the line says Writing the answer. Past a minute it adds a long answer can take a few minutes. On your own key you see the time, not the thoughts. The same line shows in Ask or direct on every page and on Edit.
- An answer that needs more room asks first. When an answer runs past the room one reply allows, the chat no longer ends with The answer was cut off at the output limit. It asks: This answer needs more room than one reply allows. Continue with more room · about 12 credits (up to 40 held)?, with Continue and Not now. Nothing was charged for the try that ran out of room. Continue sends your message again with twice the room, at the new price shown: that's what it holds, and you're charged only what it uses. On Edit, the question comes back as the card with its price and OK.
- Only when there's no more room or no credits for it does the answer end as a cut-off, and it says which: More room would hold up to 40 credits, more than the 12 credits left: add credits, or ask for less. A project with a budget is asked only when its budget holds more room too; otherwise the cut-off says how much is left in the budget, and you can raise it in Kickoff.
- The question waits where you asked. If you've moved to another page's chat, or opened the studio again, by the time the answer runs out of room, the question waits in the chat you asked in, with your message above it, and a short line tells you so. If the price changed before you pressed Continue (an edit, a longer thread), nothing is charged and the question comes back with the new price.
- For the agent.
POST /story/chatand/shots/chatanswer a cut-off with502 { didntRun: true, reason: "cut_off", moreRoom: { room, maximumCredits, expectedCredits, expectedBasis, ask } }(ask: theprompt, and theshotIdsorsceneFocus, it was asked with); send that message again withroomandmaxCredits: moreRoom.maximumCreditsto carry on. A409withpricemeans the price rose since: quote again withroom(POST …/quote). AwaitId(a UUID of yours) with a message on credits streams the model's thinking toGET /api/projects/:id/chat/waits/:waitId({ phase: "waiting" | "thinking" | "writing", thought }).
Ask or direct in 0.57.1: room for a whole-script rewrite
- A long answer comes back whole. Ask or direct on the Story page gives its answer room for your script: a whole-script rewrite of a long scene used to stop halfway. An answer that takes more than a minute is written on the server and appears in the chat when it lands, even if you open another page meanwhile, and the studio stays usable while it's written. A reply that didn't run no longer offers to append the error to your script.
Pinned while scrolling (0.52)
- The top stays in reach. On the Story page the studio's header (with Report a bug), the bar (Script / Scenes to Lock script, with Find and Flags under it when they're open) and the line-type menu with Note ▾ stay at the top as you scroll, so Note ▾, the line types and Report a bug are always one click away. The row of pages (Story, Assets, Shot List…) scrolled away with the page until 0.68.4; now it stays too, in a window at least 951 pixels wide and 700 tall.
- On a phone (and a phone held sideways), the header and the line-type menu with Note ▾ stay; the bar scrolls away with the page, so the script keeps most of the screen. Scroll up to reach it.
- Nothing hides what you're writing. As you type, move the cursor with the arrow keys, or go to a match from Find, a flag or a scene, the page scrolls so the line stays below the bars, never under them. Menus, the note editor, Script coverage and Brainstorm open over the bars.
- Every page since 0.68.4. Until 0.68.4 this was the Story page's only; now the header and the row of pages stay on every page, in a window at least 951 pixels wide and 700 tall.
The synopsis on the Story page (0.56)
- The kickoff's text, one click away. Right after the Draft pill, The synopsis (or The story when the kickoff kept only your notes; on a commercial The concept, or The idea) opens the kickoff's reading window, where you read it, change it (Edit, with Brainstorm beside it), Brainstorm on it or download it; it shows only when the kickoff kept that text.
The Story page (0.39)
- One bar, one row. On the left: Script / Scenes, the draft, the script check, Suggest elements, Script coverage and the highlight dots (Characters, Elements, Flags). On the right: Find ▾ (Find, and Find and replace), History, Cover page, Import ▾, Download ▾ and Lock script. Highlight Locations is gone: click a place in the scene list for its scenes.
- The script check is a chip: 1 to fix in red (the count of what the check found open), or Reads clean. It counts by itself a moment after you stop typing, free (no model). Click it to open what it found beside the script.
- Over the script, centered: the line-type menu (it always shows the type of the line the cursor is in, and changes it) and Note ▾. Nothing else: a scene's details open from the scene list.
- The scene list on the left: each scene's number, heading, time of day, length (in eighths of a page), its notes (a dot in each kind's color, and the count) and who's in it. Click a scene to go to it: its heading lights up for about two seconds. Mood, tags, line directions under a scene opens its details. Scenes at HARBOR BRIDGE beside it lists every scene at that place; the list then says how many of the scenes it shows (HARBOR BRIDGE · 1 of 2 scenes) and All scenes brings the rest back. Since 0.44 a click anywhere on a heading goes to its scene: the place inside the heading was the link to its scenes, so a click meant for the scene hid every other scene from the list (TAR-441).
- The page is a true screenplay page, 8½ inches wide in Courier 12, centered, with the notes in a margin on its right, each beside its line. On a phone the margin folds away and a note shows as a small icon at the end of its line.
- A scene with no heading (a script that starts on action, or a heading an import lost) shows in red in the list, No scene heading, and counts as scene 1. On the page, where the heading would be: Scene 1 has no heading. (after an import: The import may have lost it.) with Add “INT. BAKERY - MORNING” (Tarkovsky Director's guess, from the scene's words and the headings after it; Undo is in the notice and in History) and Write one (an empty Scene Heading line, the cursor in it).
- Enter and Tab always work like a screenwriting app; there is no Final Draft keys setting and no plain text editor any more. On a line of…
- Scene heading: Enter goes to Action, Tab to Character.
- Action: Enter goes to Action, Tab to Character.
- Character: Enter goes to Dialogue, Tab to Parenthetical.
- Parenthetical: Enter goes to Dialogue, Tab to Dialogue.
- Dialogue: Enter goes to Action, Tab to Character (the next speaker).
- Transition: Enter goes to Scene heading, Tab to Scene heading.
- Enter on an empty Character line turns it back into Action, so dialogue never starts without a speaker. Tab on an empty line steps through the line types: Action → Character → Scene heading → Transition; Shift+Tab goes back.
- Notes have icons and colors: Director, a director's chair, in violet; Camera, a movie camera, in blue; General, a note, in gray-green (never yellow, orange or red: those mean flags). The color is on the margin's note, its name, the scene list's dots and the Shot List's Script notes chip.
- Example notes. A script opens with one example of each kind beside a line it fits, written from the script's own lines (For example: The swing door is hinged on the left.): Direct a performance, Add a camera note, Add a note. Add makes it a real note on that line; Edit changes its words, then Add; the trash can removes it (Undo in the notice). Once an example is added or removed it doesn't come back on that film.
- Adding a note. Select some words and a small Note ▾ appears above them; or use Note ▾ over the script; or the + that appears on the margin's edge beside the line under the pointer (it stays level with that line as you move to it); or ⌘⌥M (Ctrl+Alt+M). The menu offers Direct a performance, Camera note or Note, and says where the note will go: On “pushes through the swing door” (pinned to those words), On the line your cursor is in, or On this line. You write the note in its card in the margin; nothing is saved until Save.
- A posted note shows only its words. Hover it for Edit, Move to…, the trash can (with Undo) and the grip (⠿). Click a note to underline what it's pinned to, its words or its whole line, in its color; its border takes the color too. Click anywhere else and the underline goes.
- Moving a note: drag it by its grip, or Move to… and click a line. Every line it can go on shows a faint band, the likeliest a stronger one (a Director note: the lines of the character it names and the action they're in; a Camera note: headings and action), and the line under the pointer is lit. The drop pins it there (its words stay pinned if they're on the new line, otherwise the whole line), updates the scene list, flashes the note and says Note moved to scene 2, with Undo. History says it moved.
- Brainstorm on a note (0.39.3): a posted note's Edit has Brainstorm. The canvas shows the line it's on (to read) and your note (to shape); type on it, or say what to change in Ask or direct. Each change marks the words it added, ↶ and ↷ step through the changes, and Use this saves the note, with Undo in the notice and in History. It runs within the brainstorm's limit (15 credits, held as one amount at the first change). The example notes have no Brainstorm.
- On a locked draft (0.39.3), a change the chat proposes to the script's words isn't offered: its card says The draft is locked. with Start a new draft in Story (it opens Story and makes the new draft, as New draft does; the card then offers its change) and Ignore. This is so on Story's chat and in Ask or direct on every page. A viewer reads that an editor can make it.
- Changed words are marked. When Story's chat changes the script, Check script fixes it, a heading is added or a note moves, the words that changed are marked for a moment, then fade. Your own typing is never marked.
- Opening Story changes nothing: the check only counts, the examples are worked out, never stored, until you Add or remove one.
Notes stay on their words (0.37)
- A Director, Camera or General note stays pinned to the words it was put on, wherever they move: Enter splitting the line (the note keeps the line's first words), Tab changing its type, lines added or deleted above it, a paste, an Undo, a fix. Its icon moves with the words at once, while you type. A note's Undo in History still works after it moved.
- When its words are deleted, the note goes to the line where they stood (or the one above) and keeps the words it was put on, so you can see what it was about. A note on a scene's heading follows that heading, and every note belongs to the scene it is in now.
Lock in 0.28: a floor plan for every place, free (addendum §39 A)
- Lock proposes a floor plan for every place, before any picture is made: its areas joined by doors and openings, the windows, the fixed furniture, the lights, and north from where the script says the sun comes from (with no clue, north is up). It reads every scene set in the place. It is code, not a model: Lock charges nothing for it, as for the rest of Lock. Lock's answer says so, on the Lock panel (Floor plans proposed for the Ferry, at no charge; north from the script for it. Adjust and OK each in Assets.). A door or a window is never drawn across another on one wall: a big window with no room beside the door goes on the next wall that has room. A door is named for where it leads, as the script says it (the door to the yard).
- A relock draws only what is new (a new place, a new area). A room you changed, north you turned and your OK stay as they are.
Notes, Scene and transitions (0.34)
- Since 0.39, Notes is Note ▾ over the script, and Scene opens from the scene list (above). Notes on the bar (in Full script and in Scenes) opened three kinds: Director, Camera and General. The note goes on the line the cursor is in; with no cursor in the script, on the heading of the scene in view (the one a third of the way down the window; in Scenes, the open scene). The menu says where before you choose ("Line 7 · “Emina steps off the ramp alone…”"). It is a margin note like any other: anchored to its line, it follows edits, its icon sits in the right margin there, and a click on the icon reads, edits or deletes it. It works on a locked draft too: notes are not part of the script. Director, Camera and General notes go to the Shot List; Change and Alternative idea stay yours on Story, offered when you select words in the script.
- Every note in History. Adding, changing or deleting a note is a line under History › Notes, with its Undo (an Undo refuses when the note was changed since).
- Scene on the bar, beside Notes (since 0.39: Mood, tags, line directions in the scene list), opens the scene's details in a pop-up: its tags (characters, elements, location), its Mood and its Line directions, the same fields as the scene card in Scenes, edited the same way (tags while the draft is working; mood and line directions on the locked scene). In Full script it opens for the scene the cursor is in (with no cursor, the scene in view), and ← → step to the scene before or after; in Scenes it opens for the open scene. Esc closes it. The tag line and mood line under each heading while a Highlight is on stay as they were.
- Transitions line up with the text. CUT TO:, DISSOLVE TO:, SMASH CUT TO: and the other transitions end flush with the action's right edge, as on a printed page, in both views, while editing, at every zoom and window width; FADE IN: stays at the left. The page's column is a whole number of characters wide, so a full line of action ends exactly where a transition ends. Note icons sit in the right margin and flags in the left, never on a transition; a note on a line of dialogue now has its icon in the right margin too.
The Story desk (0.23; the bar since the 0.24 hotfix)
The page is a desk: the script in the middle, the tools as buttons on one bar above it, nothing explained on the page (hover any control for what it does).
- The title block (0.29), as on every page: the eyebrow (the project's type and the page, FILM / STORY and so on, since 0.33; your role is on the project-access button), Story and one line under it. The top bar reads Projects › the project › Story. Hover the project's name there, on any page, for its intent and director's note; click it for its menu and Project settings, where both are changed. The kickoff asks the intent too; whichever you change last is the one every step reads.
- The bar runs the full width and stays pinned while the script scrolls. Since 0.39 it is one row (The Story page, above); this was the bar from 0.24 to 0.38. Its tools were buttons, in this order:
- Script / Scenes; the Draft pill (Draft N · Working or · Locked; hover it for what the lock means; a red dot means a save needs you); Check script; Suggest elements (the count of suggestions waiting shows on it); Script coverage (the reader's report; its cost shows first, the count of reports on it).
- Notes ▾ (a Director, Camera or General note on the cursor's line) and Scene (the scene's tags, mood and line directions), 0.34, above.
- Highlight: Characters, Elements, Locations, Flags (switches; Flags opens the bar that steps through the flags).
- Element (the caret line's element, and a list to change it; with Final Draft keys on); Final Draft keys (click for Plain text, the plain editor); Find (Cmd+F, Ctrl+F on Windows; a selection is the query); Find & replace; History (every change made for you, each with Undo); Cover page; Import ▾ (Fountain, Final Draft, PDF, Word, plain text, Markdown; Pages: export first); Download ▾ (PDF, Final Draft, Word, Fountain, plain text; the owner also gets the check report).
- Lock script at the right end; on a locked draft it reads Script locked · New draft.
- The Draft pill's own menu holds New draft, Unlock to edit (on a locked draft, 0.63), Name this draft… (0.63), Compare with locked draft, Restore an earlier draft, Earlier drafts (download one as Fountain; since 0.63 name or delete one too), and the saved state at the foot ("Saved 12:04", Retry, Reload).
- New draft is the one name for copying a locked draft into a working one: on the lock button, in the Draft pill's menu, in the chat box's placeholder and in the hover texts.
- The page starts with the script, right under the bar. The title page (title, credits, contact) stays off the page: Cover page shows and changes it. Downloads still carry the title page. Any words above the first heading stay on the page; since 0.45 that includes FADE IN:, which is the writer's to add in the script (the Cover page's Opening switch is gone; a FADE IN: a script already has stays as it is).
- The tag line and the mood line above each scene show only while a Highlight (Characters, Elements or Locations) is on. Otherwise the page reads like a clean screenplay. The Scenes view keeps each scene's tags and its mood card.
- The chat is in Ask or direct (0.25.1). The pill at the bottom right, Ask or direct, opens the Story chat in a floating window, as on every page; the box under the script and the panel beside it are gone, so the script has the page's width. It is the same chat: the same thread, its cards, Do it and Undo, the price before anything is sent. In the box at the window's foot, the small menu chooses what pays (Tarkovsky credits and the studio model, or your own key with a provider and a model). On a locked draft the box says so in its placeholder. Talk it through on an empty page, and a coverage note's next step, open the window on the chat. While Check script is open, the check takes the right-hand column; the window stays where you put it.
- A locked script with no elements (0.24 hotfix): once a project has been locked, if its script has no elements anywhere (no sheet in Assets, none on a locked scene, none waiting), Suggest elements carries a small dot, and Assets' empty Elements section reads None yet · Suggest elements, which opens Story and runs it. Suggest elements works on a locked draft: what you add is a tag (the words never change; a heading change waits for New draft). Since 0.25.1 an element you accept on a locked draft joins Assets at once: its sheet (its name, its tag, the Breakdown's words, its other wordings and states) and its tag on the locked scenes where it appears, with no image: nothing is made or charged until someone clicks Make on it in Assets. Undo in History takes the tags off again, and the sheet too when nothing was made for it. The next Lock keeps that sheet; it never makes a second one. On a New draft, accepted elements join at its Lock, as every tag does. Once the Breakdown has run on the draft and nothing waits for a click, the dot goes.
- Notices ("Draft 3 created") show at the bottom left, clear of Invite collaborators and Save.
The script page
The script is a formatted screenplay page set in Courier Prime: scene headings, action, character cues, dialogue, parentheticals, and transitions (flush with the action's right edge; FADE IN: at the left). Edit it in place while the draft is working. Two views are available (Script / Scenes on the bar). Script shows the whole page as one continuous screenplay, a six-inch column with the scene number in both margins; the scene's tags show in small type above each heading while a Highlight is on. Scenes is an accordion with one scene open at a time.
Tags, states and presence
A tag means one person, place or thing; a state means how it looks in a given scene. There is one LOC_DOCK; day and night are its states, and the tag reads LOC_DOCK · NIGHT in the scene. There is never a LOC_DOCK_NIGHT.
- Locations come from headings. The place is the whole heading without its time:
EXT. LIGHTHOUSE - GALLERY - NIGHTisLOC_LIGHTHOUSE_GALLERY;INT. SAM'S HOUSE - KITCHEN - DAYandINT. SAM'S HOUSE - BEDROOMare two places. Every room keeps its own tag. - States are the last parts of the heading when they are a time of day (DAY, NIGHT, DAWN, DUSK, MORNING, AFTERNOON, EVENING, LATE AFTERNOON), weather or a season (RAIN, FOG, SNOW, WINTER), with modifiers kept:
EXT. MAPLE STREET - FLASHBACK - DAYisLOC_MAPLE_STREET · FLASHBACK · DAY;EXT. GALLERY - FOG - YEARS AGOis· FOG · YEARS AGO; a modifier in a parenthetical counts too, soDAY (WINTER)is· DAY · WINTER. CONTINUOUS, SAME, LATER and MOMENTS LATER keep the previous scene's state, skipping a flashback or dream insert. A heading with no time, or with a time word the studio does not know how to light (SUPPERTIME, SHIFT CHANGE, CHORE TIME), is asked about; until you answer, the scene takes the previous scene's state as a provisional guess (see below), and the unknown word is never part of the place. - Characters come from cues and from capitals in the action. A capitals run is a character only when an age or parenthetical follows it (
ANNA (60s)), when the same name speaks somewhere in the script, when it is a group (TWO MOVERS,GUARD #1, anANGRY CROWD), or when a comma and a description follow it (SALT, an old grey lurcher). Sign text (FOR SALE), card text (FOR ANNA) and sounds (SLAMS) are not people, and card text does not put the person it names in the scene. - Presence is recorded from the cue's parenthetical:
(V.O.)is a voice-over,(O.S.),(O.C.)and(OFF)are off screen, and the tag readsCHAR_WENNA · V.O.or· O.S.. A character who also appears on screen in the scene (in the action, or with a plain cue) counts as on screen. Off-screen voices go on the sound lane and their reference image is not forced into the frame. - Extras and groups are characters of kind extra (TWO MOVERS, GUARD #1, CROWD). Their sheet in Assets is marked and needs no look unless you ask for one.
- A mention is not a presence. A character is in a scene where they speak (any cue, including V.O. and O.S.) or where the action names them plainly. A possessive in the action names a belonging, not the person: "Theo's cat" and "Anna's coat on the bed" do not put Theo or Anna in the scene, while "Theo comes in" elsewhere in the same scene still does. A possessive of the body is the person: "over Anna's shoulder", "Ronie's face" count as on screen. Names inside dialogue never count ("Your mother kept that key"), and card or sign text is blanked first. Where the code still tags someone who is only named on a card, in a letter or in someone's mouth, the Breakdown offers "Mentioned, not present … remove the tag?".
- Elements keep the
ELEM_prefix and their states follow story time, as before. Every element you tagged once is tagged in each scene whose text names it, including plurals and possessives ("the lantern's glass", "two lanterns").
Tags without manual work (0.15). Nobody tags by hand: the server tags the current draft when a script is imported (after the clean-up) and again every time Check script runs, and the check report always carries the tags. Hand tagging is for corrections, and corrections survive every re-tagging: a tag you removed stays removed, one you added stays, a Change to, a rename or a merge is kept, and an alias accepted from the Breakdown tags the character wherever the alias appears. Open questions do not block a tag: a scene whose heading has no time of day is tagged with the previous scene's state and the location chip is provisional (the first scene without a state gets none); a name the check is still asking about (a spelling one letter off, a nickname) tags the character it points to, provisional until you answer. Lock freezes the tags into the production scenes; nothing is tagged twice.
Select any word in the script, up to 40 characters, to tag it as a Character, Element, or Location; a pill bar appears above the selection. Click a tag for its menu: Change to… (Character · Element · Location · Not a tag), Rename everywhere…, Merge into…, Open in Assets. The + chip adds an existing tag to the scene, or a new one: New character or element… asks for the name (as the script writes it, up to 40 characters), then Character, Element or Location (Enter is Character), and tags it in that scene as the pill bar does (0.44, TAR-440; it used to say "Select a word in the script…" and close). Tagging works only while the draft is working. Tags survive every lock.
A tag you add shows at once (0.44, TAR-438, TAR-439): its chip appears in the scene the moment you add it, from the pill bar, the + chip, a scene's details or an accepted suggestion, and the tags Check script stored are made again with it. Until 0.44 the stored tags counted while the words were the same, so a tag added by hand after an import or a Check script was saved but never shown. Tags stored by an older release are made again the first time the page opens.
Downstream. Lock writes each scene's states and presence. Assets › Locations shows an empty slot for every state the script needs ("Night · the script needs this state"), generated from the loved base plate with Time of day, weather or season. Every shot sends the plate of its scene's state; until that plate exists, the shot cannot be generated: the Shot List, Storyboard and Dailies read "Needs: Dock · Night plate" with Create it, which makes the state plate from the loved base plate in one click (0.14; the 0.13 fallback to the base plate with a warning is gone). Projects locked before 0.13 keep their tags, with no states or presence, until the next lock.
The script toolbar
The tools are the buttons of the Story bar (above; 0.23 had them in five menus, the 0.24 hotfix put them back on the bar). Suggest elements runs the Breakdown; the check panel opens and shows its progress. Highlight Characters, Elements and Locations are switches: each kind has its own color and every name of that kind's tags is colored in the text, longest names first, plurals and possessives included; Highlight › Flags colors flagged text. Lock script locks; on a locked draft it reads Script locked · New draft, which duplicates the draft to keep writing.
- Highlight › Locations on every heading (0.16, TAR-93): a place is highlighted wherever its words appear in order, whatever separates them, so a place with rooms (
INT. CLINIC - BACK ROOM - NIGHTis the one place Clinic Back Room) is colored asCLINIC - BACK ROOMin its heading, a state after the time (EXT. PARKING LOT - NIGHT - FOG) leavesPARKING LOTcolored, a slug alone on a line that became a heading (INT. BLUEBIRD DINER - WALK-IN - NIGHT) is found with its hyphen, a possessive place (SAM'S HOUSE - KITCHEN) too, and "the parking lot" in the action is colored as well. Before 0.16 the place was looked for exactly as its name reads (Clinic Back Room), which no heading with a dash ever contained. Characters and elements keep the exact-name rule.
- Suggest elements shows what waits (0.16, TAR-94): when the Breakdown has suggestions you have not answered, the bar's Suggest elements carries the count in the accent color; clicking it opens the list. The list also opens by itself when the Breakdown lands after an import, and on Lock when suggestions are still waiting (the Breakdown stays reachable under the lock summary). The count is read when the page opens and after the text settles.
- The lock icon means locked (0.16, TAR-94): the icon appears on the Draft pill and in the corner of the page once the draft is locked; hover either for what the lock means.
- Find and Flags step with the arrows (0.16, TAR-94): Find jumps to the first match as you type and shows "2 of 5"; ↑ and ↓ (and Enter / Shift+Enter) step through the matches. Switching Highlight › Flags on jumps to the first flag and opens a small bar under the Story bar with the flag's note, "2 of 5", previous and next buttons; with the bar focused, ↑ and ↓ step through the flags in script order, wrapping at both ends; a flag whose text is gone is not counted.
Find opens a small bar: the query (a selection in the script fills it), the match count, previous and next (Enter and Shift+Enter; the match scrolls into view and is marked). Find & replace adds the replacement field, Replace (the current match, with the replacement previewed in place after it) and Replace all. When the query is the name of a character or element tag, the bar says "Renames CHAR_WENNA too" and Replace all renames the tag everywhere: the script, the tag, its asset sheet and the shots' references follow (scene states and presence follow at the next lock).
History lists every change Tarkovsky Director made for you, grouped: import clean-up, fixes and Ask choices, accepted Breakdown suggestions, assistant proposals you accepted, renames and merges. Each entry has its own Undo. A text change is undone only if the lines at the recorded position still read as the change left them; otherwise the entry says "Can't undo: the line was edited since" (nothing is guessed). An undone change stays in History (0.44, TAR-442), grayed and marked undone, with Redo beside it: Redo puts the same change back (the words, the tags, the sheet, the note), and the entry has its Undo again. A later change never clears Redo: while it has touched what Redo would put back, the entry says why in Redo's place ("Can't redo: the line was edited since."), and once that change is undone, Redo is offered again. Undoing an accepted suggestion removes the tag it added; an accepted assistant proposal also has Undo on its card in the chat. History keeps the last 500 changes with the project.
Cover page opens a small form (title, written by, draft label, date, contact) and writes it as the Fountain title page at the top of the script (Title:, Credit: Written by, Author:, Draft date:, Contact:), replacing an existing title page. The page you write on never shows it. Date opens a small calendar under the field with today's date marked (0.45): pick a day and it is written as October 25, 2026 (0.46; 0.45 wrote 25 October 2026, which is still read), and the Fountain, Final Draft, Word and PDF downloads and their imports read it back as the date; Today picks today. The field still takes any date you type, and a date already in it (also in Draft 2 · October 10, 2026, or written 10 October 2026) is where the calendar opens; a picked day replaces only that date. From the field, Down moves into the calendar; the arrows move a day or a week, Page Up and Page Down a month (with Shift, a year), Home and End the week's ends, Enter picks, Escape closes. On a locked draft the form shows the title page without changing it. Import lists Fountain, Final Draft, PDF, Word, plain text and Markdown (Pages: export as PDF or Word first). Download is the download menu described under Drafts.
Drafts
The Draft pill reads Draft N · Working or Draft N · Locked with a lock icon (since 0.63 a named draft's name leads its hover). Its menu holds New draft (a copy of the draft to keep writing in), Unlock to edit (0.63: write in a locked draft with its number), Name this draft… (0.63), Compare with locked draft (counts of changed, added, and removed scenes), Restore an earlier draft (it asks first, 0.63), Earlier drafts (each downloads as Fountain; since 0.63 each can be named or deleted), and the saved state; Lock script and History are buttons on the bar. Import brings in a .fountain, .txt, .md, Final Draft .fdx, PDF or Word .docx file; nothing is overwritten: in a project with words it is a new draft and the words you had are kept under Earlier drafts, and in an empty project it is Draft 1 (0.61). A Final Draft file keeps its paragraph types: action after a speech stays action, headings and transitions stand alone. Download gives PDF, Final Draft, Word, Fountain or plain text; the project owner also gets Download check report .json (below). This release retains up to 50 drafts per project.
Import PDF and Word, download PDF, Final Draft and Word (0.16, TAR-45)
- Words before the first scene heading (0.50, Zach's W20, from a user's report): an imported script keeps everything before its first scene heading, as written and in its order. Only the clear title-page fields go to the Cover page: the title, written by and the author, the draft and its date, and a contact line (an email, a telephone number, a web address, Contact: …); since 0.61 the writer's name and address too, and a plain-text file's title page (see The script in 0.61 above). The first line is the title only on a page shaped as a title page (one of those fields is there too) and when it isn't a sentence. Anything else before the first heading (a logline, A short film, a note on the text) stays in the script, and the check flags it to keep or ignore (below). Until 0.50 a Word file whose first paragraph was in capitals had up to six paragraphs taken as its title page, and a PDF's first page all of it.
- Import a PDF (0.16, TAR-45): a PDF with a text layer is read page by page and its text takes the same path as any upload: the import clean-up, "Reformatted N lines. Please review." and the Script check. Lines are rebuilt from the page, blank lines from the spacing, page numbers and running headers are dropped, scene numbers in the margins are kept, a speech split with (MORE) / (CONT'D) is joined again, and a title page's clear fields come back as the cover page (0.50: its other lines stay in the script; a long title the download wrapped over two lines is one title). A scanned PDF (no text to read) is refused with a clear message: run OCR, or export the script again from the app that wrote it.
- Import a Word file (0.16, TAR-45): a
.docxis read as paragraphs; a speaker's name is joined to the lines under it so the check reads speech; the clear title-page fields before the first heading become the cover page, and every other paragraph stays in the script (0.50). An old.doc,.rtfor.odtis asked to be saved as.docxfirst. Pages: the menu entry says it: export from Pages as PDF or Word, then import that file. - Import Final Draft (
.fdx; 0.38.2, Zach's §48 E): the file is read as Final Draft writes it. - The script's own pages are imported as the script, wherever the title page sits in the file. From 0.39 the title page comes into the Cover page: the title, written by and the author, the draft, the date and the contact lines (set left or justified, an address, an email). From 0.50 a title-page line that is none of these (Based on the stories of Van Worden, A short film) stays in the script above the first scene heading, in its order (until 0.50 it was dropped), and the message after the import says so: 2 lines of the title page stay in the script above the first scene heading: keep or ignore them in the check.
- From 0.39 Final Draft's script notes come in as Story notes, pinned to their line (Zach's 20 Oct list): a Camera note stays a Camera note; a Character description becomes a General note on its line and is also offered as that character's description on the character's page in Assets (From Final Draft's notes, Use it or Not now); any other type is a General note; a note Final Draft keeps unattached goes on the first line of the character it names (their first cue, or the line that introduces them in capitals), else on the first heading. Empty notes are skipped, and no note's words enter the script. Each note shows Final Draft · its type. Importing the same file again offers the same description once.
- Each element keeps its type: heading, action, character, parenthetical, dialogue, transition, shot. Two speeches side by side come in as dual dialogue: Fountain's
^after the second cue (VAN WORDEN ^). From 0.39 (TAR-407) Check script, the tags, the editor and the downloads read it as a cue (no stray-character or capitals finding; the PDF and Word never print the^), and the Final Draft download writes the two speeches back side by side. - A General paragraph that reads as a transition, in capitals (
DISSOLVE TO THE FERRY QUAY.), comes in as a transition (0.39); any other General paragraph is action. - An index card on a scene heading never takes the heading's place. The card comes over as a General note on its scene's heading (Opening: Emina opens the shop.), and the message after the import says how many came over.
- Check script notes any words above the first scene heading: The script has a line before its first scene heading…. They belong to no scene, so the Breakdown, the tags and Lock never read them. A title page and a lone FADE IN: are not counted. 0.50 (W20): this note is the flag an import's words before the first heading get, to keep or ignore. It ends Keep them as written, or give the scene its heading (INT. or EXT.) above them., and offers Keep beside Ignore and Flag: Keep leaves the lines as they are and the check doesn't ask about them again (Kept as written. The check won't ask about these lines again.); Undo in Set aside brings the note back. From 0.39 a script with words and no scene heading at all is told too, as blocking (The script has no scene heading…): Lock and Suggest elements need one, so the check never reads clean while they refuse.
- Download PDF (0.16, TAR-45): standard screenplay format. Courier 12; margins 1.5" left, 1" right, top and bottom; scene headings and action at the margin; character cues at 3.7"; dialogue at 2.5", 3.5" wide; parentheticals at 3.1"; transitions flush right (FADE IN: at the left); 54 lines a page; page numbers top right from page 2; scene numbers in both margins when the script carries them (
#12#after the heading); a heading or a cue never alone at the foot of a page; a long speech split with (MORE) and NAME (CONT'D). An unlocked draft prints WORKING DRAFT in the page header; a locked draft does not. - Download Final Draft (0.16, TAR-45): a
.fdxwith one paragraph per element (Scene Heading, Action, Character, Parenthetical, Dialogue, Transition), scene numbers on the headings and the cover page as the Final Draft title page. Importing the download again gives the same text. - Download Word (0.16, TAR-45): a
.docxin Courier New 12 with the same margins, indents, page numbers and WORKING DRAFT header, the cover page first. - The cover page travels (0.16, TAR-45): the title page the toolbar's Cover page form writes (title, written by, draft label, date, contact) is the first page of every PDF, Final Draft and Word download, and its draft line is the draft you downloaded: the cover's own label when it has one, else the draft's. Downloading is allowed at any time, on a locked draft too, and never changes the project; an earlier draft downloads from the draft pill's menu as Fountain, or by its id from
GET /api/projects/:id/story/export/<draftId>.<pdf|fdx|docx|fountain|txt>(currentfor the working draft).
When the draft is locked, the page is read-only, a small lock icon sits in the top-right corner of the script page (it disappears while the draft is working), and the toolbar's Lock script button reads Script locked · New draft: clicking it duplicates the draft so you can keep writing. The server refuses to save text into a locked draft; tagging, renaming and merging wait for a working draft too.
Import: reformatted, never silently
Import clean-up is part of Check script. The check runs on the file exactly as delivered, applies the automatic fixes, and the panel opens with "Reformatted N lines. Please review." and the list of what changed, each with its line number in the uploaded file and an Undo (and Undo all). Undo is available until you edit the script. Nothing else is changed without a click. Pasted text gets the same automatic fixes.
0.22 (TAR-247): every change the panel lists is in the saved draft. A heading imported without its period ("INT LIGHTHOUSE - NIGHT") is saved as "INT. LIGHTHOUSE - NIGHT", like a speaker's cue without its space ("MARGIT(V.O.)" → "MARGIT (V.O.)"). Before 0.22 the server cleaned the upload again without the heading fixes, so a listed heading fix could be missing from the draft.
0.22 (TAR-259): at Lock, a name a sheet gives a person ("the beekeeper") tags them through a possessive of the body as well, with up to two describing words between ("the beekeeper's open mouth"). A possessive of a belonging ("the beekeeper's veil on the gate") does not put them in the scene.
Check script
Check script opens a panel in place of the chat. Every finding names its line and scene and belongs to one of four groups, by how it is handled:
- Auto — fixed on import and listed so it can be undone; on a hand-typed script, Apply all fixes them with one click. Headings in lower case (
ext. dock - night); a heading glued to the end or start of an action line (a PDF import joined two lines); speaker-name variants (SAM.,SAM (CONT'D),SAM (cont'd)becomeSAM); double and trailing spaces; a space before punctuation (rock .); more than one blank line between blocks; invisible zero-width characters and a byte-order mark, non-breaking spaces (also inside a speaker's name, which is still read as the speaker), soft hyphens, tabs, a�where an apostrophe was, mis-decoded text (didn’t,é: a file saved in one encoding and read in another is decoded back), two dots where an ellipsis has three, and an apostrophe style that differs from the rest of the script. Every one of these is listed with its line; nothing is fixed silently. - One click — a Fix button, and Fix all where it is safe. Action caught inside dialogue (Make it action); a heading-like line that would become a speaker name (
THE BEDROOM - NIGHTunderINT. SAM'S HOUSE - KITCHEN - NIGHTis offered asINT. SAM'S HOUSE - BEDROOM - NIGHT: INT./EXT. from the place words or the enclosing scene, the parent place from the last house of the same kind); a time alone on its line (LATER,MOMENTS LATER,DAWN) or a sub-place alone (THE WALK-IN,THE KITCHEN), offered as a heading with the current place filled in (INT. BLUEBIRD DINER - KITCHEN - LATER,INT. BLUEBIRD DINER - WALK-IN - NIGHT) and never read as a character; a heading spelled out (EXTERIOR …); a transition at the end of a line (… CUT TO:); a parenthetical that never closes, one with no speaker above it, or one after a speaker's last line ((beat)with nothing under it: Remove it or Make it action); a character's first appearance not in capitals (Sam (40s)→SAM (40s), and all in lower case too:nora (40s),june drags the crate); a numbered place written with digits (Room 6when the heading says ROOM SIX). - Ask — your call; the app never guesses. A character name with no line under it, or with only a parenthetical under it (
RAYthen(nods)): delete it, or write the line; a heading without a time of day (keep the previous scene's, or choose;EXT LAKE DAYwith the dash missing offersEXT. LAKE - DAYfirst); an unknown time word (SUPPERTIME: EVENING?;SHIFT CHANGE,CHORE TIME: keep the previous scene's or choose); a misspelled word, with its three likeliest spellings as buttons (best first), Custom… (type the spelling yourself; Replace puts it on the line), Ignore and Add to dictionary; a name one letter off or missing an accent (Ana/Anna,JOSE/JOSÉ), renamed everywhere with one click; a nickname of a known character in the action or as a speaker (Juniefor JUNE,Sammyfor SAM,Nickyfor NICK: Add as alias, so the nickname tags the same person; a nickname inside dialogue is speech and is never a finding); near-duplicate locations (DOCK/THE DOCKS,MAPLE ST/MAPLE STREET), merged everywhere with one click. Two different kitchens, and two numbered rooms (ROOM 6,ROOM 9), are never offered as one. - Notes — information only: CONTINUOUS into a different place when neither the last lines of the scene before nor the first of the new one show the move (rooms of one place, and a move written on the page, "she carries the box through the door", need no note); a line in capitals that is neither heading, character nor transition. A transition written without its colon (
CUT TO TITLE CARD.,SMASH CUT TO BLACK.) is a transition when it stands on its own or ends a scene (0.39); inside an action paragraph, or a sentence that happens to say "cut" (CUT TO THE BONE, EMINA SCREAMS.), it stays action. Each note has Dismiss (set it aside) and Flag (a mark in the script margin until you resolve it).
Spelling. A word is flagged only when it is lower case, at least four letters, not English as far as the studio can tell (a bundled word list with a supplement of everyday modern words, inflections and agent nouns such as percolator, British spellings, prefixes and compounds) and one edit away from a word that is. Dialect and speech (ain't, y'all, gonna, lemme, a leading or trailing apostrophe as in fixin' and 'bout, a dropped g as in nothin), names and nicknames from the script (characters, places, elements), and the project's dictionary are never flagged; speaker cues and headings are never checked. Add to dictionary keeps the word for this project.
Each finding still carries its level: blocking findings would create a second character (a heading-like cue, a cue one letter off a more frequent one) and keep Lock script disabled until fixed or ignored; continuity, format and spelling do not. The check is rule-based: no model call, no credits.
The 0.15 grades, as general rules (0.16, TAR-95).
- Scenes are numbered on the corrected script. The check report and the Breakdown number scenes on the script as it stands after the heading fixes (a lone
LATERorTHE BEDROOM - NIGHTmade a heading), so a tag never lands one scene off from a suggestion; the chips on the page follow the text on screen. - A flashback's season or time does not leak forward.
EXT. LAKE - DAY (SUMMER) - FLASHBACKfollowed byEXT. LAKE - DAYis summer only in the flashback; a heading without a time inherits only the previous scene's time of day, never its season, weather or flashback marker;DAY (SUMMER, 1998)reads as DAY · SUMMER, not as part of the place. - A month is not a character. "June 14 is circled on the calendar", "in June", "every Sunday" tag nobody; a character called June is tagged where she speaks or acts ("June waits by the gate").
- A heading without its punctuation is read into its parts.
EXT LAKE DAYis the place LAKE at DAY (never a place called LAKE DAY), and the formatted headingEXT. LAKE - DAYis a one-click fix, also forINT KITCHEN NIGHT,EXT. LAKE DAYand a prefix missing its period. - Misspellings inside possessives are checked.
freind'sis asked about withfriend'sfirst; a correct possessive is left alone. - A nickname used only in dialogue is offered as an alias by the Breakdown ("Sammy" for SAM), never as a misspelling or a second character; a nickname in the action or as a speaker stays the check's own ask.
- One finding per invisible character. A zero-width space, a soft hyphen or a non-breaking space is reported once; the word it split is not also a misspelling, and a non-breaking space at the end of a line or inside a run of spaces is the spacing finding alone.
Set aside and flags
Anything you Ignore, Dismiss or Flag leaves the lists and goes into Set aside · N, a drop-down at the top of the check panel. Each item has Open (scrolls the script to the line and pulses it) and Undo (brings the finding back). Set-aside items are stored with the project by the finding's kind and text, so running Check script again, on this draft or the next, does not show them again.
A flag is a note you want to come back to. It puts a small mark in the script margin next to the first line that holds the text; hover it for the note, click it for Resolve, which removes the mark (the finding stays set aside). The Flags highlight toggle in the toolbar colors the flagged text.
Change to, on suggestions and tags
Every Breakdown suggestion card and every tag chip has Change to: Character · Element · Location · Not a tag. On a suggestion, it accepts the thing as the kind you choose (an element the model proposed, added as a character; a capitalized word the rules did not tag, added as either); Not a tag ignores it. On a tag chip it changes the kind of that tag in the scene, and Not a tag removes it from the scene. A capitalized word's Add is two buttons, Character and Element, the model's suggestion first. A "mentioned, not present" suggestion (someone talked about in a scene they are not in) has Remove the tag, which takes the character out of that scene, and Ignore, which keeps the tag. Nothing is applied without a click; every acceptance is listed under History with its own Undo.
Download check report
The project owner can download the current draft's check report as <title>-check-report.json (from the Script check panel's header; since 0.55 it is no longer in the Download menu; also GET /api/projects/:id/story/report). It holds the Script check findings of the working script (kind, line, scene, handling, text), the tags with state, presence and kind (the locked scenes' while the draft is locked, otherwise the draft's own tags, each open one marked provisional), and the counts, in the format the planted-error grader reads. It is how a graded run of the live app is recorded.
Lock script
Lock script creates production scenes, marks scenes changed since the last locked draft, creates an asset sheet for every tag that has none (characters, locations, elements; groups marked as extras), records each scene's location states and character presence, and records the draft. A summary shows scenes (changed and removed), characters, locations, elements, and what is new in Assets.
Scene identity
Lock matches each scene to the last lock's scenes in their order: by its heading (when a film returns to the same heading, each visit with the visit whose words match, the second EXT. GRASSY PLAINS - DAY with the second), and, since 0.61.1, a renamed heading by its words, so “Script changed” marks the scenes whose text or heading changed. If the new script leaves out a scene that has shots, Lock stops to protect them and names the scene: put it back, or delete its shots on the Shot List, then lock again.
Rename everywhere and Merge into
Every tag chip's menu has Rename everywhere… for every kind (characters, elements and locations), Merge into…, Change to… and Open in Assets. Renaming replaces every occurrence in the working script and keeps the case; cue lines stay uppercase. The tag id changes with the name (CHAR_WENNA becomes CHAR_NORA), and the asset sheet, the scene tags and the shots' references follow. The dialog shows what follows first: the occurrence count, the scenes, the sheet and the shots. Renaming is also what Replace all does when the Find & replace query is a character or element name. A rename has an Undo in History.
- Assign to… (0.16, TAR-92): on a character tag, links this name (a nickname, a role name, a variant the script uses: Junie, the old man) to one person: one tag and one asset sheet, with the alias listed on the sheet, so the script tags that person wherever the name appears from now on. The submenu lists the other characters; the dialog says what follows. If the name had a tag of its own (scenes, a sheet, shots' references), it is folded into the person exactly as Merge into… does, and its sheet's plates, looks, references and states join the person's where they are missing; the alias goes on the person's sheet, or on the person's tag until Lock makes the sheet. The check's Add as alias and the Breakdown's alias suggestion use the same mechanism, so accepting either links the names in the same way. The tag menu shows the person's aliases ("Also: Junie, The Old Man"). The script text never changes. An assigned name wins over the engine's own reading of it: a name introduced in capitals or speaking under its own cue (
YOUNG WENNA) that you assign to Wenna tags Wenna from then on, in the page's tags and in the check's. There is no Undo in History; re-tag by hand if needed. Scene states and presence recorded by the last lock are rewritten at the next lock.
Merge into… lists the other tags of the same kind. Merging folds one tag into another: its scenes, scene tags and shot references move to the target; the target's own state or presence wins where both have one; the merged sheet's plates, looks, references and states join the target's where they are missing, its name becomes an alias of the target, and the sheet is removed. The script text is not changed (use Rename everywhere for the words). The confirmation says what follows in one line. A merge has no Undo. Scene states and presence recorded by the last lock are rewritten at the next lock; the scene tag lists change at once.
Director’s note
Hover the project's name in the top bar to read the intent and the director's note; click it, then Project settings, to change them (Intent, Director's note, Visual language). The kickoff asks the intent too and keeps the same answer. Write the intent, the director's intention, and the visual language. The visual language is included in image and video prompts. Avoid including finishing effects that you intend to add later. Describe people and animals on their sheets in Assets, not here.
Chat
The chat opens from Ask or direct, the pill at the bottom right (0.25.1, above), in a window you can move and resize. Its placeholder reads “Ask about the script, write, revise, or brainstorm a scene.” With Tarkovsky credits, the studio model answers: select Estimate, then Send. To use your own key, open the small menu in the box, choose My API key, then a provider and a model. A reply can carry tracked edits as a Proposed change · Scene N card: the text to delete is struck through and the replacement follows, with Accept and Reject. Accept applies the change to the working draft; nothing is applied without a click. An accepted card shows Undo, and the change is listed under History in the toolbar. A reply without edits can be appended to the working script. On a locked draft, accepting needs a working draft first.
The thread is saved with the project (0.15). Every message and reply, with its proposal cards and your Accept or Reject on each, is stored on the server per project and per tab, so the Story chat and every tab's Ask about pill pick up where you left off on any device, and Check script, Suggest elements, an upload or a tab switch no longer wipe them. The model reads the saved thread as the conversation (the last eight turns). The bin icon at the top of the chat's window clears the thread for everyone on the project. Owners and editors write; viewers read.
One collaborator, no modes. The chat reads what you want from each message: thinking out loud, an opinion, a request to write, or your own pages pasted in. It talks when it is unsure and writes pages only when asked; it never restates your message, opens with praise, or claims to have changed the script. On a Commercial project the brainstorming turns to the brief: seeds tied to the one message, the brand moment, nothing invented beyond the brief. The prompt lives in src/server/prompts/story-collaborator.md (with story-collaborator-commercial.md), versioned.
Ask about a tab sees its tab. On every other tab, the Ask about pill sends what the tab shows with the question, as data: the shots on Shot List (label, scene, size, lens, move, seconds, description, whether a still and takes exist), the takes on Dailies (name, shot, seconds, loved or liked, in the cut), the timeline on Edit (clips in order with trims, V2 overlays, the audio lanes), the stills per shot on Storyboard, the sheets on Assets, the finishing and cutdowns on Export, the brief on Brief. The context line under the pill's header says how many rows go with the question. Rows are capped, and the model is told to treat them as material, never as instructions.
Script coverage
Coverage you can act on (0.52, films and commercials): Script coverage on the bar opens a panel on the right that doesn't block the page; the page stays editable beside it, and the bar's button closes it again. The price shows first in the panel (the opening lines, the cost, Run coverage or Cancel), then the report, saved with the draft:
- The verdict on the script only: a film's Recommend · Consider · Pass, a commercial's Ready · Close · Rethink, with one sentence of reason.
- A film's logline and synopsis; a commercial's idea in one line.
- Start here: up to six areas to work on first, ranked, each with one line saying why; click an area to go to its note in the panel.
- On a commercial, The brief, reviewed too: a rating, a line on each weak field and a suggestion for it. Fields Write the concept filled in are marked From Write the concept and reviewed as closely as the script.
- Each area rated Excellent · Good · Fair · Poor, with To make it great:, the one change that would most improve it. Click a shot (a scene on a film) to go to it; on a phone the panel closes first.
- A commercial's coverage reads the brief (each field with who wrote it: you, or the studio), the brand rules, the lengths and the shots S1, S2, … with picture, sound and seconds. A film's reads the script as before. Older reports still show, with their top notes.
Every note: Use · Brainstorm · Ignore · Flag. Once you choose, the note reads Used, Flagged or Ignored, with Undo.
- Use shows only when the coverage wrote the change out (a line of picture or sound, a super, a line added to a shot, a shot's length, a field of the brief; on a film, a passage of one scene). The note shows it first as before → after. Use puts it in with no model call and no cost, as one step of the page's Undo: Cmd+Z takes it back, and so does the note's Undo. The words it adds are highlighted in amber and the words it cuts show struck through in amber where they were (shown only, never part of the text); a length or a brief field it changes is highlighted too. Changes you use stay highlighted until you close this panel. When the shot (or scene) no longer reads as the coverage quoted it, Use changes nothing and says This shot has changed since the coverage was written. Brainstorm it instead.
- Brainstorm opens two windows: the draft (the note's shots in Picture and Sound with their lengths, the brief's fields for a note on the brief, or the scene on a film), with the fix already in it, and the chat, which opens on the note's own words for free: the fix, then It's in the draft. Change it there, or tell me here. (or Change the draft yourself, or tell me here.). Each message after that costs about 1 credit: priced first, the most it can cost held when you send it, only what it used charged, the rest released (nothing at all when the answer can't be used). Use this puts the draft in, highlighted the same way.
- Ignore hides the note; Show 1 ignored note brings it back.
- Flag puts a flag in the margin beside the note's first shot or scene (on a film, its heading), with the note's words, marked Flag · coverage; Resolve removes it. A note on the brief, or with no shot, flags that field of the brief (or the whole brief). Coverage flags count in Flags.
The coverage PDF's date (0.50, Zach's Q2): the footer and the line under the title write the day as October 25, 2026, as the Cover page does. Since 0.52 the PDF follows the panel: the verdict, the idea or the logline and synopsis, Start here, the brief, and each area with its fix and its change.
Script coverage in the toolbar asks a reader for the report a studio or contest reader writes: a logline, a neutral synopsis, comments by area (premise, structure, characters and arcs, dialogue, story logic and stakes, pacing and tone, theme, visual storytelling and filmability, craft and format, market and audience), each rated Excellent · Good · Fair · Poor, up to six top notes with a soft next step, and a verdict on the script only (Recommend · Consider · Pass, with one sentence of reason). It is one reader's honest view, written so the next draft is better; the writer decides what to do with any note.
Before anything runs, a pop-up says what coverage is and shows the cost: coverage reads the whole working draft once on the studio's strongest reading model (anthropic/claude-opus-5.5 unless the admin sets coverage_model), paid in Tarkovsky credits, with the maximum shown first and unused credits released. Run coverage or Cancel. The report is saved with the project and marked with the draft it read; when the toolbar button shows a count, clicking it opens the latest report, and the panel's drop-down lists earlier ones (an earlier draft's report says so). The panel takes the place of the chat; close it to return.
Every comment and note shows sc. N chips: click one and the script scrolls to that scene and pulses its heading. PDF in the panel header downloads the report (GET /api/projects/:id/story/coverage/:id.pdf): plain and readable, with the title, draft label, date and reader model, numbered pages. Owners and editors run coverage; viewers see the price and read the reports. The prompt lives in src/server/prompts/script-coverage.md, versioned.
- A pop-up beside the chat (0.16, TAR-91): Script coverage on the bar (with the count of reports) opens the latest report in a pop-up at the right of the page, over the chat, never in its place: the script stays in view, the chat stays where it was, and the check panel is not closed. With no report yet, or with the report already open, it runs coverage (the cost shows first). Before 0.23 the chat header had its own Coverage button.
- A note jumps to its scene (0.16, TAR-91): click anywhere on a comment or a top note and the script scrolls to the first scene it applies to and pulses the heading; the sc. N chips still open any of its scenes.
- Notes remember what you did (0.16, TAR-91): every comment and top note has Done and Dismiss; a next step sent to the chat marks the note Discussing. The state is kept on the report with the project (
noteStateson the coverage entry), so it reads the same on every device and after a reload; a done note is struck through, a dismissed one leaves the list (Show N dismissed notes brings them back to read or undo). Owners and editors set states; viewers read them. - The draft has changed (0.16, TAR-91): the report stores a hash of the text the reader read; when the working draft no longer matches, the pop-up opens with a notice, "The draft has changed since this coverage was written (Draft N, date)", so the notes are read as notes on that text. Reports written before 0.16 compare by draft number.
- A next step is a real exchange (0.16, TAR-91): the button under a top note sends the request to the chat as your message (it appears in the thread at once), the price is fetched and shown under "Thinking…" while the model answers on credits, and the reply follows with its proposal cards; nothing is pasted into the composer. On your own key with no model chosen, the request lands in the composer instead and the page asks you to pick a model.
Margin notes
A margin note is your own note beside the script: kept with the draft, never part of the screenplay text. Kinds (0.34 names): Director (performance, blocking, tone; Directing before 0.34), Camera (how to shoot it), General (anything to remember; Note before 0.34), Change (something to rewrite) and Alternative idea. Director, Camera and General notes go to the Shot List; Change and Alternative idea stay on Story. Add one with Notes on the bar (Director, Camera or General, on the cursor's line: 0.34, above), from a scene's tag row (the small note chip next to the + chip puts the note on the scene heading) or by selecting text in the script: the pill bar above the selection gains Note, every kind is offered there, and the note sits on that line. A note follows its line when the text moves (it remembers the line's text); if the line is gone it falls back to the scene heading.
Since 0.39 notes sit in the page's margin beside their lines (The Story page, above); on a phone they keep their small icon. Notes showed as small icons in the right margin of the line (a pencil, a lens, a play mark, ± for a change, a star for an idea; a count when several share a line). Click the icon to read them, Edit or delete, or Add another. Flags from Check script keep the left margin and their red mark, so the two never look alike. Notes belong to the draft they were written in; a duplicated draft starts clean. Viewers read notes; owners and editors write them, on a locked draft too.
What changed in 0.17 (round 5)
- Three choices everywhere. Every finding of Check script, every Breakdown suggestion (in the panel and in the pop-up that opens on Lock), every Script Coverage note and every chat proposal offers the same three buttons: Do it, named after the change when it can be ("Change to EXT. GRASSY PLAINS - DAY", "Add the alias", "Remove the tag", "Change scene 3"; otherwise Fix or Add), Ignore, and Flag, for later. Bulk is Fix all or Add all. Every Do it goes into History with its own Undo. Skip, Dismiss, Noted, Accept and Reject are gone. A flagged Breakdown suggestion stays in the list and in Highlight › Flags until you decide; a flagged chat card stays open and can still be applied. On a coverage note, Do it is its next step (a comment's is Revise with the chat), sent to the chat; notes marked Dismissed or Discussing before 0.17 read as Ignored and Flagged.
- Heading fixes whenever the script is checked. At import, at every Check script and at Lock, a heading in lower case, a slug alone on its line, a heading without a dash are fixed at once, each with a note saying what changed and why ("1 heading fixed by the check") and its own Undo in the panel and in History. An undone fix is never applied again by a later check, the Breakdown or Lock; it waits in Set aside as undone, and Bring back applies it at the next check.
- One Lock. The Lock button in the toolbar and the one under the check run the same path: the check, then the lock when nothing blocks. When something blocks, the panel says what ("1 question to answer before Lock") and opens the first one, with Show me to go back to it.
- A suggestion that proposes a change offers it. A heading the action contradicts ("- NIGHT" over the morning sun) offers Change to INT. KITCHEN - MORNING, editable on the card before you apply it, with Undo, Ignore and Flag.
- Mood and line directions. Lock reads each writer's parenthetical as the line's direction. The scene card (Scenes view) shows the scene's Mood and every dialogue line with its direction, all editable; your edit is marked yours. The Breakdown proposes a mood for a scene that has none and a direction for each line without a parenthetical; you edit and add them one by one or with Add all, each with its Undo. On a relock a direction stays with its line; one whose line changed is kept and flagged Line changed, with Place on… to put it on a line again. The mood shows under the scene's tags in the Script view.
- A change of kind sticks everywhere. Change to… Element (or Character) converts every mention in every scene, the asset sheet with its images and references, and the shots' references, in one color, and it holds through every Check script and Lock. Undo in History changes it back.
- One word, two kinds. When the same word is tagged as a character in some scenes and as an element in others, the check asks once: Every mention is the character, Every mention is the element, or Name the character: give the featured one a name and tick its mentions; those take the name in the text, the others stay the element.
- Aliases are used everywhere. An alias lives on the character's sheet (Also called, and Assign to from the sheet or the tag menu). It is highlighted in the character's color; where it acts in a scene the character is present there, and the shots of that scene send the character's reference, labeled with the alias. Script Coverage reads the alias list.
What changed in 0.18 (round 6)
- The script saves itself. Changes save a moment after you stop typing, and at once when you switch tabs, hide the page, leave it or press Cmd+S (Ctrl+S). A status sits beside the script and in the top bar: Saving…, Saved 12:04, or Couldn't save, retrying with Retry now: a server or network failure is retried on its own, on a growing delay, until it lands, and your changes stay on the page meanwhile. A refusal the server will repeat says Couldn't save with the reason and tries again at your next change. When another session saved first, saving stops and the status says Another session changed this project with Reload: it loads the latest version and puts your changes back on top; where the other session changed the same thing, it asks first, and if you keep theirs your version of the script is downloaded so nothing is lost. Nothing is ever overwritten without asking. The Save button stays, but nothing depends on it.
- A save that can't go through says so (0.71.1). A large project saves only what changed, never the whole project at once. When a save is refused and trying again won't fix it, a red notice says why. Reload gets the latest version, puts your changes back on it and saves once. If the studio refuses them again, you get a copy of your changes as a file, and the latest version shows without them. The note says which parts were left out. If the refusal is one that passes with time, your changes stay on the page, and the notice asks you to press Reload again in a few minutes. Changes you made on the plan or the board meanwhile wait, and go as soon as a save goes through.
- The find bar stays in view. It is pinned at the top of the script while the match it jumps to scrolls to the middle of the page. Whole word finds "one" alone, not in cone, gone or someone; Match case tells ONE from one. The count, the marks and Replace all follow both.
- Do all in the Story chat. When a reply proposes several changes, Do all (4) sits above the cards. It makes them all as one change: one line in History, one Undo (on any of the cards or in History). Each card keeps its own Do it, Ignore and Flag; a card whose text is no longer in the script is left open and the message says why.
- A text change carries its tags. When a change made for you (a chat proposal, Do all, Replace or Replace all) replaces a tagged name with another, "the sedan" becoming "the pickup truck", the tag moves in the same change and the same Undo: when the old name is gone from the script, the tag is renamed and its asset sheet, scenes and shots' references follow; when it is still used elsewhere, only the scenes the change touched are retagged (a scene that still names the old thing keeps both tags), and once the last mention goes the sheet takes the new name too. Nothing moves on a guess: a pronoun ("It pulls away"), a rewrite, or two different replacements leave the tags as they were.
- The chat sees the tags. The Story chat reads each scene's tags (as the page shows them) and the aliases, and can propose tag changes as cards: PROPOSED TAG CHANGE · SCENE 1 with "ELEM_SEDAN → ELEM_PICKUP · everywhere", applied with Do it (also on a locked draft, as tag edits are). A text proposal can carry its own tag change. The chat says what it checked rather than "done" or "nothing to change" about what it cannot see (images, shots, sheets). The Ask pill on other tabs gets text edits only.
- An answer that could not be used says so. A chat reply that came back empty, a Script Coverage report that could not be read, and a Breakdown run that was cut off say Didn't run with the reason, and Retry; nothing is saved and nothing is charged. They never look like a clean result.
- The Breakdown takes you to the scene. A suggestion's scene numbers, its quoted words ("“Someone left the gate open”") and a direction's quoted line are links: the script scrolls there and the words stay highlighted until the next link or Escape. The list docks beside the script, at the right of the page, so the line and the open suggestion are seen together.
- Asset cards say "1 state", not "1 states".
- An editor that types like Final Draft (TAR-152): its model was built in 0.18; from 0.19 it is the page's editor (below).
The editor that types like Final Draft (0.19)
The script page types like Final Draft. Since 0.39 there is no switch: the keys always work by Zach's table (The Story page, above), and the plain text editor is gone. From 0.19 to 0.38, Final Draft keys in the script toolbar was on by default; Plain text was the editor before 0.19.
- Every line has an element you set: Scene Heading, Action, Character, Parenthetical, Dialogue, Transition, Shot. It is shown as screenplay formatting and kept with the script, never guessed again from the words. The element menu in the toolbar shows the element of the line the caret is in and changes it. An empty line shows its element's name in gray until you type.
- (0.19 to 0.38; the table above is today's.) Enter at the end of a line opens the next element: after Action, Action; after Character, Dialogue; after a Parenthetical, Dialogue; after Dialogue, Action; after a Scene Heading, Action; after a Transition, a Scene Heading. Enter on an empty line changes its element instead of leaving a blank line behind, as in Final Draft: an empty Dialogue becomes Action, an empty Character becomes Dialogue. Enter inside a line splits it; Shift+Enter breaks the line inside its paragraph (a speech on two lines).
- (0.19 to 0.38.) Tab at the end of a line: after Action, a Character line; after a Character, a Parenthetical (with its brackets, the caret inside them); after Dialogue, a Parenthetical. Tab on an empty line cycles the elements: Action, Character, Parenthetical, Dialogue, Transition, Scene Heading, Shot, and back to Action; Shift+Tab goes back.
- INT., EXT., I/E or INT./EXT. at the start of a line makes it a Scene Heading (never "Into" or "Extra", and never inside a speech). Scene headings, characters, transitions and shots are in capitals as you type. A heading typed in the middle of a scene starts a new scene; the caret goes with it.
- Autocomplete. On a Character line, the script's characters and the other names it knows them by, and the character sheets, are offered by their first letters; on a Scene Heading, the script's places and the location sheets after INT. or EXT., and the times (DAY, NIGHT, DAWN, CONTINUOUS…) after " - ". Enter or Tab takes the highlighted one, the arrows move through the list, Esc closes it.
- A Shot is stored as a line in capitals that names the camera (CLOSE ON, ANGLE ON, POV, INSERT, BACK TO SCENE, or a line ending in a colon), so every Fountain reader keeps it.
- Bold, italic, underline: Cmd+B, Cmd+I, Cmd+U (Ctrl on Windows) on the selection. They are kept in the script as Fountain emphasis (
bold,*italic*,_underline_), printed in the PDF and Word downloads and written as Final Draft text styles; Check script, the tags and the Breakdown read the words without the marks. - No automatic (CONT'D). A (CONT'D) you write, or one in an imported script, stays as written.
- Undo and Redo: Cmd+Z and Cmd+Shift+Z step back and forward through your typing, the keys and the element menu, the caret going back to where the change was; a scene that a new heading split comes back whole. Changes made for you (fixes, Replace, the chat) are undone in History.
- Moving around: the arrow keys move from the last line of a scene to the next scene and back. Paste brings in the pasted lines with their elements.
- Find, flags, margin notes, the Breakdown's links and tagging by selection work in both editors: every line keeps its place in the script.
- The stored form is Fountain. A line carries Fountain's forcing mark only where its words alone would read as another element: a heading without INT. or EXT. starts with a period (
.FLASHBACK - THE LAKE), an action that would read as a heading, a transition or a camera line starts with!, a name that would not read as a speaker with@, a transition the pattern does not know with>. The marks are not shown on the page. Check script, the tags, the Breakdown and Lock read them: the same script with and without them gives the same findings and tags, and a fix keeps a line's mark and its bold. From 0.39.3 a line forced as action with!is action by your choice: Check script never offers it as a heading, a transition or a speaker, nor notes it as a line in capitals, and the import never changes it. A line in capitals in a Final Draft Action paragraph (THE BELL RINGS.) comes in forced, so it stays action. - Final Draft import keeps the elements. Each paragraph's type in the .fdx file becomes the line's element (with the forcing mark where needed) and its bold, italic and underline become Fountain emphasis.
Breakdown in 0.68.7: long scripts, and Split
- Suggest elements finishes on a long script. A 60-page script's suggestions no longer stop with The breakdown was cut off before it finished. The model has room to think and to answer in full. It is still free.
- Split is answered once. When Script check asks Is every "bread" the perfect loaf of bread? and you choose Split, the other breads get tags of their own and the question doesn't come back, also when the thing's other name is written with the (the bread). When the thing's own name is the bare word (Bread), Script check may then ask whether Bread and Fresh bread are the same element: Keep separate answers it.
Breakdown: suggestions from the model
- The Script check panel has two lists. Script check is code: instant, free, the same result every time. Breakdown is the model: it reads every scene and suggests what takes judgment. Nothing it suggests is applied until you accept it.
- What it suggests. Elements with a type (Prop, Wardrobe, Vehicle, Animal, Set dressing, Effect) for things the camera must recognize across scenes; element states (whole and cracked, clean and lit); wardrobe that leaves the body or is worn by more than one person; a character written as if new who is really the same person at another age (a look); aliases (a full name, a role, "the woman in the photograph"); people who act in the picture but were never written in capitals; a state the action adds to a place that the heading does not carry (rain, snow, a flashback); and a heading that contradicts its own action (DAY, but the stars are out).
- When it runs. Once on its own when you open Script check on a draft that has no suggestions yet, and whenever you press Suggest elements. It runs in the background; keep writing. The list opens when it is done, usually in under a minute.
- Free, on our model. The Breakdown runs on Tarkovsky's platform key with our strongest model (Claude Opus via OpenRouter), not on your credits or your key. Results are saved per draft: the same script never runs twice, and reopening the panel costs nothing. Each account has a daily allowance (ten runs by default); past it, the button says so and works again the next day.
- Add and Ignore. Each suggestion has Add and Ignore; the list has Add all and Ignore all. Add writes the same tag you would make by hand: an element tag in its first scene (the engine carries it to every scene that names it), a state or a look on the asset once it exists (before the lock, the hint is stored on the tag and carried over at lock), an alias on the character so later tagging matches that wording, a character tag for the person never written in capitals, a state hint on the location for that scene. A heading contradiction is information: Noted marks it read; the heading stays yours to change. Ignore remembers your answer for this project, so the same suggestion does not come back on the next run. Added suggestions are not shown again either.
- A word in capitals the code could not place (0.14). When the action has a lone word in capitals that is not an introduction, a sound, sign or card text, emphasis or film grammar (a VULTURE circling, a HOVERBOARD in the corner), the code lists it for the model and the suggestion reads "VULTURE: character or element? · scene 4", with the model's answer and reason. Only words the code listed can be suggested; BANG, FOR SALE and CUT TO are never offered.
- Mentioned, not present (0.14). The model sees, above every scene, who the code tagged there and how (on screen, O.S., V.O.). Where one of them is only mentioned in that scene (named on a card or a letter, in a photograph, spoken about), it suggests "Mentioned, not present: Anna in scene 10 — remove the tag?". A character who speaks in the scene, with any cue, is present; V.O. and O.S. count as presences; the model is told to stay silent unless the text makes it plain, and a suggestion for someone the code did not tag in that scene is dropped before you see it.
- Small things and changes to a body (0.15). The model now sweeps every scene for objects that come back, however small (a notebook, a lighter, a ledger, a jetty the characters stand on), and for lasting changes to a person or an animal (a cast, a dressing, clipped fur, a protective collar), before it decides anything. A recurring object the action handles or singles out is suggested as an element; a change to a body or an appearance is suggested as a look of that character, from the scene it happens in, so every later shot carries it. The sweep itself is kept with the result as the record of what was considered.
- What it will not do. It does not tag locations, times of day or speaking characters (the code has them), does not report spelling or formatting (Script check does), and is told to leave one-off props, background business, sounds and sign text alone. Two things that share a word are kept apart.
- Reading a suggestion. The chip names the kind, the scenes it rests on follow, the bar is the model's confidence, and the line under the headline is its reason, written for a filmmaker. Low confidence means "check this", not "wrong".
- Names the script ties to a person (0.18). A role or a description is offered as a character's alias when the action uses it in place of the name, when someone is called by it, or when the script itself ties it to the person: the introduction gives it, before or after the name ("Her daughter, LILY (8)", "ROY (50s), the night clerk"), the person is introduced in a costume or a uniform, or a figure first seen without a name is later named ("The hooded figure is Marcus"). The code offers these itself; the model is asked to sweep every other wording of every character before it suggests anything, and a wording it judges an alias in that sweep is suggested even when it forgot the card. Words anyone may be called (Sir, Honey, Dad), a role two people share and a role said once in passing stay quiet. Accepting an alias tags the person wherever the wording appears, so a figure described in an early scene gets the person's reference there. An alias rests only on scenes where the person is there, seen or speaking: a wording that only names someone heard from another room, the source of a sound, or someone spoken about who is not in the scene is not offered for that scene.
- Names that hold everywhere (0.19). A surname, a full name, a title with a surname ("Sergeant Lund") or a role the person's introduction or costume gives them ("the night porter", someone introduced "in a referee's cap") is an alias wherever the script uses it, in the action or in dialogue, even once, and even in a scene the person is not in. The card says so ("only named in scene 4: no presence there"): Add links the wording to the person, and a scene they are only spoken of in never puts them in the picture. "My mum", "your brother" and "our gran" are said relative to whoever speaks, so they are never offered, however often they are said; the narrator's "her uncle" in the action can be. A character we already know who arrives later described but unnamed ("a tall man with a muddy spaniel", after we have only heard him on a speaker) is offered as that description's alias for the scene. A place's state is a look the action states that changes the whole place or what can happen in it (hail, a flooded floor, smoke filling a yard): "the storm has passed" or "not a breath of wind" is not offered as a state, and neither is a detail on one surface, such as a frosted pane or a dusty shelf. A person's own name with an age ("young Wenna", "Wenna (8)") is offered as a look, never as an alias; a full name ("Wenna Kell") stays an alias.
- For agents:
POST /api/projects/:id/story/breakdownqueues the job (owner or editor; 429 past the daily cap, 503 when the platform key is absent),GETreturns{result},{pending}or{none}for the current script hash. The prompt is versioned atsrc/server/prompts/breakdown.md; the version is stored with every result.
Tags of characters and elements (0.26.2)
- No apostrophes in any tag. A character's and an element's tag drop their apostrophes as a place's does: D'ARCY is @CHAR_DARCY, never @CHAR_D_ARCY; Wenna's locket is @ELEM_WENNAS_LOCKET. In a prompt a tag is written in the case its name is typed (@CHAR_DArcy, @ELEM_Wennas_locket, a look's word in capitals), and a tag typed in any casing is sent that way.
- Older projects keep their tags as they are until their next Lock. At that Lock each tag that changes takes the new spelling and keeps the old one among the sheet's other names; the line directions, the cues, the cast of each shot, a take's performance, the floor plans and the shots' references follow. A prompt or a cue written with the old tag still finds the person or the thing, the voice chosen for a character stays with them, and no image changes.
- A name keeps its capital after an apostrophe (0.27.1, Zach's answer 19). A name written in capitals is named with the capital after its apostrophe kept: O'HARA is O'Hara and its tag is written @CHAR_OHara; D'ANGELO is D'Angelo, @CHAR_DAngelo. A possessive or a contraction stays small: Bridie's ledger is @ELEM_Bridies_ledger, KEEPER'S KITCHEN is Keeper's Kitchen, CAN'T is Can't. A name typed in mixed case is kept as typed. The tag itself, in capitals, is the same as before (CHAR_OHARA), so nothing that stores it changes, and a prompt that wrote the old form (@CHAR_Ohara) still finds the person in any casing and is sent in the new one.
- Older projects get the capital at their next Lock, once: a character's sheet still named as Tarkovsky Director named it before (O'hara) takes O'Hara, and the floor plans follow. The old written form is kept with the sheet, hidden. Name it back by hand and it stays as you named it. A place keeps the name it was recorded with; rename it in Assets.
Places and areas in the headings (0.26)
- Tags of places. A location's tag is its place and area in capitals, words joined by _: @LOC_FERRY_CABIN, @LOC_FERRY for the main area. Apostrophes are dropped: WENNA'S FLAT - HALL is @LOC_WENNAS_FLAT_HALL, shown as Wenna's Flat · Hall. A tag an older project wrote with a _S_ (LOC_SAM_S_HOUSE_KITCHEN) becomes the new one at the next Lock and stays one of the place's other names, so a prompt that wrote it still finds it.
- Is this part of …? A heading that doesn't write PLACE - AREA (INT. WENNA'S KITCHEN, in a film with INT. WENNA'S FLAT - HALL) gets a question in the Breakdown: Wenna's Kitchen: is this part of Wenna's Flat? Yes makes it an area of that place (the kitchen of Wenna's Flat, @LOC_WENNAS_FLAT_KITCHEN from the next Lock, the old tag kept); Ignore keeps it a place of its own. The script itself isn't changed. Free: the code asks it.
One thing, one name (0.18)
- Script check, the Breakdown and Lock compare every character, place and element with the others. Two names for one thing ask once: "Pickup and Pickup Truck: the same vehicle?" with Merge into… and Keep separate. Merge into keeps the other name as an alias of the one you keep, so later mentions are tagged as the same thing; the script's words are not changed. Keep separate sets the question aside for this project.
- The reverse: one word for two things. When an element is tagged by a bare word ("jacket") and the script also uses that word for something else ("a leather jacket", "another jacket", two people's own), the check asks "Is every “jacket” the work jacket?" with Split: the word stops tagging the element and the other thing gets a tag of its own.
- Before Lock. These questions are among the ones to answer before Lock: Lock says how many and takes you to the first.
- A vehicle you are inside and see from outside is asked about once: as one vehicle, the element takes the name of the place inside it (the pickup truck element and the PICKUP TRUCK heading), so its look agrees in both.
- Places. A place written short in one heading and in full in another ("INT. PICKUP" and "INT. PICKUP TRUCK") is offered as one place; merging it rewrites the short headings only. A room of a place (HOUSE - KITCHEN) is never merged into the place.
- People. A first name and the full name of one person who both speak (ANNA and ANNA DALE) are offered as one person, unless the script keeps them apart (each introduced, together in one sentence, talking to each other). A part (GUARD and HEAD GUARD) and a look (SAM and YOUNG SAM) are never asked about.
- One question per problem. What Script check already asks about (two of the project's own tags, two spellings of one place, a split) is not asked again in the Breakdown; the Breakdown offers the merges its own suggestions bring. Two things that only share a bare word ("the truck") are never merged, and a toy or a picture of a thing is never the thing.
- Naming. The Breakdown names an element by the fullest wording the script uses for it ("work jacket", not "jacket") and keeps the shorter wordings as its aliases; two of its suggestions for one thing become one, with the merge offered as an alias of the element.
- A heading's qualifier is not part of the place. In "INT. PICKUP TRUCK - MOVING - DAWN" the place is PICKUP TRUCK and the time DAWN. MOVING, DRIVING, ESTABLISHING, POV, MONTAGE and the like are, like CONTINUOUS, neither the place nor its time. A sheet made under the old reading keeps its images at the next Lock.
- A correct (CONT'D) is not a finding. "HOWARD (CONT'D)", with one space and in capitals, is a cue extension: the check leaves it alone and the character is Howard. Only a malformed one is fixed, and written correctly rather than removed: "THEO(CONT'D)", "RAY (cont'd)", "(CONTD)" or a non-breaking space become "THEO (CONT'D)". Tarkovsky never adds a (CONT'D) itself.
- Panels start under the bars (0.61, TAR-594). Suggest elements' Breakdown, Script coverage and Check script's side panel start where the bars pinned at the top end, on a film's page and a commercial's (whose Brief row is one of them), before the page scrolls and after, at any width. Opening a panel closes any menu open in the bar, so the bar never covers the panel. The Breakdown and Script coverage scroll the page as they open, so the bars reach their pinned place and the panel opens full height; on a phone nothing moves. A Brief pop-up open when a panel opens closes, and what you typed in it is kept.