Docs › Troubleshooting › Dictation problems
Dictation problems
Fix a blocked or missing microphone, recordings that are too short or not heard, and the wrong language.
On this page
- Blocked on macOS
- Blocked on Windows
- Blocked on Linux
- No mic
- Too short
- Nothing was heard in that recording
- The recording could not be read
- Sign in to use dictation
- Dictation is busy or not working on our side
- The words come back in the wrong language
When dictation fails, a short label appears beside the mic button: Blocked, No mic, Failed or Too short. Open the menu beside the mic button for the full sentence. How dictation works is on Dictation.
Blocked on macOS
macOS is blocking the microphone for AstraCode. The system will not ask again after a refusal.
- Open System Settings > Privacy & Security > Microphone.
- Switch AstraCode on.
- Restart AstraCode if the switch was off.
Blocked on Windows
Windows is blocking the microphone for AstraCode.
- Open Settings > Privacy & security > Microphone.
- Turn on microphone access.
- Turn on Let desktop apps access your microphone.
Blocked on Linux
The microphone was refused.
- Check that your desktop allows AstraCode to use the microphone, in its privacy or sound settings.
- Choose the right input in the menu beside the mic button.
No mic
No microphone is attached, or the chosen one has gone., No microphone is attached. or This build cannot reach any audio device.
- Connect a microphone.
- Open the menu beside the mic button and choose it. Device names appear once the microphone has been allowed once.
Too short
Cause: recordings under about half a second are not sent. The gateway may also answer That was too short to hear anything.
Hold the mic button while you speak, or click once to start and again to stop.
Nothing was heard in that recording
Cause: the recording was silent, usually because a different microphone is chosen.
- Open the menu beside the mic button.
- Choose the microphone you are speaking into.
- Record again.
The recording could not be read
Try again. If it keeps happening, choose another microphone in the menu.
Sign in to use dictation
Dictation runs on your account. Run AstraCode: Sign In.
Dictation is busy or not working on our side
Dictation is busy right now. Try again in a minute., Dictation is not working on our side right now, The transcription service is having trouble or The service could not be reached. Try again in a moment.: wait a minute and try again.
Could not reach AstraCode to transcribe: followed by a reason means your connection; see Usage, billing and network errors. Dictation is not configured on this gateway. or This gateway is too old to transcribe speech. apply to a self-hosted gateway; ask its operator.
The words come back in the wrong language
Cause: the language is detected from the audio, which is weakest for short clips and for less common languages. Nepali, for example, is often heard as Hindi or English.
- Open the settings and search for
astracode.dictation.language. - Choose the language you speak, such as
nefor Nepali.
← Connector problems Usage, billing and network errors →
All documentation
Get started
Using the editor
- Tab completion
- Edit and ask about a selection
- Reviewing the agent's changes
- Git: commit messages, branch review and conflicts
- Dictation
- Layout, themes and the settings page
Agent
- Agent overview
- Agent, Plan, Ask and Debug
- Approvals and permissions
- Plan mode
- Debug mode
- Tools
- Browser tools
- How the agent checks its work
- Checkpoints and undo
- Running several agents at once
- Subagents and background tasks
- Remote agents in GitHub Actions
- Infrastructure as code
Context
Workspaces
Connectors
- Connectors (MCP servers)
- Connector configuration reference
- Use AstraCode from Claude, ChatGPT and other apps
Extending AstraCode
CLI
Account and usage
- Usage and limits
- Bring your own key
- What AstraCode sends and keeps
- Reporting a problem and getting help
Troubleshooting
- Troubleshooting
- Sign-in problems
- Install and update problems
- Chat panel problems
- Agent run problems
- Connector problems
- Dictation problems
- Usage, billing and network errors
- CLI problems