Filmsquare HelpDocs

3.0 The departments3.2 Writing a script

Writing a script

How the script editor works, how drafts and versions differ, and what the story bible, statistics and table read show.

Updated 4 min read.md

On this page
  1. The page
  2. Drafts and versions
  3. Writing help from your own Claude
  4. Accepting a suggestion
  5. The story bible
  6. Statistics
  7. Table read
  8. Starting a microdrama
  9. Reading the script as a guest

The editor opens from Script → Script with Write (a director or higher, or a maker on Writing). It is the same text as the script you import: Fountain, kept as a new version when you save.

The page #

From 900 px wide, you type on a formatted screenplay page: each element in its column, page breaks as you type. Below 900 px, for instance on a phone, the editor is plain text.

  • Tab and Return move through the elements: Scene heading, Action, Character, Parenthetical, Dialogue, Transition and Centered.
  • Ctrl 1 to Ctrl 7 (Cmd on a Mac) or Alt 1 to Alt 7 make the line one of those seven, in that order.
  • Names on a Character line and scene headings complete themselves from the script. Return or Tab takes the suggestion.
  • Ctrl F finds, with Replace and Replace all.
  • The element menu in the header ends with Replace character…: pick a character and a new name, and every cue and mention changes in your draft, as one undo step.

Drafts and versions #

A draft is yours and changes; a version never does.

You doWhat happens
Pause, or Ctrl SThe draft is kept. The header says Draft kept.
CloseThe draft is kept. Write now reads Continue draft, with Draft from v3.
Discard draftThe draft is dropped, after you confirm.
Save as v4 (Ctrl Shift S)A new version, with your note. The draft is dropped.

If a newer version came in while you wrote, the header says so, and saving asks first: Keep writing, or save on top of it as the next version. While you type, others on the production see {name} is writing next to the script.

Writing help from your own Claude #

Your own Claude can rewrite or continue a scene, brainstorm, or read the script and report. The prompts (rewrite_scene, continue_scene, brainstorm_script, read_report) are on Prompts and working method. A rewrite arrives as a note with a suggestion, in the notes next to the script.

Select words on the script and choose Ask Claude: you get a prompt to paste into your own Claude, ready for that passage.

Accepting a suggestion #

Whoever may write the script sees Accept on a note with a suggestion.

  • On the script, Accept puts the suggestion in your draft: the draft that waits behind Continue draft, or a new one from the version on screen. The editor stays closed, so the next suggestion is one click too.
  • In the editor, Notes · 3 in the header opens the same notes beside the page. Accept there puts the suggestion on the page, with the cursor after it, as one undo step. Choosing a note's quoted words shows them on the page. Esc closes the notes.
  • The card then reads In your draft, and Undo takes the suggestion out again. Once you change those words yourself, Undo is gone and the suggestion stays in your draft.
  • Text changed means the words in your draft are no longer the ones the suggestion was made for.

Accepting changes only your draft. The note resolves when you save the draft as a version (Save as v4) with the suggestion in it. Discard the draft and the note stays open.

The story bible #

Under Script → Docs, after the script, the Story bible group has six kinds of sheet: Logline, Synopsis, Characters, World, Outline and Style. A kind with no sheet yet is one row; choosing it makes the sheet from a template. Characters and World have a row for each character and each place of the production's cast and locations. Outline first asks for a structure: Three acts, Hero's journey, Story circle, Eight sequences or Hook and cliffhanger. Every sheet can be edited with Edit.

Statistics #

Statistics in the script's header shows the pages, the scenes, the estimated runtime (one page is about one minute) and the share of dialogue. Two tables below break it down per character (speeches, lines, scenes, share) and per location (scenes, length).

Table read #

Next to a scene, Table read plays the lines that are already spoken, in the voices of the cast. A scene with lines not spoken yet shows Speak scene with the draft price in credits and euros; it links to the shot where it is made and spends nothing until you do.

Starting a microdrama #

On an empty script in a microdrama production, Script → Docs offers Blank page and Microdrama episode where other productions show Write it here. The second opens the editor on a starter, as a draft: a title page and the beats Hook, Turn and Cliffhanger, with the cursor on the first scene heading.

Reading the script as a guest #

Share… in the version menu (reviewer and up) makes a link to the script alone. It always shows the newest version, also after you save a new one. Share on the board, with the Writing step in view, makes a link to the whole step: the script and its scenes. Guests sign in with their own account, select a passage and choose Note this. Share links come with a paid plan. Their notes show on the script like your crew's. See Notes, pins and review.

This page as Markdown: /docs/departments/writing-a-script.md