Getting started
- Open the downloaded
.dmgand drag DictaTTY into Applications. - Open DictaTTY from Applications. It has no Dock icon: look for the microphone in the menu bar at the top right of the screen.
- The setup window asks for four permissions. Click each button: DictaTTY opens the right pane of System Settings and notices when you turn the switch on.
- Click in any text field — a terminal, a chat, a document — double-tap Right Shift, and start talking.
The first time you dictate in a language, macOS downloads Apple's speech model for it, and the menu shows the progress. After that, dictation starts in a fraction of a second.
Permissions
DictaTTY needs four permissions. You can check them at any time in Settings → Permissions.
- Microphone — to hear you while you dictate.
- Speech Recognition — to turn your voice into text with Apple's speech recognition, on your Mac.
- Accessibility — to type the text into the app you are using. DictaTTY also reads the one character before the cursor, so new text gets the right space and capital letter.
- Input Monitoring — to see the hotkey, and to notice when you type or click during dictation so your own edits are never overwritten. Keystrokes are not recorded or stored.
If DictaTTY is not in the Accessibility or Input Monitoring list, click + under the list in System Settings and choose DictaTTY in Applications. When a permission is missing, the menu shows a warning with Fix….
Dictating
Start: put the cursor where the text should go and double-tap Right Shift (or use the hotkey you chose). A chime plays, and the menu bar icon turns red while DictaTTY is listening.
Speak: your words are typed as you speak. The last six words may still change while recognition settles; older words stay exactly as typed.
Stop in any of these ways:
- Tap Right Shift once — a clean tap, the key pressed and released on its own. In Settings you can ask for the same double tap that started it instead.
- Press Return, usually to send a message: dictation ends at once (see After Return).
- Say the send word, such as “send” (see Send command).
- Stay silent: by default dictation stops after two minutes of silence (see Auto-stop).
- Choose Stop Dictation in the menu.
Using Shift as a modifier — Shift + a key for a capital letter or punctuation, Shift+Return for a new line — never stops dictation.
Typing, clicking and switching windows
- Type or click while dictating — add a “!”, fix a word, press Shift+Return, paste an image. Everything on screen stays as it is, and new words continue after your edit.
- Hold Shift, Command, Option or Control and typing pauses, so your keyboard shortcuts never mix with dictated text.
- Switch to another window or app and dictation keeps going: the next words go wherever the cursor is now. To stop instead, turn on Stop when I switch to another window in Settings.
- Opening a DictaTTY window (Settings or setup) always stops dictation, so text never lands in it.
Punctuation and new lines
Say “new line” or “new paragraph” to break lines, and say punctuation where you need it: “comma”, “period”, “question mark”. Use the words of your dictation language — in Russian, for example, “новая строка”, “запятая”, “точка”.
In English, punctuation is also added automatically. In some languages, such as Russian, it appears only when you say it.
Hotkey
Choose the style in Settings → General → Hotkey:
- Multi-tap (default) — tap a modifier key several times. Key: Right or Left Command, Option, Control or Shift, or Fn. Taps: double or triple. Stop with: a single tap (default) or the same taps that started dictation. Out of the box it is a double tap of Right Shift.
- Key combination — a shortcut such as Control + Option + Space, the default for this style. Click Change and press the new shortcut; it needs at least one of Command, Option, Control or Shift. Press the shortcut again to stop.
A tap counts only when the key is pressed and released quickly and on its own.
After Return
Return usually sends a message or runs a command. The After Return setting decides what happens next:
- End dictation (default) — listening stops at once, so nothing more lands in the empty field.
- Keep listening — dictate the next message right away. Dictation then ends with the hotkey or after the silence set in Auto-stop.
Shift+Return always adds a new line and keeps dictating.
Send command
Finish a message hands-free: pause, say the send word on its own, and stop talking. The word is not typed — DictaTTY ends dictation and presses Return. It is handy for Claude Code and chats.
The send words are those of your dictation language plus the English “send” — for example “отправить” in Russian, “senden” in German, “envoyer” in French. To use your own words instead, list them in Settings → Vocabulary → Send words, separated by commas. The command can be switched off there too.
The command needs a short pause before the word, so “send” in the middle of a sentence is simply typed.
Vocabulary
Most words, including common technical terms, need no help. Use Settings → Vocabulary only for words the recognizer gets wrong: names, products, rare terms. Write one entry per line:
DictaTTY— a word on its own: the recognizer tries to spell it exactly like this.cube control → kubectl— an arrow: whatever gets typed before it is replaced with what comes after it. This always works. You can type->instead of the arrow.cube control, cube cuddle → kubectl— several ways a word gets misheard, separated by commas.# work— a note for yourself; ignored.
Not sure what goes before the arrow? Dictate the word once and copy what gets typed. Replacements ignore capital letters and match whole words; spaces and hyphens between words don’t matter. Changes apply from the next dictation.
Languages
Dictation language. Choose it in Settings → General → Language or in the menu under Language. The languages from System Settings → General → Language & Region come first; every other language is under Other Languages. A new language downloads its speech model from Apple the first time you use it. English words mixed into your speech are usually recognized in other languages too, so if you speak two languages you can stay in your main one.
DictaTTY offers the dictation languages of macOS: 33 languages in 54 regional variants — Arabic, Cantonese, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Romanian, Russian, Slovak, Spanish, Swedish, Thai, Turkish, Ukrainian and Vietnamese. The list comes from macOS itself, so languages Apple adds appear automatically.
Interface language. The menus and windows are available in 34 languages. Automatic uses the first language other than English in your Language & Region list — so on an English system with Russian as the second language, DictaTTY appears in Russian. To choose yourself, use Settings → General → Interface language and click Restart Now.
Microphone
By default DictaTTY uses the System default microphone and follows your macOS Sound settings. To use a specific input — an external mic, a headset, or a virtual device such as BlackHole — choose it in Settings → General → Microphone or in the menu under Microphone.
Dictation keeps working during WhatsApp and Google Meet calls. If the input disappears mid-dictation, for example when a headset is unplugged, dictation stops and the menu says so.
Sounds and auto-stop
- Sounds — a soft sound when dictation starts and stops: Chime (default), Bubble, or Off.
- Stop after — dictation stops after this much silence: 15, 30 or 60 seconds, 2 minutes (default), 5 minutes, or Off to stop it yourself. Any speech resets the timer.
- Stop when I switch to another window — off by default, so dictation follows you between windows.
The menu
Click the microphone in the menu bar to see what DictaTTY is doing. The menu has:
- Start Dictation / Stop Dictation.
- Copy Last Dictation — puts the text of the last dictation on the clipboard. This is the only time DictaTTY touches the clipboard: dictated text is always typed, never pasted.
- Microphone and Language.
- Settings… (⌘,), Help, About DictaTTY, Check for Updates… and Quit DictaTTY.
The icon blinks while the recognizer gets ready and turns red while DictaTTY is listening.
Updates and startup
DictaTTY checks for updates once a day. When one is available, the menu shows Update Available… rather than interrupting your work; choose it to see what’s new and install. You can also choose Check for Updates… at any time, or turn automatic checks off in Settings → General → Startup. Updates are signed, and DictaTTY verifies the signature before installing one.
Launch at login, in the same section, starts DictaTTY when you log in.
Troubleshooting
The hotkey does nothing
Check that Input Monitoring is on in Settings → Permissions. If another app has Secure Keyboard Entry turned on — a password field, or the Secure Keyboard Entry item in a terminal’s menu — macOS hides key taps from other apps, and the DictaTTY menu says so. Turn it off in that app, or switch the hotkey to a key combination.
Nothing is typed
Check that Accessibility is on. If DictaTTY is listed but still cannot type, select it in System Settings → Privacy & Security → Accessibility, remove it with −, and add it again with +. Some fields, such as password fields, don’t accept text typed by other apps.
“No speech recognized”
Check the microphone chosen in Settings → General → Microphone and its input level in System Settings → Sound → Input, and make sure the dictation language is the one you are speaking.
Words come out wrong
Check the dictation language, then add the word to your vocabulary.
Dictation stopped by itself
The menu shows why: silence (see Auto-stop), Return was pressed, you switched windows with “Stop when I switch to another window” on, a DictaTTY window opened, or the microphone stopped working.
“Downloading speech model…” takes long
The first use of a language needs an internet connection to download Apple’s speech model. Wait for it to finish, or choose Cancel in the menu and try again later.
Still stuck?
Write to us — see Support.
Uninstalling
Quit DictaTTY from its menu and move it from Applications to the Trash. Its settings are in ~/Library/Preferences/com.liapinsoft.dictatty.plist. You can also remove DictaTTY from the Accessibility and Input Monitoring lists in System Settings → Privacy & Security.