Skip to main content

i can’t start recording / no transcript appears

  • check microphone permission in system settings → privacy & security → microphone
  • on macos, if using system audio, also check system audio recording permission
  • in byok mode, confirm your deepgram and openai keys are set in settings → api keys
  • in managed mode, check for an error message on the home / recording screen (service availability or connection issue)

macos system audio is missing

  • make sure capture system audio is enabled in settings
  • confirm macos system audio permission is granted
  • try stopping and starting the session after granting permission

bluetooth headphones / audio devices changed and audio looks wrong

  • the app auto-recovers after route / profile changes (for example airpods switching call modes)
  • allow up to ~20 seconds for automatic system-audio recovery after a device switch
  • if audio still looks stuck after that window, stop / resume the session or start a fresh session (⌘N)
  • for deeper diagnosis, open the debug log

managed mode says limit reached / recording is blocked

  • free tier has a 500-minute monthly cap; pro has 5,000 minutes
  • upgrade to pro, switch to byok for unlimited usage, or wait for the monthly reset

attio issues

  • “send to attio” is missing - enable it in settings → integrations
  • can’t search - connect your attio account first, then enter at least 2 characters
  • attio backend endpoints are not deployed yet - your backend deployment does not include attio routes yet
  • 0 tasks created - the meeting may not contain usable action items, or attio may accept the note but not create tasks from the parsed items

webhooks aren’t arriving

  • confirm the webhook url is correct in settings
  • check your receiver accepts POST with application/json and responds within 10 seconds with a 2xx
  • remember: no retries. if your endpoint is down, the delivery is lost.
  • check the debug log - webhook success / failure is logged under app

still stuck?

email ian@miniti.app.