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

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.

  1. Open System Settings > Privacy & Security > Microphone.
  2. Switch AstraCode on.
  3. Restart AstraCode if the switch was off.

Blocked on Windows

Windows is blocking the microphone for AstraCode.

  1. Open Settings > Privacy & security > Microphone.
  2. Turn on microphone access.
  3. Turn on Let desktop apps access your microphone.

Blocked on Linux

The microphone was refused.

  1. Check that your desktop allows AstraCode to use the microphone, in its privacy or sound settings.
  2. 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.

  1. Connect a microphone.
  2. 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.

  1. Open the menu beside the mic button.
  2. Choose the microphone you are speaking into.
  3. 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.

  1. Open the settings and search for astracode.dictation.language.
  2. Choose the language you speak, such as ne for Nepali.

← Connector problems Usage, billing and network errors →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference