Guide

The guide.

How to do each thing in Musset, from the first sentence to the file a publisher or a printer expects. Tutorials to follow once, how-tos to come back to, and a reference for the rest.

Start here

Install Musset, open or bring in a book, and find your way around.

  1. 01Install Musset on your MacDownload Musset, drag it to Applications and open it. What it needs (macOS 14, Apple silicon), how it updates, how to remove it, and how to build it from source.How-to
  2. 02Your first book in Musset: from the title to chapter oneA ten-minute tutorial. Create a book, choose its form and language, write a first chapter with scenes, find your way around the window, and see the page as it will print.Tutorial
  3. 03Move a Scrivener project to Markdown, with MussetOpen a .scriv project in Musset and get a folder of plain Markdown files: parts, chapters and scenes from the binder, synopses, comments, footnotes and italics. What comes across, what does not, and how to check.How-to
  4. 04Turn a Word manuscript into chapters and scenesBring a .docx manuscript into Musset. It is cut into chapters at its headings, or at the habit your chapter titles follow, and into scenes at its * * * breaks. The original file is not changed.How-to
  5. 05Open a folder of Markdown files as a bookUse Musset on a manuscript you already keep as Markdown files, from iA Writer, Obsidian, Ulysses or a plain folder. Open the folder in place, or import a copy; your files are not rewritten.How-to

Write

The page, the keys under your hands, and the modes that leave only the text.

  1. 06Write, Revise, Read: the three modes of the pageMusset's page has three modes. Write changes the text, Revise turns every change into a correction, and Read shows the chapter or the whole book typeset as it will print.Guide
  2. 07Distraction-free writing on a Mac: Focus, typewriter and Kiosk modeFour ways to clear the screen in Musset: Focus mode dims all but the sentence you are writing, typewriter scrolling holds the line still, Kiosk mode locks the Mac to the manuscript, and repetitions show in pink.How-to
  3. 08Ultra Focus: write forward, without going backUltra Focus fills the screen with nothing but your text and refuses the keys that let you go back. Three levels, an optional lock until 500 words or 25 minutes, and where the words land.How-to
  4. 09Markdown for novelists: the little you needA novel needs very little Markdown: italics, a scene break, a footnote, a note to yourself. What Musset recognises, how it shows on the page, and the shortcut for each.Reference
  5. 10Smart quotes, dashes and non-breaking spaces, by languageMusset sets quotation marks, apostrophes, dashes, ellipses and non-breaking spaces by the rules of the book's language: English, French, German, Spanish, Italian or Portuguese. The rules, and how to turn them off.Reference
  6. 11Offline spelling and grammar checking in six languagesMusset checks spelling and grammar with LanguageTool running inside the app, on your Mac: nothing is sent anywhere. What the underlines mean, how to accept a fix, and the book's own dictionary.How-to
  7. 12Keyboard modes: Mac, WordStar, vi or EmacsMusset speaks four keyboards. Keep the Mac's own shortcuts, or write with WordStar's diamond, vi's modes or Emacs's chords, with motions that understand sentences and paragraphs.Guide
  8. 13WordStar keys on a MacWrite on a Mac with WordStar's control diamond, blocks that stay marked, and place markers. The complete list of WordStar commands in Musset, and what is not there.Reference
  9. 14vi keys for prose: sentences and paragraphs as text objectsMusset's vi mode has normal, insert and visual modes, with motions and text objects that understand sentences and paragraphs. The complete list of what is implemented, and what is not.Reference
  10. 15Emacs keys on a Mac, without losing your accentsMusset's Emacs mode has the mark, the region and a kill ring, with Meta on Option or Esc, so Option still types é, ü and ç. The complete list of bindings.Reference
  11. 16The command bar: everything in Musset, by namePress ⌘K and type. The command bar goes to any chapter or scene of any of your books, opens a character's sheet, runs any command, and searches the text.How-to
  12. 17Find and replace, and search across the whole bookFind in the chapter, replace, and search every chapter of the book, or of all your books, from the sidebar. Searches ignore capitals and accents.How-to
  13. 18Word count, characters and writing goalsCount a chapter or a book in words, characters, or characters with spaces, see what you wrote today, set a word goal for the book, and read the chapter's statistics.How-to

Structure

Chapters, scenes, the plot, the people and places of the book.

  1. 19Chapters, scenes and parts: give the book its shapeHow to organise a novel in Musset: add and reorder chapters, cut them into scenes, group them in parts, mark each one draft, done, edited or final, and set chapters aside without deleting them.How-to
  2. 20Scene cards: rearrange a chapter, and the book at a glanceLay a chapter out as cards, each holding its scene's whole text, and move, split or merge scenes by hand. Then step back to a part or to the whole book.How-to
  3. 21The plot grid: one row per scene, one column per threadOutline a novel scene by scene in Musset's plot grid. Columns for the synopsis, the characters, the motifs, the subplot and what you are hiding, filled by you or proposed by the AI from your text.How-to
  4. 22A story bible for your novel: characters, places and timelineKeep character sheets, places, a timeline, documents and research in the book's Bible, a visible folder in your book. Musset tracks who appears where, and keeps what you cut.How-to
  5. 23Rename a character throughout a novel, safelyChange a character's or a place's name in every chapter, note and sheet of the book at once. Musset shows each line before it changes, flags the doubtful ones, and one undo takes it all back.How-to
  6. 24Cork boards for plotting: pin characters, places and ideasPlan a novel on a board inside the book. Pin character sheets, places with their maps, notes, images and links, draw arrows between them, and watch the cards light up as you write.How-to
  7. 25Margin notes, to-dos and quick captureLeave a note on a passage, turn it into a question or a task, tick it off when it is dealt with, and capture an idea from anywhere on your Mac without leaving what you are doing.How-to
  8. 26Split view, tabs and a second screenPut two chapters side by side, keep a character sheet next to the page, park a board on a second screen, and save an arrangement of panes under a name.How-to

Revise

Versions, corrections, an editor's reading, and the editors who live in Word.

  1. 27Version history for a book: get back anything you wroteMusset keeps every state of every chapter as you write. How to find a sentence you deleted, put a paragraph back, compare a chapter with an earlier day, or take the whole manuscript back.How-to
  2. 28Milestones: mark a draft before you change itA milestone keeps the whole book as it stood on a day you chose: the end of a draft, a submission, a reading. How to set one, export the book as it was, and share it.How-to
  3. 29Two versions of a chapter, side by sideWrite the same chapter two ways in Musset, read both next to each other with what differs marked, and choose which one goes in the book. Nothing is erased.How-to
  4. 30Try a rewrite of the whole book without touching the manuscriptA track is a parallel draft of the whole book. Write the version without the father, or in the present tense; the manuscript does not move. Then bring back what works, paragraph by paragraph.How-to
  5. 31Track changes in Markdown: Revise mode and correctionsIn Musset's Revise mode every change becomes a correction to accept or reject later, stored as CriticMarkup in the plain text of the chapter. The buttons, the shortcuts and the syntax.How-to
  6. 32Work with an editor who uses WordSend your book as a Word file with Track Changes on, and bring the editor's tracked changes and comments back into Musset as corrections and notes, even if you kept writing meanwhile.How-to
  7. 33The editor inside: an AI that reads your book and never writes itMusset's AI reads a chapter like a demanding editor: it quotes your sentence, says what it sees and asks a question. It never writes prose for your book. How to set it up with your own Claude or ChatGPT account, and how to turn it off.Guide
  8. 34Get editorial feedback on a chapter, as notes in the marginAsk for a reading of your chapter: style and problems, tics, continuity, what to cut, the opening and the ending, facts to check. Each note quotes its passage; you tick it off, reply, or dismiss it.How-to
  9. 35Score a chapter against a rubric, with proof from the textA blind reading of your chapter, scored by criteria you weight for your genre. Every score rests on a passage quoted from your text, and Musset checks that each quotation is really there.How-to
  10. 36Check a chapter against your own style sheetWrite your rules once, numbered, as you would give them to an editor. Musset checks each chapter against them and flags every breach in the margin, citing the rule. It never changes the text.How-to

Share

The same book on every Mac, and in front of the readers you choose.

  1. 37Musset Sync: the same book on every MacMusset Sync keeps your books online with their whole history, on all your Macs, offline first. How to set it up, what the status bar says, and what happens when the same paragraph changes in two places.How-to
  2. 38Share a manuscript with beta readers and an editorInvite beta readers, an editor or an agent to read your book on their Mac, iPhone or iPad. They read the milestone you chose, never your desk, and their notes come back onto your text.How-to
  3. 39Read and annotate a book an author shared with youYou were invited to read a manuscript in Musset. How to open it on a Mac, iPhone or iPad, mark it up, suggest changes and talk with the author. Your account is free.Tutorial
  4. 40Write a book together: co-writers and who wrote whatTwo authors in one manuscript with Musset Sync. What a co-writer can do, how simultaneous changes are handled without conflicts, and how to see who wrote each word.How-to

Publish

The manuscript each country's publishers expect, and the printed book.

  1. 41Export a book to PDF, Word or EPUBMusset exports a submission manuscript, a PDF for readers, a PDF for the printer, a Word file and an EPUB, with no format to design. How to choose what goes in, and where the files land.How-to
  2. 42Manuscript format by country: US, UK, France, Germany, Italy, Spain, Portugal, BrazilPublishers in each country expect a different manuscript: double-spaced pages and a word count in English, feuillets in France, Normseiten in Germany, cartelle in Italy. The conventions, and how Musset sets each one.Guide
  3. 43Standard manuscript format for a novelWhat agents and publishers in the US and UK expect: 12-point type, double spacing, one-inch margins, a header with surname, title and page, and a word count rounded to the hundred. Musset sets it for you.Guide
  4. 44The Normseite: the German standard manuscript pageA Normseite is a page of 30 lines of 60 characters in a monospaced face, used by German-language publishers, agents and translators to measure a text. How it is defined, how to count, and how Musset makes one.Guide
  5. 45Feuillets and signes: how French publishers measure a manuscriptIn French publishing a text is measured in signes, characters with spaces, and in feuillets of 1,500 signes. How to count, what a French manuscript looks like, and how Musset makes one.Guide
  6. 46The cartella editoriale: the Italian manuscript pageItalian publishers measure a text in cartelle of 1,800 battute: 30 lines of 60 characters, spaces included. What a battuta is, how to count, and how Musset sets a manuscript in cartelle.Guide
  7. 47Typeset a book: a print-ready PDF in EB GaramondMusset typesets your book like a publisher: EB Garamond, justified and hyphenated by language, facing pages with inside margins, in the trim size of your market. For reading, or for a print-on-demand service.How-to

Reference

Every shortcut, the files on disk, and what leaves your Mac.

  1. 48Musset keyboard shortcuts: the complete listEvery keyboard shortcut in Musset for the Mac, by menu: writing modes, formatting, corrections, panels, panes, search and export, plus the commands that live only in the command bar.Reference
  2. 49The book folder: what Musset writes on diskA Musset book is a folder of Markdown files with a git history. What each file is, what Musset touches and what it leaves alone, and how to read the book without Musset.Reference
  3. 50What leaves your Mac, and whenMusset keeps your book on your Mac. A plain list of every case in which text or data is sent somewhere: the AI you set up, Musset Sync, lookups you ask for, and the daily update check.Reference
  4. 51Troubleshooting and common questionsAnswers to what people ask most about Musset: recovering text, moving a book, Intel Macs, iPad and Windows, syncing, the AI reader, exports, and where to get help.Reference

Write the book. Finish it.

Free during the beta · $9.90 once from version 1.0 · macOS 14 or later, Apple silicon · Open source

Download Musset — free