Docs › Using the editor › Dictation

Dictation

Speak your message instead of typing it: record, choose a microphone, set your language, and what happens to the audio.

On this page

The microphone button in the chat composer turns what you say into text in the message box, where you can edit it before sending. You need to be signed in.

Recording

One button, two ways to use it:

A press shorter than about a third of a second counts as a click. With the button focused, Enter or Space starts and stops it too. When you stop, the text is added to whatever is already in the box.

A recording shorter than 0.4 seconds is not sent, and the button says Too short. Hold it a little longer, or click to record and click again when you have finished speaking.

Choosing a microphone

  1. Click the chevron beside the microphone button (Microphone settings).
  2. Pick a microphone from the list. It shows every input your system offers, and updates when you plug one in or take one out.

Until you have allowed the microphone once, your system hides device names, so the list shows System default and Microphone 1, Microphone 2 and so on, with the note Their names appear once the microphone has been allowed once. Opening the list may itself raise the permission prompt, to read the names; it does not record anything. With no microphone at all it says No microphone found. If the one you chose is unplugged, AstraCode stops using it.

Permission

The first time, your operating system asks whether AstraCode may use the microphone. If you refuse, the system does not ask again; you have to allow it in the system's settings. The button then says Blocked, and the microphone menu tells you where:

SystemWhere to allow it
macOSSystem Settings, Privacy & Security, Microphone: switch AstraCode on.
WindowsSettings, Privacy & security, Microphone: turn on microphone access, and Let desktop apps access your microphone.
LinuxYour desktop's privacy or sound settings; also check that the right input is chosen in the microphone menu.

Your language

By default the language is worked out from the audio. That works for most people, but it is least reliable for short clips and for languages with less training data: Nepali, for example, is often transcribed as Hindi or English. Naming your language removes the guess.

  1. Open your settings: run Preferences: Open User Settings and search for astracode.dictation.language.
  2. Choose your language.
ValueLanguage
auto (default)Detect from the audio
neNepali
hiHindi
enEnglish
esSpanish
frFrench
deGerman
ptPortuguese
zhChinese
jaJapanese
koKorean
arArabic
ruRussian

This is only the language you speak. The language AstraCode replies in follows whatever you write.

What happens to the audio

AstraCode listens only while you are recording. When you stop, the recording is sent through the AstraCode gateway to be transcribed, and the text comes back to the box. AstraCode does not keep the recording. There is no length limit on a recording, but dictation is meant for a message: a long clip takes longer to come back.

If something goes wrong

You seeWhat to do
BlockedAllow the microphone in your system settings, as above. AstraCode cannot ask again.
No micNo microphone is attached, or the chosen one has gone. Plug one in, or choose another in the menu.
Too shortHold the button longer, or use click to record.
Nothing was heard in that recording.Check which microphone is chosen in the menu beside the button.
Sign in to use dictation.Run AstraCode: Sign In.

Every message, including the ones from the transcription service, is in Dictation problems.

← Git: commit messages, branch review and conflicts Layout, themes and the settings page →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference