> ## Documentation Index
> Fetch the complete documentation index at: https://docs.char.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dictate with your voice

> Talk instead of typing, in Char or any app on your Mac, and edit text by saying what to change.

Hold a shortcut, say what you mean, and let go: Char types a cleaned-up version where your cursor is, in Char or any other app on your Mac. With text selected, what you say becomes an instruction for that text instead.

Voice input is in desktop Nightly on macOS, and you need to be signed in. Char mobile doesn't dictate; its **Settings → Voice** holds only your [Dictionary](#help-char-hear-names-and-terms).

## Try it

[Dictation in Char: Turn speech into clean text in any app](https://www.youtube-nocookie.com/embed/nxOi-PtGnkM?rel=0)

1. Click into a text field, such as a chat with Charlie, a Slack message, or an email.
2. Hold **⌃⌥** (Control + Option). The first time, allow microphone access when macOS asks.
3. When the bar at the bottom of the screen opens, say: "Um, let's meet Tuesday, no, Wednesday at three."
4. Let go.

"Let's meet Wednesday at three." appears at your cursor: the filler word is gone and your correction is applied. If the bar says your words are on the clipboard instead, see [Let Char type in other apps](#let-char-type-in-other-apps).

## Dictate in a chat or a Page draft

The chat composer and @Charlie drafts on a Page have a microphone button. Click it to start and click again to stop, or hold it and release to stop. What you said is added to the end of the draft, ready to edit before you send. You can dictate while Charlie is still replying.

In an @Charlie draft, **Enter** finishes dictating and **Escape** cancels.

The [Voice input shortcut](#dictate-anywhere-on-your-mac) works in the composer too, and types at your cursor instead of at the end. With text selected in the composer, the shortcut [edits it](#edit-text-by-saying-what-to-change).

## Dictate anywhere on your Mac

* **Hold to talk:** hold **⌃⌥** while you speak and release to type.
* **Hands-free:** double-tap **⌃⌥** to keep listening, or press **Space** while holding it and let go. Press **⌃⌥** once more to type.
* **Cancel:** press **Escape**, or press another key along with the shortcut.

A quick tap of under a quarter second does nothing, so shortcuts like ⌃⌥ + arrow from a window manager never turn on the microphone. Space only goes hands-free once the bar is listening, so a quick ⌃⌥Space still switches input sources, and the Space never reaches the app you are typing in. A dictation can last 5 minutes; at the limit Char stops listening and types what it heard.

Nothing is typed while you talk. When you let go, Char cleans up the whole thing and types it in one go.

To use a different shortcut, open **Settings → Keyboard shortcuts** and record a new **Voice input** shortcut. It can be two or more modifiers held on their own, a right-hand key like Right ⌘, or Fn (see [Keyboard shortcuts](https://docs.char.com/keyboard-shortcuts.md#in-settings)).

### Let Char type in other apps

Voice input everywhere is built in. It needs two macOS permissions, which you can allow in **Settings → Privacy & access**:

* **Input Monitoring** lets Char notice the shortcut in any app. Nothing listens until it is granted.
* **Accessibility** lets Char type into the app you are using.

In other apps, Char types through the clipboard and puts your clipboard back afterwards; clipboard managers skip the temporary copy. Without Accessibility, or when nothing editable is focused, your words stay on the clipboard and the bar says so. Press **⌘V** to paste them.

## What the bar shows

The bar floats at the bottom of your screen without taking focus. It appears over full-screen apps and never shows in screen sharing or recordings.

| You see | What it means |
| - | - |
| A small pulsing dot | The microphone is starting. Begin talking when it opens into the full bar. |
| **Listening** and your words | Char is hearing you. The newest words stay in view while older ones fade. |
| **Typing what you said…** | You let go, and Char is cleaning up and typing. |
| **Say how to change the selection** | You had text selected, so what you say is an instruction for it. |
| **Editing the selection…** | Char is applying your instruction. |
| A message about the clipboard or error | Something went wrong. See [If something goes wrong](#if-something-goes-wrong). |

**Cancel** is on the left. On the right, the voice level turns into **Finish** when you point at it, which types what you have said so far.

## Edit text by saying what to change

1. Select text in Char or any other app.
2. Hold **⌃⌥** and say what to change, for example:
   * "Make it shorter."
   * "Add a thanks at the end."
   * "His name is Jon, J-O-N."
3. Let go. The edited text replaces your selection.

If the edit fails or takes longer than about 17 seconds, nothing changes and your selection stays as it was. A selection longer than 20,000 characters falls back to plain dictation: Char replaces the selected text with what you said instead of applying it as an instruction. Editing works even with **Polish what you say** turned off. The microphone button in the composer doesn't edit selections; use the shortcut.

## How Char polishes what you say

**Polish what you say** is on by default. Before typing, Char removes filler words in any language (such as "um," "you know," "음," or "좀"), false starts, and repeats, applies your corrections, and fixes punctuation:

> **You say:** "So, um, I think we should, we should push the launch to, uh, Friday, no, actually next Monday."
>
> **Char types:** "I think we should push the launch to next Monday."

If cleanup fails or takes longer than about 6 seconds, Char types exactly what it heard. Turn the setting off in **Settings → Voice** to always type exactly what was heard.

### Prompts for Charlie and other AI agents

When you dictate to Charlie, or into the Claude, ChatGPT, or Codex apps or Claude or ChatGPT in a browser, Char keeps only your conclusion. Think out loud; the last thing you say about each topic replaces what came before it, at the strength you said it:

> **You say:** "So I want to use Boat for CI because it's so cheap, but Blacksmith is cool too. On second thought we should just keep using Depot. Vercel CI looks cool too."
>
> **Char types:** "Vercel CI looks cool."

A question stays a question, and an opinion never becomes an instruction. To get exactly what you said instead, tap the Voice input shortcut within 15 seconds, before moving the cursor. Code editors such as Cursor only get cleanup, since what you type there is often code, not a prompt.

### Writing for X, LinkedIn, Slack, and email

When you dictate into X, LinkedIn, Slack, or email, Char goes further and writes your spoken thoughts as a finished post or message in the way you write there. This works in the Slack, Mail, Outlook, Superhuman, Spark, Airmail, and Mimestream apps, and in X, LinkedIn, Slack, Gmail, and Outlook in a browser. Everywhere else, including Char, it only cleans up.

To get exactly what you said instead, tap the Voice input shortcut within 15 seconds, before moving the cursor.

Char learns your style from examples it keeps on your Mac, five for each destination: when you edit a rewrite before sending it, your edited version becomes an example. Rewrites you send unchanged are not kept, so Char never learns from its own writing. Messages you type yourself in those places become examples too: Char counts your key presses, never which keys, and reads the message field only once you start typing there. The examples are sent with what you dictate there.

## Help Char hear names and terms

Open **Settings → Voice**:

* **Microphone** chooses the microphone; **System default** follows macOS. Use **Refresh devices** after plugging one in.
* **Dictionary** holds up to 100 names, words, and phrases, such as colleagues' names or product terms. Meeting notes use it too.

When you start dictating from a Char window, Char also reads the text visible in that window and sends it with your audio to help with names and terms. It never reads other apps, and no screenshots are saved.

## Lower other audio

While Char listens, music and videos keep playing at a whisper, then come back to their volume when you stop. If you change the volume during a dictation, Char leaves your new volume alone.

## What Char sends and keeps

* Your audio streams to Char's transcription provider while you talk. Char holds it in memory only and doesn't keep recordings.
* Cleanup, rewrites, and edits run on AI providers that don't retain what Char sends.
* Along with your audio, Char sends your Dictionary, the text visible in the Char window you dictate from, your selection when you edit, and style examples when you write for X, LinkedIn, Slack, or email.
* Style examples are stored only on your Mac.

## If something goes wrong

| What happens | What to do |
| - | - |
| Holding the shortcut does nothing | Check that **Input Monitoring** is allowed in **Settings → Privacy & access** and that a **Voice input** shortcut is assigned. Hold it, don't tap it. |
| Fn doesn't start dictation | Set **Press 🌐 key to** to **Do Nothing** in macOS Keyboard settings. |
| **Allow Accessibility so Char can type here** | Allow **Accessibility** in **Settings → Privacy & access**. Your words are on the clipboard; paste them with ⌘V. |
| **Couldn't type here** | Click into a field you can type in and paste with ⌘V. |
| **Sign in to use voice input.** | Sign in to Char in **Settings → Profile**. |
| The bar asks you to allow microphone access | Allow Char in **System Settings → Privacy & Security → Microphone**, then quit and reopen Char. |
| **Preparing voice input timed out** | Try again. If it keeps happening, quit and reopen Char. |
| Your first words are missing | Wait for the bar to open from a dot into the full bar before you speak. |
| The text still has filler words, or reads differently than you said | Check **Polish what you say** in **Settings → Voice**. If cleanup was slow, Char typed exactly what it heard. After a rewrite, tap the shortcut within 15 seconds for your exact words. |

Still stuck? [Contact support](https://docs.char.com/help.md) with your app version and the message the bar showed.

## Credits

The 3D device models you see when hovering a row in the **Microphone** menu come from Sketchfab and are used under [Creative Commons Attribution 4.0](https://creativecommons.org/licenses/by/4.0/). Char compressed them, removed their textures, and posed the MacBook's lid open.

| Model | Author |
| - | - |
| [AirPods Pro](https://sketchfab.com/3d-models/airpods-pro-4478dddbfa244f6f9b93eebbd027a73b) | [JY\_JY\_](https://sketchfab.com/JY_JY_) |
| [Macbook Pro 13 inch 2020](https://sketchfab.com/3d-models/macbook-pro-13-inch-2020-efab224280fd4c3993c808107f7c0b38) | [timblewee](https://sketchfab.com/timblewee) |
| [Apple iPhone 13 Pro Max](https://sketchfab.com/3d-models/apple-iphone-13-pro-max-4328dea00e47497dbeac73c556121bc9) | [DatSketch](https://sketchfab.com/DatSketch) |
| [Apple Pro Display XDR](https://sketchfab.com/3d-models/apple-pro-display-xdr-7e92cfb7c84d41f886c7748be6c567da) | [polyman Studio](https://sketchfab.com/Polyman_3D) |
| [Headphones Free Model by Oscar Creative](https://sketchfab.com/3d-models/headphones-free-model-by-oscar-creative-db92168ca39541939d0110e64a37f92e) | [OSCAR CREATIVO](https://sketchfab.com/oscar_creativo) |
| [Microphone Blue Yeti](https://sketchfab.com/3d-models/microphone-blue-yeti-8d34f19a184747a0b4af76f7ea0ed572) | [AlbertVictory](https://sketchfab.com/albert_victory) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.