Audio Issues
Troubleshoot audio capture problems
No Audio Being Captured
Check permissions
First, verify permissions are correctly configured.
Check capture settings
- Open Parrot Scribe Settings > Sources.
- Ensure Transcribe Microphone is enabled.
- Parrot Scribe uses the default input device selected in System Settings > Sound > Input.

Check input volume
Your microphone might be too quiet:
- Open System Settings → Sound → Input
- Speak and watch the input level meter
- Adjust the input volume if needed
Poor Transcription Quality
Speak clearly
- Enunciate words clearly
- Maintain consistent volume
- Don't speak too fast
Reduce background noise
- Close windows and doors
- Turn off fans or noisy appliances
- Use a directional microphone
Use a better microphone
Built-in Mac microphones work but external microphones provide better quality:
- USB microphones (Blue Yeti, Audio-Technica)
- Headset microphones
- Lavalier microphones
Check the model setting
In Settings → Models, try a larger, more accurate model if your Mac can handle it.
System Audio Not Working
It is normal for a session to contain no system audio when nothing is playing. Microphone-only recording is also expected when Transcribe System Audio is turned off in Settings > Sources.
If system audio is expected but unavailable during a recording, Parrot Scribe shows:
System audio is unavailable. Recording continues with the microphone.
To restore system audio:
- Open Parrot Scribe Settings > Sources and enable Transcribe System Audio.
- Open System Settings > Privacy & Security > System Audio Recording Only.
- Enable Parrot Scribe.
- Reopen Parrot Scribe.
- Start a new session, play system audio, and confirm that the warning does not appear and the expected audio is included.
For more permission help, see Permissions.
Incomplete sessions
The Library may label a session Incomplete, while session details and the viewer show System audio incomplete. This means system audio you expected may be missing or partial.
Audio Cutting Out
Check CPU usage
Heavy CPU load can cause audio dropouts:
- Close unnecessary applications
- Check Activity Monitor for high CPU usage
Try a smaller model
In Settings → Models, try switching to a smaller Whisper model to reduce processing load.

Check for thermal throttling
If your Mac is hot, it may be throttling:
- Ensure ventilation isn't blocked
- Consider using a cooling pad
- Check Activity Monitor for thermal warnings
Testing Audio
To verify audio is being captured:
- Start a transcription session.
- Speak or play audio.
- Stop the session and open Library.
- Confirm that the expected speech appears in the saved transcript.

