Troubleshooting
import ValidationNotice from ‘../../../components/ValidationNotice.astro’;
Keep the original recording and note the exact error state before retrying a failed workflow. This makes it possible to separate model setup, capture permissions, conversion, transcription, and summary-provider failures without deleting useful session data.
Safe first checks
Section titled “Safe first checks”- Confirm whether you are using Local Mode or an optional remote provider.
- Check whether the required local models are installed before retrying a local workflow.
- Preserve the source recording and current session until you have identified the failure stage.
- Avoid app-data reset as an initial diagnostic action because it removes local session and index records.
Diagnostic guidance in this site is limited to verified application behavior and does not instruct normal users to bypass macOS protections or edit application data directly.
Troubleshooting pages
Section titled “Troubleshooting pages”- Diagnostic checklist
- Installation and Gatekeeper
- App does not start
- Model download fails
- Whisper model not found
- Ollama does not start
- Transcription fails
- Audio conversion fails
- Microphone not captured
- System audio not captured
- Reset recording permissions
- Summary generation fails
- Remote provider errors
- Search index not ready
- Poor transcription quality
- Poor summary quality
- Performance and memory
- Session data recovery
- Reset and recovery