shepetal
The natural stone bridge at Rakov Škocjan

Teach Mac dictation your names and jargon

Until now you dictated a message with a colleague’s name or your product’s name in it, your Mac wrote a word that sounds like it, and you went back and fixed it by hand. You don’t have to do that anymore. Here is where Apple keeps custom vocabulary on your Mac, step by step, and then how you add your words to shepetal’s dictionary once and get them spelled your way from then on.

By Pavel Hegler, founder of shepetal. Updated

Side by side

shepetalApple Dictation
On-device or cloudOn your Mac, and your voice stays there.On your Mac or on Apple’s servers. Its privacy page says Keyboard Settings show whether dictation is processed on your device; otherwise, Apple’s servers process it. apple.comsupport.apple.comas of
OfflineWorks offline.shepetal downloads speech recognition on its own after you install it, and one more file when you choose a language outside the 25 European ones.On a Mac with Apple silicon, for supported languages, says Apple’s guide for macOS Sonoma 14. support.apple.comas of
In any appWorks in every app.When an app blocks paste, your words wait for you on the clipboard.Yes. Its guide: “anywhere you can type it.” support.apple.comas of

Every line on another app here comes from its own pages, and each one links the page and the day we checked it. shepetal is independent of these apps and of the companies that make them.

Where Apple keeps it

On a Mac, Apple’s custom vocabulary is part of Voice Control. Open System Settings, click Accessibility in the sidebar, then click Voice Control and click Vocabulary. If Vocabulary is dimmed, Apple’s page says the selected language doesn’t support a custom vocabulary. support.apple.comas of

Add your words

Click the Add button, type the word or phrase the way you want it written when you say it, and click Next. Then click Record, say it and click Save. To record later, click Save Without Recording, and when you are ready, Control-click the word and choose Record pronunciation, which needs Dictation turned on. support.apple.comas of

Many words at once

When you already have a list, put each term on its own line in a text file. Click the Advanced Actions menu in the lower-right corner, choose Import Vocabulary, select the file and click Select, then choose the language and click Import. The same menu also imports a file you exported from Voice Control before. support.apple.comas of

Voice Control and Dictation

Apple’s page covers custom vocabulary with Voice Control, and Apple’s Dictation guide says that when Voice Control is on, you dictate with Voice Control and standard macOS Dictation isn’t available, so you choose one of the two for your dictation. support.apple.comsupport.apple.comas of

The shepetal dictionary

In shepetal your words go into the dictionary. Choose Open shepetal in the 🤫 menu, click Dictionary, type a name or a term under “Word or phrase”, like Hegler, and click Add. From your next dictation shepetal writes it exactly the way you typed it, with its capital letters, so when you say Kubernetes or Figma in a sentence you get Kubernetes and Figma.

Swap what you say

Fill in “Write it as” as well, and shepetal swaps what you say for what you typed there, like the nickname you use for a colleague for their full name. At the start of a sentence the swap keeps the capital letter, and the Dictionary lists each swap with what you say under it.

When a word comes out wrong

If a name still comes out wrong, type what shepetal wrote under “Word or phrase” and the right spelling under “Write it as”, and from your next dictation shepetal swaps one for the other. For a dictation you already made, press Re-transcribe on it in the shepetal window, and shepetal writes it again with the words you just added.

Star what matters

Star the words that matter most, and shepetal puts them at the top of the list it listens for. When you have a long list, Edit as text at the bottom of the Dictionary opens it as a file in your text editor, one word per line, or what you say => how to write it, so you can paste in a list you already keep, like the one you import into Voice Control.

How it hears them

shepetal downloads dictionary support on its own, and in English and German dictations it listens for your words in what you said, so a product name it would otherwise hear as everyday words comes out as the name you added, like HubSpot. For the 75 languages that come with one more download, shepetal gives your dictionary to speech recognition before it writes your text, and in every language a word you say that matches an entry gets your spelling.

Your dictionary runs last, after the style for the app you are in, so a name keeps its capital letters in Very casual too, the style that writes everything in lowercase.

Words it knows

In code editors like Cursor, VS Code and Xcode, shepetal already knows developer words like useEffect, so there you add only the names of your own projects and the people you work with.

On your Mac

Your dictionary is a file in your user folder that only your account can read, and shepetal processes every dictation on your Mac.100% private. Your data is yours.

Which to pick

Pick Apple Dictation if

  • You already dictate with Voice Control and want your words there.

Pick shepetal if

  • You say the same names and terms every day and want them spelled your way. You add them to your dictionary once, and shepetal keeps their spelling and capital letters in every style.
  • You want the ums and the repeated words out of every dictation, and a style for work messages, personal messages and email, so a Slack reply reads like a Slack reply and an email reads like an email.
  • You dictate in English and German and want your English terms spelled your way in both.

Read next

Sources

30 days free

€24

once. Yours forever.

€2

a month.

30-day money-back guarantee.

Write to support@shepetal.app within 30 days of your one-time payment or your first monthly one. Pavel, who builds shepetal, sets up a short call with you where you tell him what is broken or why you do not like it, and then you get your money back. This comes on top of your legal rights, including the right of withdrawal.

If you have more questions, the FAQ and the Privacy Policy answer them.

shepetal on Peerlist