Troubleshooting

updated

Most problems come down to a missing permission, a model that isn’t downloaded, or not being signed in for the optional AI features. Start with the built-in check in Settings › Meetings › Diagnostics: click Run check and it tests your microphone, call audio and speech model in about five seconds.

Call audio is silent, or only my voice is transcribed

The other participants come through the sound your Mac plays, which needs:

  1. macOS 14.2 or later. Check in Apple menu › About This Mac. On older versions only your microphone is recorded.
  2. Screen & System Audio Recording permission. In Settings › Meetings › Permissions, the Meeting audio row should read Allowed. If it reads Needs setup, click Open System Settings and turn Oyma on.
  3. A full restart. After granting the permission, quit with ⌘Q and reopen. Until then the row reads Restart required.
  4. The setting itself. Transcribe other participants in Settings › Meetings must be on. It is by default.

Then click Run check while something is playing. Connected, no sound for meeting audio can just mean nothing was playing during the check. Full steps are in Recording permissions on macOS.

If your microphone shows In use by another app, close the other app and try again. If it shows Connected, no sound, check the input level in System Settings › Sound and that the microphone isn’t muted.

Words appear twice in the transcript

Your microphone is hearing the call through your speakers while call audio is also captured. Oyma doesn’t cancel echo, so wear headphones.

Transcription is slow or lags behind speech

  • First use of a model. Small and Large v3 Turbo take minutes to prepare the first time they load. Live text lags until that finishes, and Run check shows Still preparing. Base is ready in seconds.
  • Running without the GPU. If Run check shows Ready (CPU — slower), transcription is running on the processor and text lands a few seconds behind speech. This usually means the graphics version of the model couldn’t be downloaded. Make sure the model shows as downloaded under Model on this device, and if Local-only mode is on, download it from there once.
  • Model size. Larger models are more accurate but slower. Base is the fastest. See Transcription models and languages.

“Recording saved. Set up the speech model…”

Transcribing a file and re-transcribing a meeting use the Base model. In Settings › Meetings, select Base under Speech model, click Download, then run >Re-transcribe current meeting from the command palette. You can switch the live model back afterwards.

The summary doesn’t appear, or shows an error

Summaries and Ask run as Oyma AI on Oyma‘s own server, so they need an account and a paid plan. Check, in order:

  1. Are you signed in with a plan? Oyma AI needs an account and a paid plan, and a one-time trial exists. Without either, no request is made.
  2. Is Local-only mode on? It blocks all network access, so no summary request is made. See Local-only mode. Summarise after transcription in Settings › Meetings controls the automatic summary.
  3. Does the note say ai: false? Notes with that frontmatter are never summarised.
  4. Is the transcript empty? There’s nothing to summarise if no speech was recognized.

Errors you might see:

  • A sign-in or plan message: sign in, or check that your plan or trial is active.
  • A network message: Oyma can’t reach Oyma AI. Check your connection and the egress log for the failed call.

To retry, open Summary from the waveform button and click Try again or Generate summary, or run >Re-summarise current meeting (AI) from the command palette.

Oyma AI can’t be reached

  1. Are you online? Oyma AI runs on a server, so it needs a network connection.
  2. Is Local-only mode off? While it is on, every network call is blocked by design.
  3. Is the note free of ai: false? Those notes are never sent.
  4. What does the egress log say? In Settings › Privacy, the log shows the time, destination and capability of each call, which tells you whether a request left your Mac.

Meetings aren’t detected

Detection reads window titles, which needs the Screen & System Audio Recording permission. If you see Enable meeting detection, grant the permission and restart Oyma. The supported apps are listed in Record a meeting. You can always start capture by hand with ⌘⇧R.

Export diagnostics for support

  1. Open Settings › Privacy and scroll to Support. Or press ⌘O and run >Export diagnostics….
  2. Click Export diagnostics… and choose where to save the file.
  3. Send the Markdown file to hello@getoyma.com with a short description of what happened.

The file contains app and macOS versions, your settings with secrets left out, and the most recent app log, with file paths, email addresses and tokens scrubbed. It never includes note content. It’s a plain text file, so you can read it before sending.

Questions

Why is only my voice in the transcript?

Call audio isn't being captured. It needs macOS 14.2 or later and the Screen & System Audio Recording permission, followed by a full restart of Oyma.

Why doesn't anything happen when I ask for a summary?

Usually Oyma AI isn't available. Summaries run on Oyma's own server, so you need to be signed in with a paid plan or a trial, be online, and not be in Local-only mode.

Does the diagnostics file include my notes?

No. It contains app and macOS versions, your settings with secrets removed, and recent logs with paths, email addresses and tokens scrubbed. It never includes note content.

Your notes, in plain Markdown.

Free during the private beta. Apple silicon Macs, macOS 14 or later.

docs troubleshooting downloadDownload for Mac

No account needed. Intel Mac build