Your First Project
Everything in Scriptorium happens inside a project: one project per book, series, or piece of work.
Create a project
Section titled “Create a project”- On the welcome screen, pick Manuscript project.
- Pick Create. You can also Import documents or an archive, or an Obsidian vault.
- 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.
- 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.
Wiki projects
Section titled “Wiki projects”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.
The workspace at a glance
Section titled “The workspace at a glance”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.
Words you will meet
Section titled “Words you will meet”| Word | What it means |
|---|---|
| Manuscript | The book itself. Its parts, chapters and scenes. |
| Entity | A page for one story element: a character, a place, an event, an object. |
| Template | The kind of entity, like “Character”, and the fields every one of them has. |
| Wiki | Everything that is not the book: entities, notes, tables, boards. |
| Codex | The project’s tools: the Library, the Project Database, Files and Tags. |
| Plot | A visual board: an outline, a mindmap, a timeline or a map. |
| Mod | ⌘ Cmd on macOS, Ctrl on Windows and Linux. |
What can live in a project
Section titled “What can live in a project”The sidebar holds different kinds of items:
| Type | What it’s for |
|---|---|
| Folder | Grouping and organizing anything else |
| Manuscript | Your actual prose: chapters, scenes, articles |
| Entity | A story element: character, location, event, item |
| Note | Free-form notes with cross-references to anything else |
| Table | A spreadsheet-style view of your entities (also viewable as Kanban cards) |
| Outline | Your story’s structure, beat by beat |
| Mindmap | A visual canvas for connecting ideas |
| Link Mindmap | Every page link in your manuscript, drawn as a map |
| Timeline | Events and entities on a zoomable time axis |
| Map | A 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.
Manuscript levels
Section titled “Manuscript levels”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.
Organizing the sidebar
Section titled “Organizing the sidebar”- Drag and drop items to reorder or move them into folders.
- Right-click an item, or use its menu, to rename, export, or delete.
Project settings
Section titled “Project settings”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.
Next steps
Section titled “Next steps”- Start writing in the manuscript editor
- Set up characters and locations
- Understand where your data lives