Common Errors

License Errors

"License key invalid"

Cause: The license key format is incorrect or the key doesn't exist.

Fix:

• Ensure you copied the entire key including PS- prefix
• Check for extra spaces before or after the key
• Verify you're using the correct key (check your purchase email)

"Device limit reached"

Cause: All device slots for your license are in use.

Fix:

• Deactivate a device you no longer use
• Contact support to add device slots

"License expired" / "Needs revalidation"

Cause: ParrotScribe couldn't verify your license online.

Fix:

• Check your internet connection
• Try again in a few minutes
• If persistent, contact support

Application Errors

"Failed to start transcription"

Cause: Audio capture couldn't initialize.

Fix:

1. Check permissions are granted
2. Verify your microphone is connected and working
3. Restart ParrotScribe from the menu

1. If using system audio, restart your Mac

"Model failed to load"

Cause: The transcription model couldn't be loaded.

Fix:

1. Restart ParrotScribe
2. Check available disk space (need ~500MB free)
3. Try selecting a different model in Settings
4. Reinstall ParrotScribe if persistent

"Output directory not writable"

Cause: ParrotScribe can't save files to the configured location.

Fix:

1. Check the output directory exists
2. Verify you have write permissions
3. Try resetting to default location (~/Documents/ParrotScribe/)

Network Errors

"Network error during activation"

Cause: Couldn't reach the license server.

Fix:

1. Check your internet connection
2. Ensure ParrotScribe isn't blocked by a firewall
3. Try disabling VPN temporarily
4. Try again in a few minutes

"Connection timed out"

Cause: Server response took too long.

Fix:

• Try again in a few minutes
• Check if you're on a slow or unstable connection

Getting More Help

First, make sure you're running the latest version. Select Check for Updates... from the menu.

If you can't resolve an issue:

1. Note your version number from About ParrotScribe

1. Reproduce the problem
2. Collect logs by running this command in Terminal:

/usr/bin/log show --predicate "subsystem == 'com.parrotscribe.app'" --last 1h --info --debug > ~/Desktop/parrotscribe-logs.txt

1. Contact support with:
   • Description of the issue
   • Your version number
   • Steps to reproduce
   • The parrotscribe-logs.txt file from your Desktop