Chapter 25
Troubleshooting
When something does not work the way you expect, it is almost always one of a few reasons. This chapter walks you through the most common: a command is greyed out, a project cannot be edited, Goethe does not answer, a device does not connect, an import or export causes trouble, and you want to get a saved version back. At the end it says where to find help.
Each section starts with what you see, then names the causes in the order in which they are most frequent, and tells you what to do.
A command is greyed out
What you see
A command in the ribbon or the menu bar is grey and cannot be clicked. Or: a command you know from the manual is missing altogether.
This is not a fault. Goethe Write shows or enables a command only when it can do something. There are four reasons, and each has its own way out.
Reason 1: the command needs a text with a cursor
Most commands of the ribbon (font, paragraph, insert, references) act on a text. If the cursor is in no text, they are grey. The hint card that appears when the pointer rests briefly on a grey command tells you: "Bold works on a text: put the insertion point in a text."
- Click a text in the sidebar (not a folder, a tool or the page of a phase).
- Click into the text so that the cursor blinks.
- The command is no longer grey.
The same holds for the Format palette: above a page without text it says "Format works on a text. Open a text on the left." And in the menu bar a grey entry shows the reason as help text when you point at it briefly.
Commands that need only the window (View, Export, Settings, Page Setup) are free even without a text.
Reason 2: the page has no ribbon
On the pages of the phases Idea, Research, Beats and Output and in the Screenplay, there is no ribbon. These pages bring their own controls; a command of the ribbon would have nothing to do there. The menu bar is still there, but its text commands are grey. Switch to the phase Manuscript (or open a text in the sidebar) to use them. In Focus (⇧⌘↩) there is no ribbon either; Esc takes you back.
Reason 3: the command has a reason of its own
Some commands are grey even though a text is there, because their precondition is missing. The reason stands in the help text:
- Remove Highlight: "The selection has no highlight." First select a passage that carries a highlight.
- Watermark commands: the help text says what is missing, for example that the watermark has no recipients or that none is set.
If the pointer rests briefly (about 0.6 seconds) on a command, a small hint card appears with the name, the shortcut, a sentence and, when the command is off, the reason.
Tip: If a command gives nothing back after the click, a calm sentence stands under the ribbon such as "No changes in the project." That means: the command ran but had nothing to do.
Reason 4: the command is not shown in this project
Some commands appear only if the project uses the matching tools. Then they are missing altogether, not grey:
| Commands | Appear only if … |
|---|---|
| Add Evidence, Check Paragraph | Law, Academic or Consulting is switched on |
| Cite, Cross-Reference, Bibliography | Law or Academic is switched on |
| Clause, Approve | Law or Consulting is switched on |
| Legal Numbering, Mark, Exhibit, Margin Numbers | Law is switched on |
| the revision rounds | Fiction is switched on |
| Field (Insert) | the project has values |
To switch tools on:
- Choose Project ▸ Tools…. The sheet lists the groups Fiction, Legal, Academic, Consulting and the individual tools.
- Switch on the group or the tool.
- Done.
Or change the Type of Work (Project ▸ Type of Work); it switches on the group that belongs to it and switches off that of the old one (see Chapter 1).
The same holds for the Go menu: the phases appear under the names of your Type of Work, and the Screenplay phase is missing in a project without a screenplay. The tools appear only if the sidebar shows them. The Review is always there. The commands in the Entry menu act on the entries you have chosen in the sidebar; choose something there first.
Example: An author looks for "Cite" and does not find it. Her project is a novel. Under Project ▸ Tools… she switches on the group Academic, and the command appears.
When a command is grey in the menu but not in the ribbon
The menu and the ribbon carry the same commands under the same name. If one is grey in both, the same cause applies. With Help ▸ Search Commands… (⌃⌘K) you find it and see its place.
The project cannot be edited
What you see
You type, and nothing appears. Or a bar says "Open for Reading", or the line under the middle names someone else as the writer.
Reason 1: guest in a shared project
If you opened the project through File ▸ Open Project from Network…, you are a guest. You write only in the text you currently hold, and only if the host has given you May Write. The outline and the knowledge are changed by the host.
- Read the line under the middle. It names the reason: "Guest of Anna: reading. Anna can allow writing." or "Nami is writing here. You are reading along."
- If you ask for the right to write, the host sets May Write for your device in the Collaborators window.
- If you only want to make a suggestion, choose Suggest Change… or Comment in the context menu.
More in Chapter 17, "Opening from the network (guest)".
Reason 2: a text is being lent right now
On the host's Mac a text is read-only while a guest writes in it: "Nami (iPhone) is writing here. Meanwhile the text can only be read on this Mac." A change through Goethe, Replace All or a snapshot is taken back ("Nami is writing in this text right now. You can accept or reject changes in it once it is free again."). In a screenplay it is a single paragraph that is lent ("… is writing in this paragraph.").
- Wait until the text is free. It is free when the person stops or the connection ends.
- If a device goes away without signing off (a folded iPad), Goethe Write frees the text after about half a minute. Faster: Collaborators ▸ the person's menu ▸ Disconnect.
- If a device has taken a text along, it stands under Taken Along. Restore gives it back.
Reason 3: open for reading (the lock without a purchase)
In the App Store version a calm bar stands above the page: "Open for Reading" with the sentence "Reading, searching, printing and exporting always work. To write and create your own projects you need Goethe Write for Mac." and the button Buy Goethe Write…. This is not a fault: nothing is lost, an existing project stays readable, searchable, printable and exportable, and the bar goes away with the purchase.
- Choose Goethe Write ▸ Purchase and Subscription… (or the button in the bar).
- You have two ways: the one-time purchase Goethe Write for Mac (no subscription, for all Macs of your Apple Account) or the subscription Goethe Cloud (it includes writing on the Mac). The App Store shows prices.
- If you have already bought (on another Mac, after a reinstall), press Restore Purchases.
- You manage your subscription through Manage Subscription (Apple Account): cancel or change the payment method.
One note: on iPhone and iPad writing is free; there only the Goethe Cloud functions rest.
Whoever is invited to a project writes according to their role, without a subscription of their own: "Whoever invites pays."
Note: in development and test builds of Goethe Write the lock does not exist. It applies only in the App Store version.
Reason 4: a backup or an old version is open
A whole backup opens as a separate, locked project; likewise an older version that you view through File ▸ Revert To ▸ Browse All Versions… is not your working project. If you want to keep working in it, make a copy: File ▸ Duplicate Project (⇧⌘S). A file in the folder "Goethe Link" is the copy of a guest project and is never saved (see Chapter 17).
What is not behind it
The lock Hide from Goethe (Entry menu) keeps only Goethe out of an entry; you can keep writing. Focus locks nothing. If Undo is missing, there is often another reason: changes by other people do not belong in your history.
Goethe does not answer
What you see
You ask Goethe for something and nothing comes, or a sentence appears that begins with "Goethe is turned off …", "The provider rejected the key …" or "No connection to the provider …".
The order of checking
Go through this list from top to bottom. Usually one point is enough.
- Is Goethe part of your purchase? In the App Store version Goethe belongs to the Goethe Cloud subscription. Without it, the settings show the row "Goethe, the writing assistant, is part of Goethe Cloud." with the way to the purchase. Even then Goethe works with your own key at the provider of your choice; everything about Goethe is in Chapter 16, the purchase is explained in Chapter 18.
- Is Goethe switched on? Open Goethe Write ▸ Settings… (⌘,) and choose the Goethe pane. Switch on Use Goethe. If the switch is grey, it says "First set up a provider below."
- Is a provider chosen and set up? Under Provider stand Anthropic Claude, OpenAI, Google Gemini, Mistral, OpenRouter and Custom Server. A tick shows the provider Goethe works with. A click on a row only shows its settings; Use This Provider switches over.
- Is a key saved? Paste your provider's key into the field API Key and press Save. Afterwards only "•••• 4F2a" stands there (the last four characters). Replace… exchanges it, Remove… deletes it from this Mac's keychain (it remains valid at the provider; you can revoke it there). A link "Create a key at …" leads to the provider's page.
- Check the key. Press Check. The state shows "Checking…", then "Rejected" (the provider refused the key) or "Failed", with a message below, or the number of models your account can use.
- Choose a model. Before checking it says "Available after checking". Afterwards you choose one under Model; with many models the Recommended ones come first. Thoroughness (not with a custom server) decides how thoroughly Goethe works.
- Did you give permission? Before the first request to a provider, Goethe asks: "Goethe Sends Text to Anthropic" with Allow and Don't Allow. If you refused, it says "Goethe sends no text without your permission." You can give permission again in the settings under Goethe, or take it back with Withdraw Permission. A server on this Mac needs no permission, because nothing leaves the Mac. If you switch Send Project Details back on, Goethe asks once more.
- Is the entry hidden from Goethe? A text or folder hidden with Entry ▸ Hide from Goethe is not read by Goethe ("Hidden from Goethe: Goethe doesn't read this entry or anything inside it"). Lift the lock if Goethe should see it.
The messages and what they mean
| Message | Meaning | What to do |
|---|---|---|
| Goethe is turned off or not set up yet … | no provider with a key | Settings ▸ Goethe: turn on, choose a provider, enter the key |
| Goethe sends no text without your permission. | you refused | ask again and allow |
| The provider rejected the key. | 401 or 403 | check, recreate or replace the key |
| Too many requests in a short time. Try again shortly. | provider is throttling | wait briefly |
| There is no credit left at the provider. | no credit | top up your account at the provider |
| The model “…” is not (or no longer) available at … | model withdrawn | choose another model |
| No connection to the provider (no internet connection) | network gone | check the connection |
| The text is too long for one request. | too much text | choose a shorter passage |
| Goethe reached the maximum length before the response was complete. | answer cut off | choose a shorter passage or ask again |
| The model declined the task … | the model refuses | word the request differently |
| The provider reports an error (…) | error at the provider | try again later |
| The response couldn't be read (…) | unreadable answer | ask again |
A provider can also be blocked by region: then it says that it does not offer the interface in your region.
A custom server
For Ollama, LM Studio, vLLM and any server with an OpenAI-compatible interface, choose Custom Server:
- Enter the address under Address or choose under Known Servers Ollama (localhost:11434), LM Studio (localhost:1234) or vLLM (localhost:8000).
- The address must end in /v1. Otherwise it says "No OpenAI-compatible interface answers at this address. Does the address end in /v1?"
- Press Check. If it says "The server is running but has no model yet", load a model with Ollama in Terminal, for example
ollama pull llama3.2. - Without https it works only with servers on this Mac or on the local network. For a server on the local network macOS asks once for access to the local network.
If the server runs on this Mac, no text leaves the Mac.
Connecting with other devices
What you see
A device does not find your Mac, the digits do not appear, a guest is connected but cannot write, or the connection breaks off.
The order of checking
- Are both devices on the same network? On the same Wi-Fi or network. For the connection over the Internet, the last point of this section applies.
- Is the project saved and sharing switched on? On the host: ⌘S, then Collaborators ▸ Share on the same network. If saving is missing, it says "Save the project first (File ▸ Save). What is shared is the saved state of the project." Without the Goethe Cloud subscription the switch is replaced by a lock row.
- Has macOS allowed access to the local network? Otherwise no device finds the Mac: System Settings ▸ Privacy & Security ▸ Local Network, allow Goethe Write there. On iPhone and iPad iOS asks the same way the first time.
- Is pairing open? New devices can begin only while Pair Device… is pressed (two minutes). If the time runs out, press it again. The window Open Project from Network on the guest says it: "On the other Mac: open the project, then “Collaborators”, “Share in This Network” and “Pair Device…”."
- Choose the right name. Your Mac appears on the network as "Goethe-7F3A"; the name changes with every start. If the list stands empty ("Searching…"), wait briefly or switch sharing off and on again.
- Do the six digits match? Only then press They match. If they do not match, press Reject and begin again; someone might be standing in between.
- Is pairing locked? After three unconfirmed comparisons it is locked for ten minutes (longer afterwards). The button Pair Device… is grey, and below it says "Several comparisons did not match. Pairing works again from …". Wait until then. Every begun comparison counts, also an abandoned one; so confirm only when you both have the digits in front of you.
- Does the host know the project for this device? A known device that opens a new project waits: on the host Wants to Open This Project appears; choose Allow to Read or To Write. On the guest it says "Waiting for … to allow this project for this Mac."
- Does the guest only read? A new device reads first. Under Linked now switch on May Write for the device.
- The connection broke. The guest is then open for reading only and reconnects by itself, but only with the same host. You can press Reconnect. If nothing helps, choose on the host the device's menu ▸ Unpair and pair again.
- Is a file too large? There are limits: a text up to 8 MiB, a file of the project up to 46 MiB, the mirror of a guest project up to 2 GiB. Larger texts or files do not arrive.
- Over the Internet: an invitation link works once and for seven days; opening it a second time or an expired link does not work. Have a new one sent. If it says "The internet service is not reachable right now.", it is not your doing: the service of the Goethe Cloud is not yet set up or not reachable. On the same network everything works without it.
Coming soon: The relay of the Goethe Cloud for connections over the Internet is not yet in operation (see Chapter 17, "Coming soon: Internet relay").
If your guest text does not get through, it is also not lost: it lies in your device's outbox and arrives again, or it stands as "not delivered", with Copy.
Import and export problems
Import: a text or file does not arrive
Which files become texts? Goethe Write turns these file types into texts when you bring them into the manuscript, the characters or the places: txt, text, md, markdown, rtf, docx, odt, html, htm. All other files (PDF, pictures and so on) go unchanged into Research and can be viewed there.
- Choose File ▸ Import ▸ Texts (Word, RTF, Markdown)… for texts, File ▸ Add Files to Research… for material. Or drag files from the Finder into the sidebar: onto a folder of the manuscript, texts become texts; onto Research they become files.
- A Word file brings its footnotes along. If it has a watermark and the project has none yet, it becomes the project's.
- A Markdown file brings headings, quotes, bold and italic along as styles.
Importing a whole work: File ▸ Import ▸ Import Work… reads a work and recognizes chapters, people and places on your Mac, without AI. You see the results under View ▸ Detected…. HTML with forms or embedded content is not supported; if it says "The work could not be read.", the file is damaged or of a kind that cannot be read.
Importing a Scrivener project: File ▸ Import ▸ Scrivener Project…. The messages tell you what is going on:
| Message | What to do |
|---|---|
| The Scrivener project wasn't found. | Choose the folder again. |
| This isn't a Scrivener project. … extension “.scriv.” | Choose the folder with the extension .scriv. |
| … packed as a ZIP archive, for example as a backup. | Unzip it in the Finder, then import. |
| This project comes from Scrivener 1. | Open and save it in Scrivener 3, then import. |
| Part of the project isn't downloaded to this Mac yet (iCloud Drive …). | Wait until all files are downloaded. |
| The file “…” of the Scrivener project can't be read. | Probably damaged; open it from a backup. |
Structure, texts, notes, labels and status come along, plus custom details, keywords, collections, snapshots and targets. Scrivener annotations and comments go into the text's notes, so nothing is lost.
Importing a screenplay: see Chapter 9. A PDF must contain readable text ("This PDF contains no readable text." if it holds only pictures). An FDX file that is not valid XML or contains a document type declaration is refused by Goethe Write with line and column.
Export: the result looks different
Choose File ▸ Export… (⌥⇧⌘E; more in Chapter 14). The sheet has a section Before Exporting:
- If it says All Set, there is nothing to heed.
- Items marked in orange would appear wrong in the export (a missing value "‹Name›", a "Broken Cross-Reference", a placeholder still to be filled in, a heading that appears twice). A click jumps to the place.
- Items in grey do not prevent the export (an empty text, changes awaiting acceptance, open comments, unchecked evidence, open questions). Note: comments do not go into PDF and EPUB; tracked changes appear in PDF and e-book as if all were accepted.
- If you want to include comments and tracked changes in a Word file, switch on Include Comments and Changes.
Page numbers do not match:
- The Status Bar shows "about Page 3 of 12" when the page number is estimated, for example because the view is set differently from the export. The export's number is the reliable one.
- Pages are counted across all texts of the manuscript as in the PDF export; the title page and lists do not count.
- Paper and margins come from Layout ▸ Page Setup…. Change them there, and page view, PDF, Word and print follow.
- An e-book has no fixed pages (the notice: "No Page Preview"); likewise Markdown, RTF and Word have no fixed pages in the file, the program that opens them lays them out.
- In a screenplay the pages come from Final Draft's rule; in individual cases a page may break differently. Compare a binding number with Final Draft (see Chapter 9).
The PDF lacks the screenplay's headers and footers: custom headers and footers and a different starting page number are not carried over to the screenplay PDF yet; Goethe Write says so in the window "Export with Changes?".
Tip: Have you finished setting up a format of your own (file type, look, page, what is included)? Save it under a name; it is then available among the formats.
Getting a saved version back
Goethe Write has several nets under your work (the details are in Chapter 15). Find the level that fits your case, from the finest to the coarsest.
1. Just deleted or changed: Undo
As long as the project window is open, Edit ▸ Undo (⌘Z) takes back step by step, also the deletion of an entry. Redo (⇧⌘Z) restores it.
2. An entry was deleted: "Recently Deleted"
What you delete in the sidebar lies in Recently Deleted until you delete it for good.
- Open Recently Deleted in the sidebar.
- Choose the entry.
- Choose Restore.
3. A text has changed: Snapshots
If you saved a snapshot of a text with Entry ▸ Save Snapshot, you bring it back like this:
- Choose the text and in the Inspector (on the right) open the tab for the saved versions (in English the tab is named Versions; in the phase Revision it stands first; View ▸ Show Inspector, ⌥⌘I, if it is off).
- Choose the snapshot. With Compare you see the difference to the current text.
- Press Restore. The current text is saved as a snapshot first ("The current text is saved as a snapshot first"): this step loses nothing either.
- For an alternative the button reads Use This One: the alternative becomes the text.
- With a right-click you can rename or delete a snapshot.
You also create a snapshot with Save Snapshot in the tab itself; a right-click on it offers Save as Alternative. The tab also shows what Goethe applied, without the wording.
Further, in the Info tab the section Revision holds the pages Deleted Passages and Earlier Versions.
4. The project in an earlier state: macOS versions
macOS saves your project continuously. Choose File ▸ Revert To:
- Last Saved: the project to the state of the last save.
- Browse All Versions…: a window shows earlier states of the project to page through and restore.
5. Backups: the net underneath
Goethe Write always makes backups: when you close the project and every 30 minutes while you work, each a ZIP file with the whole project. How many are kept you set under Settings… ▸ Backups ("Keep the Last 10", between 3 and 50). If you wish, every copy also goes to a Second Location, such as an external disk; if it was not reachable, the next backup makes up what is missing. When you begin sharing, a copy is made quietly beforehand.
Making a copy now: File ▸ Backups ▸ Back Up Now.
Getting a copy back:
- Choose File ▸ Backups ▸ Browse…. The window lists the backups of this project, newest first; first those on this Mac, then those in the second location. If there are none yet, it says "No Backups Yet".
- Choose a backup on the left ("Choose a Backup"). If it is unreadable, it says "Can't Be Read".
- You have two ways:
- Open as Project: the whole backup opens as a separate, locked project. If you want to keep working in it, make a copy with File ▸ Duplicate Project (⇧⌘S).
- Fetch single texts: the list shows every text of the backup, with Different from Now (n) or All (n). Beside each it says whether it is "same as now", "then 1,204 words, now 980" or "no longer in the project". Show opens it; Restore places a copy "… (from backup of 07.11.2026, 14:30)" next to the text. The current text stays as it is. In the manuscript the copy counts toward the export only once you include it.
- Back Up Now in the same window makes a new copy at once; Show in Finder opens the folder.
Example: You replaced three chapters with a wrong version by mistake and noticed only two days later. You open Backups ▸ Browse…, choose the backup from the day before yesterday, see "Different from Now" at the three chapters, press Restore, and have the old chapters as copies next to the new ones.
Getting help
In the app
- Help ▸ Goethe Write Help (⌘?): the page "Finding Your Way Around" with the three areas, the ribbon, headings, Goethe, arranging, tools and searching, exporting and saving.
- Help ▸ Search Commands… (⌃⌘K): type a few letters; the list shows every command of the ribbon and the menu bar with its place. With ↑ and ↓ you choose, ↩ runs it. A rough name is enough: the search also knows older names of commands and related words.
- Help ▸ Keyboard Shortcuts: every shortcut by topic (Writing, Entry, Cards, Find, Window, Project).
- Help ▸ Sample: Novel and Sample: Brief: two finished projects to try out. Changing them does no harm.
- Hints at the pointer: rest on a command, a button, a phase; after a moment a sentence appears, also on why it is off.
- Help ▸ Report a Problem…: opens a prepared message to hello@lexxington.com in your mail program (see "The developers" below).
- Goethe Write ▸ About Goethe Write: version and build, for when you describe your problem.
- This manual explains every command in its chapters.
Purchases and subscriptions
Purchase, subscription, restoring: Goethe Write ▸ Purchase and Subscription…. Cancelling or changing the payment method happens at the Apple Account: Manage Subscription. Questions about charges are answered by Apple.
The developers
Goethe Write is software by ICSL FZE, Sharjah, developed by Nami Shams and Team. The address for questions and bug reports is hello@lexxington.com.
Reporting a problem
- Choose Help ▸ Report a Problem…. Your mail program opens a message to hello@lexxington.com with the subject "Goethe Write: Problem report".
- The text holds three questions: "What happened?", "What did you expect?" and "How it happens (steps):". Answer them under each question.
- At the very bottom stands a line with the version of Goethe Write (with the build), the system of your Mac (macOS) and the language of the interface. It helps us reproduce your problem.
- Read the message and send it. Goethe Write sends nothing by itself.
The message never contains text from your project and no file. If you want to show something from your project, write it in or attach it yourself; that is your decision.
If Goethe Write finds no mail program, it shows a notice and puts the address on the clipboard. Then write to hello@lexxington.com by hand. Name what you did, what you expected instead and the version from About Goethe Write.