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
- Recording
- Choosing a microphone
- Permission
- Your language
- What happens to the audio
- If something goes wrong
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:
- Click to start recording, and click again to stop. The tooltip reads Click to stop while it records.
- Hold the button while you talk, and let go to stop. The tooltip reads Release to stop.
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
- Click the chevron beside the microphone button (Microphone settings).
- 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:
| System | Where to allow it |
|---|---|
| macOS | System Settings, Privacy & Security, Microphone: switch AstraCode on. |
| Windows | Settings, Privacy & security, Microphone: turn on microphone access, and Let desktop apps access your microphone. |
| Linux | Your 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.
- Open your settings: run Preferences: Open User Settings and search for
astracode.dictation.language. - Choose your language.
| Value | Language |
|---|---|
auto (default) | Detect from the audio |
ne | Nepali |
hi | Hindi |
en | English |
es | Spanish |
fr | French |
de | German |
pt | Portuguese |
zh | Chinese |
ja | Japanese |
ko | Korean |
ar | Arabic |
ru | Russian |
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 see | What to do |
|---|---|
| Blocked | Allow the microphone in your system settings, as above. AstraCode cannot ask again. |
| No mic | No microphone is attached, or the chosen one has gone. Plug one in, or choose another in the menu. |
| Too short | Hold 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
- 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