Troubleshooting

Common Issues

Text Not Appearing

If FloWords says it’s transcribing but no text appears:

1. Check Accessibility Permissions:
   • Go to System Settings → Privacy & Security → Accessibility.
   • Toggle FloWords OFF and then ON again.
2. Check Cursor Focus:
   • Ensure your cursor is active in a text field.

Microphone Not Working

1. Check Permissions:
   • Go to System Settings → Privacy & Security → Microphone.
   • Ensure FloWords is enabled.
2. Check Input Device:
   • In FloWords Settings → Audio, ensure the correct microphone is selected.

Transcription is Slow

1. Try a lighter model:
   • Go to Settings → Models.
   • Apple Speech uses minimal resources. Parakeet is very fast with good accuracy. Smaller Whisper models (Tiny, Base) are also lightweight. Larger Whisper models (Large v2, Large v3) offer the best accuracy but need up to 4 GB of RAM.
2. Check Available RAM:
   • If your Mac doesn’t have enough free memory, transcription may be very slow or fail to generate results. Close unnecessary apps to free up RAM.
3. Check CPU Usage:
   • Other intensive apps might slow down local processing.

Reporting Bugs

If you encounter a bug, please report it:

1. Email support@flowords.app
2. Include your macOS version and FloWords version
3. Describe the steps to reproduce the issue

Logs

To view logs for troubleshooting:

1. Open Console.app on your Mac
2. Filter for “FloWords”
3. Export the logs and attach them to your support email