Getting started

  1. Open the downloaded .dmg and drag DictaTTY into Applications.
  2. Open DictaTTY from Applications. It has no Dock icon: look for the microphone in the menu bar at the top right of the screen.
  3. 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.
  4. 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.

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:

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

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:

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:

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:

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

Click the microphone in the menu bar to see what DictaTTY is doing. The menu has:

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.