Troubleshooting
Whatever needs you shows as a warning in the menu and on the Overview, with the button that fixes it. A background sync also sends a notification. Start with Diagnostics when something is unclear: it checks everything the app depends on.
The Plaud session expired
The session lasts 7 days and is renewed by syncing, so it only expires when the app has not run for about a week. Press Log in in the menu.
Transcription
| Notification | Meaning | What to do |
|---|---|---|
| ElevenLabs balance is low | The estimate dropped below the level set in Settings | Top up, or wait for the monthly reset |
| Transcription stopped: the balance is used up | The provider refused an upload for lack of credit. Transcription is paused; the audio is still synced | Top up, then press Retry. Otherwise every sync checks the balance and resumes on its own |
| The provider rejected the API key | The key was revoked or lacks a permission. Transcription is paused | Create a new key and press Change… |
| Transcription failed for N recordings | The provider rejected the audio, or a temporary error persisted for the maximum number of attempts (15 minutes, 1 hour, 4 hours apart) | Press Retry |
| The speech model is not downloaded | Local is chosen and its files are not complete; recordings wait | Download… opens Settings |
| The speech model could not be loaded | The files are damaged, or Core ML failed to prepare the model | In Settings, Remove and Download again |
A recording over 25 MB fails with OpenAI and OpenRouter. Choose ElevenLabs or Local for it and press Retry.
Cleanup and summaries
| Warning | Meaning | What to do |
|---|---|---|
| No API key for the selected model | A chosen model’s provider has no key | Add key… opens its row in Settings; store the key, or choose another model |
| The provider rejected the API key | Steps using that provider are paused | Change… and store a new key |
| Cleanup stopped: the balance is used up | Steps using that provider are paused | Top up, then press Retry |
| The local model server is not running | Local is chosen and its server did not answer; its steps wait | Start the server; Open Settings to check its address |
| Cleanup or summary failed for N recordings | A request was rejected (a model that no longer exists, say), or an error persisted for 3 attempts | Press Retry |
A paused provider stops only the steps that use it.
What Retry does
Retry, in a notification, in the menu or on the Overview, clears the failure records and a balance pause, then runs one pass. Later does nothing.
Recording on this Mac
A refused permission shows as a warning with Open System Settings. A refused microphone keeps Start recording from starting. Without Screen Recording, audio-only recordings still work. See Recording on this Mac.
Recovery
- An audio file is missing or damaged. Delete the file or its whole folder in Finder; the next sync downloads it again. Full check in Diagnostics finds damaged files by checksum.
- Some recordings failed to download. They are retried at the next sync.
- A transcript is missing or wrong. Delete
transcript.mdand the next sync transcribes the recording again, or use Transcribe again…. - A recording was deleted by mistake. Put its folder back from the Trash (Put Back in Finder); the next sync keeps it as before.
- The app was quit or crashed. Nothing syncs until it is started again. It starts at the next login if “Start at login” is on. A recording that was being made is stored at the next launch.
Reading the log
Copy log command in Diagnostics copies a Terminal command that shows the app’s log. The log names recording IDs and error codes, which is what to include when you report a problem.