Meelio Docs
Troubleshooting

macOS Permissions

Fix microphone and system audio recording permission issues on macOS.

If Meelio can't record audio, the most common cause is missing macOS permissions.

Check Permission Status

  1. Open System Settings (Apple menu → System Settings)
  2. Go to Privacy & Security
  3. Check both:
    • Microphone → Meelio should be toggled ON
    • System Audio Recording (or Screen Recording) → Meelio should be toggled ON

Granting Permissions

If Meelio Isn't Listed

If Meelio doesn't appear in the Microphone or System Audio Recording lists:

  1. Close Meelio completely (Cmd+Q)
  2. Reopen Meelio
  3. The permission prompt should appear — click Allow

If Meelio Is Listed but Toggled Off

  1. Toggle Meelio ON in the permission list
  2. macOS may ask you to restart Meelio — click Quit & Reopen if prompted
  3. Reopen Meelio after it closes

After Granting Permissions

Meelio v0.1.243 and later can now detect and use permissions immediately after they are granted. If recording still doesn't work after granting permissions:

  1. Quit Meelio completely (Cmd+Q)
  2. Wait a few seconds
  3. Reopen Meelio
  4. Try starting a consultation

If the issue persists, restart your Mac.

System Audio Recording Is for Audio Only

The System Audio Recording permission (labeled as Screen Recording on some versions of macOS) is used to capture your patient's voice during video calls. Meelio does not record your screen visually.

Permission Was Denied Previously

If you previously denied a permission and the system dialog doesn't appear again:

  1. Open System Settings → Privacy & Security
  2. Find the relevant permission (Microphone or System Audio Recording)
  3. Manually toggle Meelio ON
  4. Restart Meelio

Still Having Issues?

  • Share debug logs directly from the Help & Support chat panel (Paperclip icon)
  • Export debug logs from Settings → Account → Export Debug Logs and share them with support
  • Contact [email protected] with a description of the issue

On this page