Skip to content
EpicDraft Docs

Library

The Library holds your project's pages: a page per character or location, the outline, story-bible pages, notes, reference documents, scripts and their scenes, and manuscripts. Pages are rich text and live in the .sp file itself, so they travel with the script. In earlier versions this was called the Wiki.

The Library in Writer · Plan, with the Story, Characters and Locations folders and a character page open

This page describes the Library with Settings → Labs → Writer and Director views on, which is the default. The Director's side of the Library, storyboards and media, is covered in Storyboards and Media & 3D Assets.

The top of the Library

  • Plan | Create chooses what the Library lists. In the Writer view, Plan holds the story: Story, Characters, Locations, Notes, and reference documents in Documents. Create holds the writing: Scripts with their scenes, manuscripts in Documents, and Reports. See The Workspace.
  • The search field, Find a page (or Find a scene or page in Create), filters the list as you type. Escape clears it.
  • The Project graph button opens the graph under the page. See The project graph.
  • The ⋯ menu (More Library actions):
    • Generate opens the Generate wizard. See Generating Media.
    • New lists the pages this stage can hold (in Writer · Plan: Character, Location and Note; in Writer · Create: Script and Manuscript), then New folder and Import….
    • Collapse all folders, and Expand all folders when any are closed.
    • Recently deleted, with a count. See Deleting and Recently deleted.

Close Library folds the column away; the Open Library tab on the left edge brings it back.

At the foot of the Library, a card lists the Plan and Create shortcuts and Export, incl. breakdown sheets. In Writer · Plan two closed sections sit above it:

  • Memory — what the AI assistant was asked to remember about the project.
  • References — for the selected page, who links to or mentions this subject. Name-only matches carry a mention tag.

The page tree

The Story folder starts with two rows that aren't pages:

  • Title page — the script's title page, edited in place. It's also the Title page tab at the top of the script.
  • Planner — the project's name, the title page fields, the logline and synopsis, and Privacy and encryption: who can open the file. See Security.

Then come the story pages, Style & Tone, Theme, World Setting and Treatment, and the Outline. You can add your own folders and subfolders; a folder's page shows a live index of everything inside it.

Open a row's menu with its … button, a right-click, or a long press. What it offers depends on the row:

  • Rename, Duplicate, Wrap in folder (puts the page in a new folder of its own), Move to… and Archive are on most rows. Archive doesn't ask: it moves the page or folder into Archived, with Unarchive. Rows that can't be archived (scenes, scripts) keep Delete, which moves them to Recently deleted, with Undo.
  • Character rows add Role.
  • Note rows add Type — see Notes and the breakdown.
  • Script rows add Main script, Move earlier and Move later, and Paste scene when a scene is on the clipboard — see Scripts and scenes.
  • Scene rows (under a script) have their own menu for moving, copying, duplicating and deleting the scene.
  • Folder rows get New subfolder, Rename, and Delete folder (which asks first, and moves the pages inside up a level instead of deleting them).

The Title page and the story pages have no menu.

While the project has two or fewer pages, a getting-started tips card sits in the list. It disappears on its own as the project grows.

With the keyboard, the tree works like any file tree: see Keyboard navigation.

Creating pages

New in the ⋯ menu makes a page of the kinds the stage holds. A new page goes straight into its section, not into a folder of its own; use Wrap in folder when you want one.

Pages can also come straight from the script: the affordance beside a character cue or scene heading offers Open page, or Create page when none exists yet. While writing any page, type [[ to link to another page by name, creating it on the spot if it doesn't exist. The link button's picker does the same with Create page for the selected text. See Formatting.

Archiving

Archive puts a page or folder in the Archived folder at the bottom of the Library, at the same path it had: a character in Characters › Villains goes to Archived › Characters › Villains. Nothing asks first, because nothing is lost.

  • Archived things are out of the way everywhere else: they don't show up in references or search, and the AI assistant never uses them as context.
  • Unarchive puts it back where it was. If that folder is gone, it goes to the top of the Library.
  • Inside Archived, Delete asks first, then moves the item to Recently deleted.

Deleting and Recently deleted

Delete on a page or a scene doesn't ask. The item moves to Recently deleted for 30 days, and a message offers Undo. Nothing is removed for good until the 30 days are up or you choose Delete now.

  • A deleted page keeps its text, its folder and its place. A deleted scene leaves its script, and keeps its text, its synopsis, its scene page, and its shots and blocking, so they all come back with it.
  • Open Recently deleted from the Library's ⋯ menu, which shows how many things are in it. On a phone it is in the Library's … menu too.
  • Each row says where the item was, when it was deleted and how many days are left. The list is the same for everyone in the project.
  • Restore puts a page back in its folder and a scene back in its script, in the same place. If that place is gone, it goes to the top of the Library.
  • Delete now removes it for good. It asks first, and it can't be undone. After 30 days they are removed for good.
  • A reference document's original file is kept until it is removed for good.
  • On a read-only project you can't delete.

Deleting a whole project works much the same way. See Using Files.

Writing a page

Breadcrumbs at the top of a page show where you are — Script › Folder › Page — and each crumb drops down a list of its siblings.

Type / for the block menu: Text, Heading 1–3, Bulleted list, Numbered list, To-do, Table, Storyboard panel, Media, and Link. Type [[ to link between pages.

The page toolbar includes an image button that opens the add-media dialog, and it obeys View → Toggle Tool Bar: with the toolbar off, marks and the link button move to the floating toolbar. The floating toolbar (⌘L / Ctrl+L) works on pages just as it does in the screenplay, and inside a table it grows row and column controls. See Formatting.

On shared files you'll see your collaborators' cursors on pages, the same as in the screenplay.

To print a page, print while it's on screen: File → Print… follows what you're looking at and renders the page (headings, lists, tables, and images, including in table cells) under the page's own name. See Printing.

Find and replace work on pages too. See Find & Replace.

Scripts and scenes

A project can hold several scripts. The Scripts folder, in Writer · Create, lists them all, and the screenplay you opened the project with is one of them. Each script row opens to show its scenes, in script order, each labelled with its scene number (#3), and a count of its issues. With Settings → Labs → Section headers on, the scenes sit under the script's section headers, grouped the way the script is.

Scene pages

Every scene heading can have a scene page: a Library page for that one scene. Click a scene row to open it (the page is made the first time you open it). You can also choose Open scene page from the scene heading's menu in the script, and Open in script on the scene row jumps the other way.

A scene page shows the scene's number and heading, its synopsis (the = line under the heading — edit it here and it changes in the script), the characters who speak in it, the location, and the scene's shots. New shot adds a storyboard shot for the scene. The page also carries the scene's Blocking row (3D Blocking) and its Breakdown. If the heading is deleted from the script, the page stays and says the scene is no longer in the script; your notes are kept.

A scene keeps its page and blocking when it moves, because they follow the scene's id. A storyboard is timed against one script, so when a scene moves to a different script, the shots that start in it move too. A storyboard holding only that scene's shots is re-bound to the new script; shots that shared a storyboard with other scenes move into a new storyboard named after the scene's heading.

Main scripts and the sequence bar

Any number of scripts can be marked Main script from the script row's … menu — for episodes of a series or the films of a sequel. The main scripts form a sequence, in the order you set with Move earlier and Move later; the badge on a main script's row reads "Main script 2 of 3". A project always has at least one main script, so the last one can't be unmarked.

The first main script is what the project opens to and what the pinned Screenplay tab opens. The AI reads every main script in order, and File → Export… can export them together (All main scripts, each starting on a new page).

When the open script is one of several main scripts, a slim sequence bar sits above the editor with previous and next buttons that name the neighbouring scripts, and a "2 of 3" count in the middle. It doesn't appear for a project with one main script.

Moving and copying scenes

Open a scene row's … menu:

  • Move up and Move down step the scene past its neighbour.
  • Move to script and Copy to script send the scene (or a copy) to the end of another script.
  • Duplicate puts a copy right after the scene.
  • Cut and Copy put the scene on the scene clipboard. Then Paste before on another scene row puts it in front of that scene, and Paste scene on a script row puts it at the end of that script.
  • Delete moves the scene to Recently deleted.

With a scene row focused, ⌘/Ctrl+C, ⌘/Ctrl+X and ⌘/Ctrl+V copy, cut and paste it. You can also drag a scene row onto another scene (it lands before or after it, depending on which half you drop on), onto a script row (the end of that script), or onto a section header row (the end of that section). Hold Option/Alt while dropping to copy instead of move.

Each move shows a toast with Undo. A scene's synopsis and breakdown tags travel with it. Copies are copies: a scene copied to another script no longer follows the original.

If a section heading is in the way of Move up or Move down, drag the scene instead.

Keyboard navigation

On the desktop Library, click a row (or Tab into the tree) and use:

KeyDoes
↑ ↓Previous or next visible row
Home / EndFirst or last row
→Open a closed folder or script; on an open one, step into its first child
←Close an open one; otherwise step out to the parent
Enter / SpaceOpen the row's page
F2Rename
Shift+F10 or the menu keyOpen the row's … menu
a letterJump to the next row whose name starts with it

The phone Library has bigger touch rows and bottom sheets instead; it does not use tree keys.

Character pages

A character page's header carries a role picker (protagonist, antagonist, supporting, or background), pronouns, and an age — freeform, so "34", "30s", or "Ageless" all work. New character pages start from a seeded template.

On protagonist and antagonist pages, a sheet of six key-character questions sits below the page body: identity, want and need, obstacle, cost, stakes, and meaning. Each question has its own AI button, and your answers survive if you later demote the character's role.

A References panel on the page lists the character's per-scene appearances plus every page that links to or mentions them — click any entry to navigate there.

Locations and story-bible pages

Location pages get the same References panel — per-scene appearances and links or mentions, click to jump.

The Story folder's pages, Style & Tone, Theme, World Setting and Treatment, edit the same fields that travel with your .sp file, so what you write here is what exports. The logline and synopsis are on the Planner.

Character, location, and story-bible pages all carry a Lookbook: a strip of reference images added from your device, by URL, or generated, and its Add document button adds reference documents.

Location 3D sets

A location page has a 3D set row. Build a 3D set opens the 3D editor on the location itself, where you lay out the floor, walls, set pieces and props once; Open 3D set returns to it. If a scene's blocking already has a set you like, Take the set from a scene copies that scene's set pieces and props up to the location.

In a scene set at that location, the scene page's blocking row then offers a Use the set from… button (it ends with the location's name). It puts copies of the location's set pieces and props into the scene's 3D blocking, behind whatever the scene already has. The scene stays self-contained — its characters, cameras and own props are never touched, and its exports see an ordinary scene. If you change the location's set later, an Update the set from… button appears on the scene; it replaces only the copied pieces. If you had moved or edited those pieces in the scene, it asks Replace your changes to the set? first. See 3D Blocking.

Notes and the breakdown

A note can carry a type, so it stands for something a production needs. Choose Type on a note row's … menu, or pick one when you create the note from a scene's breakdown. The types are: Production note, Cast, Extras – atmosphere, Extras – silent bits, Stunts, Props, Wardrobe, Makeup & hair, Sets, Set dressing, Vehicles, Animals, Special effects, Visual effects, Special equipment, Sound effects and Music. Plain note takes the type off again. A typed note gets its own icon and, for most types, a colour.

On a scene page, Breakdown lists everything the scene involves, sorted into those departments:

  • every character who speaks in the scene (Cast) and the location from the heading come without any tagging;
  • a typed note is part of the scene when the scene's text tags it — a note you attached in the script, or a [[link]] to it. Add to breakdown does the tagging from the page: search for a note, or type a new name, choose its type and Create and add. The × on a chip removes a tag.

Because the tags live in the script, a scene's breakdown travels with it when the scene is moved or copied.

To make breakdown sheets, use File → Export… → Breakdown sheets: one page per scene, with its number and heading, then what it needs, department by department. The hint Report: Export… → Breakdown sheets on a scene's Breakdown row opens Export… with that scene chosen. See Import & Export.

To have the AI read every scene and suggest what each needs, see AI Breakdown & Synopses.

Outlines

A blank Outline page opens with a template gallery: three-act (basic), three-act hero's journey, four-act (basic and advanced), five-act Freytag, Kubrickian non-submersible units, or blank. You can pick Choose a different template afterwards to start over.

Storyboards

Storyboards are the Director's: they're listed in Director · Plan, with folders for boards, subfolders and shots. From the script, the affordance beside a scene heading offers New shot for this scene, and once shots exist, Open shot for each. See Storyboards.

Documents

The Documents folder holds the writing your project is built from and alongside: reference documents you bring in, and manuscripts you write.

Reference documents

A reference document is source material: an earlier draft, the book you're adapting, a treatment, research. There are three ways to add one:

  • Import… (in the ⋯ menu or the File menu), then A document. See Import & Export.
  • Add document in the Lookbook of a character, location or story page. It offers From this device, From a link, and, on pages that list their documents, From the Library.
  • On a phone, Reference document… in the Library's New sheet.

From this device takes PDF, Word (.docx), text and Markdown files, several at once. From a link takes a link to a PDF, a Word file, a web page or a Google Doc. For a PDF you also choose Read the text (scripts, novels, research; the AI reads it) or Keep the pages (comics, magazines, picture books, shown as they look to mark up).

The text is read out of the file into a page in Documents, named after the file. That text travels with the project, so it's there on your other devices and for collaborators. The original file stays on your devices, the same way media does. EpicDraft doesn't host it.

A PDF kept as pages shows each page as it looks. Write notes on the page, Mark up a page with a drawing, or pick text on it to Highlight, add a Note, or Add reference to another page.

The top of a reference page shows the file it came from, with its page and word count, and:

  • Save the original — save a copy of the file you added;
  • Open the link — for a document added from a link, open it;
  • Copy into a manuscript — start a manuscript from this text (see below). The reference stays as it was.

A few things to know:

  • A link must be open to anyone who has it. A Google Doc must be shared as "Anyone with the link". EpicDraft reads a copy when you add it; later edits at the link don't come across. Add the link again to bring in a newer version.
  • Scanned PDFs have no text to read. Add one with Keep the pages, or, to read a scanned screenplay, import it as a script; the importer reads pages with text recognition. See Using PDF Files.
  • Files up to 100 MB can be added.

How the AI uses them

The AI knows which reference documents the project has, with a short opening excerpt of each, and reads them when a request calls for it — "write the opening scene from chapter 3 of the novel", "what does the old draft say about Mara's brother?". Long documents are read a part at a time. The AI treats references as read-only: it won't change their text, and puts its own work in a note or a manuscript instead. See AI Chat.

Manuscripts

A Manuscript is a page for prose — a novel, a novella, a short story, a long-form treatment — written in the same editor as every other page, with chapters as headings. A new one starts with Chapter One. Create one with New → Manuscript in Writer · Create, or with Copy into a manuscript on a reference document to rework existing text. The AI can read manuscripts like any page, and can write into them when you ask.

Media

Media is project-wide: every image, video and sound added anywhere in the project, plus 3D models and the rest of the 3D assets. With the Writer and Director views on, it's listed in the Director's Browser, not the Writer's Library. EpicDraft doesn't host your media; it stays on your devices. See Media & 3D Assets.

The project graph (Pro)

The Project graph button beside the Library's search field opens the graph under the page, as a split you can resize. Your screenplay is at the center with everything fanning out around it, node size weighted by importance. Click a node to open it; drag nodes to arrange them. Controls cover a Scenes toggle, a Mentions toggle, kind filter chips, zoom in and out, and fit to view. Solid edges are links you made; dashed edges come from a name match or folder membership. The close button, or the Library button again, closes it. The status bar's Charts and graphs popover has the graph too.

The graph is a Pro feature; free users see it locked. See Accounts.

Duplicating a project

File → Duplicate Project copies the whole project. See Projects.

On phones and tablets

On a phone, open the Library from the drawer. It has Plan | Create, the search field and the ⋯ menu at the top, bigger touch rows, always-visible … targets, and bottom sheets in place of nested menus. The Title page, Planner and Reports rows aren't in the phone Library; use Title and Reports in the drawer. For quick notes on the go, see Notes.