# Troubleshooting

Source: https://docs.novelos.studio/help/troubleshooting/ (updated 2026-11-09). Part of the NovelOS Studio 1.5.1 docs.

Find the message or the symptom, then follow the link for the full fix.

## Installing and opening

| Problem | Fix |
| --- | --- |
| macOS says NovelOS "is damaged" or "can't be opened" | Nothing is wrong with it. Follow [If macOS blocks the first launch](https://docs.novelos.studio/start-here/install.md#if-macos-blocks-the-first-launch). |
| Windows says "Windows protected your PC" | Click **More info**, then **Run anyway**. |
| The phone app says it's made for phones | You opened it on a computer. Use the desktop app there. |

## Trial and licence

| Message | Fix |
| --- | --- |
| **Validation Issue**, **License Not Found**, **Connection Lost** | See [If activation fails](https://docs.novelos.studio/start-here/trial-and-licence.md#if-activation-fails). |
| **Trial already used** | Each email and each computer gets one trial. Activate a licence to keep writing. |
| **Trial limit reached** | The trial has room for a set number of chapters, characters and so on. See [What the trial includes](https://docs.novelos.studio/start-here/trial-and-licence.md#what-the-trial-includes). |

## Updates

An update that won't install says why. The fixes are in [Updates](https://docs.novelos.studio/start-here/updates.md#if-an-update-doesnt-install). Most often on a Mac: move NovelOS into Applications.

## Sync

If sync stops, the cloud in the top bar gets a red dot and **Settings › Sync** says what it needs. Each message and its fix is in [When sync needs you](https://docs.novelos.studio/guides/sync.md#when-sync-needs-you). A forgotten passphrase needs the recovery key; nobody else can recover it.

## Muse (AI)

| Problem | Fix |
| --- | --- |
| AI buttons are greyed out or missing | Add a key in **Settings › Muse (AI) › Providers**. See [Connect a Muse key](https://docs.novelos.studio/guides/muse/connect.md). |
| A key won't save, or Muse stops with an error | See [When a key won't save](https://docs.novelos.studio/guides/muse/connect.md#when-a-key-wont-save) and [Errors while Muse is working](https://docs.novelos.studio/guides/muse/connect.md#errors-while-muse-is-working). |
| AI features say they're part of the full version | Muse isn't in the trial. |

## Read Aloud and dictation

| Problem | Fix |
| --- | --- |
| No player in Read mode | Turn on **Chapter narration** in Settings › Editor & Typography. On-device voices only read books whose language is English. See [Read Aloud](https://docs.novelos.studio/guides/write/read-aloud.md). |
| No **Dictate** button | Dictation is for English books, in Write mode. See [Dictation](https://docs.novelos.studio/guides/write/dictation.md). |
| **NovelOS is not allowed to use the microphone.** | Allow it in your system's privacy settings. |

## Importing and exporting

| Problem | Fix |
| --- | --- |
| Smart Import puts everything in one chapter | Give chapter titles a heading style in Word and import again. See [How chapters are found](https://docs.novelos.studio/guides/write/smart-import.md#how-chapters-are-found). |
| **No text layer was found.** | It's a scanned PDF. It needs character recognition before it can be imported. |
| Some export formats are greyed out | The trial exports PDF only. |
| An export to Dropbox, Drive or OneDrive fails | See [If an export fails](https://docs.novelos.studio/guides/publish/export.md#if-an-export-fails). |
| The PDF page count differs from Book Preview | Book Preview's page breaks are approximate; check the exported PDF. |

## AI tools (MCP)

If Claude Code or another tool can't reach NovelOS, check that **Settings › MCP** is on and the tool has the current token. A port that's already taken can be changed under **Permissions**. See [Connect an AI tool](https://docs.novelos.studio/guides/ai-tools/connect.md#when-it-wont-start).

## Still stuck?

[Contact support](https://docs.novelos.studio/help/contact.md) with your NovelOS version and the exact message.
