Docs
How Asterysm works
A few things worth knowing first, a guide to every part of the app, and the shortcuts worth learning. The rest the app tells you as you go: an empty page says what goes on it.
At a glance
Two modes, one book
Writing is the manuscript, a scene at a time. Planning is the same book seen whole, in four rooms: its scenes, plotlines, characters, and world. ⌘1Ctrl+1 writes; ⌘2Ctrl+2 to ⌘5Ctrl+5 go straight to a room.
Type @ to link a name
Type @ and a name to link a character or a place, right in the prose. Point at the name to see who it is, and Context, beside the page, keeps everyone in the scene at hand.
Type / on an empty line
It offers what can go there: a picture, a scene break, a subheading, an extract, a centered line. Pause on an empty line, and a + in the margin offers the same.
Select words for more
A bubble offers Bold, Italic, Footnote, Synonyms, and Link. ⇧F7Shift+F7 opens the thesaurus on the word at the caret, offline, in the form the sentence needs.
Search goes anywhere
⌘KCtrl+K finds any scene, chapter, character, or place by its name, and any command by the name the menus give it.
Nothing is lost
Asterysm saves as you write. What you remove goes to the Archive, with Undo, and every scene keeps its history: ⌘SCtrl+S keeps a version now.
Guides
Every part of the app, a page at a time
Writing
- Writing a sceneThe page you write on, what it marks, and the ways to keep your eyes on the words.
- Mentions and ContextLink a name in the prose to a character or a place, and keep the scene's plan beside the page as you write.
- The thesaurus and spellingOther words for the ones you chose, already in the form your sentence needs, and a spell checker that knows your characters. Both offline.
Planning
- Planning your scenesThe whole book on one page, each chapter's scenes as cards, and a plan for every scene that is the same scene you write.
- PlotlinesEvery thread of the story across every scene, on one board, and each thread's arc on a page of its own.
- Characters and the worldA page for everyone and everything in the story, with facts to check at a glance and as much about them as you need.
Your book
Your work, kept
- History and versionsEvery scene keeps its earlier drafts on its own, and the whole book can be kept under a name at a milestone.
- Saving, the Archive, and backupsEverything is saved as you write, nothing you remove is lost by accident, and a copy of the book is kept outside it.
- Projects and seriesStart a novel, explore the sample, and keep a whole series in one project that shares its characters and its world.
Getting around
Shortcuts
Keyboard shortcuts
The ones worth learning first. In the app, Help › Keyboard Shortcuts ( ⌘ + /Ctrl + / ) lists every one.
Go
- Writing
- ⌘1Ctrl+1
- Scenes
- ⌘2Ctrl+2
- Plotlines
- ⌘3Ctrl+3
- Characters
- ⌘4Ctrl+4
- World
- ⌘5Ctrl+5
- Search…
- ⌘KCtrl+K
- Back
- ⌥⌘←Alt+←
- Forward
- ⌥⌘→Alt+→
- Previous Scene
- ⌘[Ctrl+[
- Next Scene
- ⌘]Ctrl+]
Format
- Bold
- ⌘BCtrl+B
- Italic
- ⌘ICtrl+I
- Footnote
- ⌥⌘FCtrl+Alt+F
- Extract
- ⇧⌘BCtrl+Shift+B
- Subheading
- ⌥⌘2Ctrl+Alt+2
- Centered
- ⇧⌘ECtrl+Shift+E
- Scene Break
- ⇧⌘↩Ctrl+Shift+Enter
- Synonyms…
- ⇧F7Shift+F7
- Link to Character or Entry…
- ⇧⌘KCtrl+Shift+K
In the Text
- Mention a Character or Entry
- @@
- Insert
- //
- Line BreakIn an extract, a letter, or a poem
- ⇧↩Shift+Enter
View
- Show or Hide Sidebar
- ⌃⌘SCtrl+Shift+L
- Show or Hide Context
- ⌘\Ctrl+\
- Focus Mode
- ⌘.Ctrl+.
- Typewriter Scrolling
- ⇧⌘TCtrl+Shift+T
- Read Book
- ⇧⌘RCtrl+Shift+R
File
- New SceneOr what the room holds: a character, an entry, a plotline
- ⌘NCtrl+N
- New ChapterOr a group of characters, or a category of the world
- ⇧⌘NCtrl+Shift+N
- SaveKeeps a version of the scene
- ⌘SCtrl+S
- Save As…
- ⇧⌘SCtrl+Shift+S
- Settings
- ⌘,Ctrl+,
Edit
- Undo
- ⌘ZCtrl+Z
- Redo
- ⇧⌘ZCtrl+Y
- Move to Archive
- ⌘⌫Delete
- Find…
- ⌘FCtrl+F
- Find Next
- ⌘GCtrl+G
- Find Previous
- ⇧⌘GCtrl+Shift+G
- Use Selection for Find
- ⌘ECtrl+E
- Find in Book…
- ⇧⌘FCtrl+Shift+F
In Lists
- Previous or Next Row
- ↑↑↓↓
- Collapse or Expand
- ←←→→
- Open
- ↩Enter
- Rename
- F2F2
- Move Up or Down
- ⌥↑Alt+↑⌥↓Alt+↓
- Up a Level
- EscEsc
Help
- Keyboard Shortcuts
- ⌘/Ctrl+/
Can’t find something?
Write to us. Every question helps make these pages, and the app, clearer.
support@asterysm.com