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.md and 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.