Skip to content
ScriptoriumDocumentation
English
Download

Your First Project

Everything in Scriptorium happens inside a project: one project per book, series, or piece of work.

  1. On the welcome screen, pick  Manuscript project.
  2. Pick  Create. You can also  Import documents or an archive, or an Obsidian vault.
  3. Choose what the project starts as:
    • For beginners: a starter kit with characters, places and events, a three-act structure and a drafting board.
    • Gamebook: a starter kit for a book the reader moves through by choosing. Sections branch, and a link mindmap follows them.
    • Watergate investigation or Sherlock vs. Moriarty: two finished example projects to explore.
    • Empty: a blank project.
  4. Give it a name and pick the editor language. You can rename it at any time.

Nothing a starter kit sets is permanent. Rename, delete or add anything once the project is open.

To work on a different project later, use  Switch project in the title bar. It lists everything on your shelf, and can start a new one.

A wiki project has no manuscript. It holds entities, notes, relationships, maps, timelines and mindmaps. Use one for a story bible, a world or a campaign setting.

Pick  Wiki project on the welcome screen. Outlines, link mindmaps and writing goals follow a manuscript, so a wiki project has none of them. A project keeps its kind for good. Nothing converts a manuscript project into a wiki, or back.

A project window has three main areas:

  • Sidebar (left): the tree of everything in your project. Create, rename, reorder, and nest items here.
  • Editor (center): whatever you have open: a manuscript, a note, a character sheet, a timeline.
  • Panel (right): details, goals, statistics and history for the page you are on.  opens it.

See Getting Around for a full tour.

WordWhat it means
ManuscriptThe book itself. Its parts, chapters and scenes.
EntityA page for one story element: a character, a place, an event, an object.
TemplateThe kind of entity, like “Character”, and the fields every one of them has.
WikiEverything that is not the book: entities, notes, tables, boards.
CodexThe project’s tools: the Library, the Project Database, Files and Tags.
PlotA visual board: an outline, a mindmap, a timeline or a map.
Mod⌘ Cmd on macOS, Ctrl on Windows and Linux.

The sidebar holds different kinds of items:

TypeWhat it’s for
FolderGrouping and organizing anything else
ManuscriptYour actual prose: chapters, scenes, articles
EntityA story element: character, location, event, item
NoteFree-form notes with cross-references to anything else
TableA spreadsheet-style view of your entities (also viewable as Kanban cards)
 OutlineYour story’s structure, beat by beat
 MindmapA visual canvas for connecting ideas
 Link MindmapEvery page link in your manuscript, drawn as a map
 TimelineEvents and entities on a zoomable time axis
 MapA custom map image with interactive pins and zones

Outlines, mindmaps, link mindmaps, timelines and maps are made from  Add Plot in the sidebar. Entities, notes and tables are made from  in the Wiki section.

You can nest manuscripts up to four levels deep, for example Manuscript → Act → Chapter → Scene.

Each project decides how deep its manuscript goes and what each level is called. A novelist might use Act / Chapter / Scene, while an academic might prefer Part / Section. Change these in  Settings ›  Manuscript.

  • Drag and drop items to reorder or move them into folders.
  • Right-click an item, or use its  menu, to rename, export, or delete.

Open  Settings in the sidebar. The project’s own settings are:

  •  Manuscript: hierarchy depth and level names
  •  Entities: your entity templates (character, location, event)
  •  Relationships: relationship types between items
  •  Calendars: the calendar system your story uses, including custom fantasy calendars

The same window holds the app’s settings, including  Plugins for the optional on-device AI tools.