Custom vocabulary

Last updated • 4 min read

Evoglyph's transcription model is general-purpose, so it tends to mis-hear names, jargon, brand names, and abbreviations. Custom vocabulary teaches Evoglyph those words. Cleanup uses your terms so they come out spelled the way you want. Add a term and it works on the next dictation. No retraining, no waiting.

How vocabulary works#

Evoglyph works in two steps. The speech model writes down what it heard, then the cleanup model turns that raw text into finished text. Your vocabulary list guides the second step.

Before cleanup runs, Evoglyph compares the raw text with your terms. When part of it comes close to one of them, such as "post gress" for Postgres or "oh auth" for OAuth, Evoglyph hands that term to cleanup. Cleanup then spells it the way you wrote it.

Only terms that come close to what you said reach cleanup, so a long list does not crowd the model, and a term you never said does not slip in. Evoglyph also skips a match when the words it would replace are all ordinary English, so a term like Go does not take over the verb "go". Cleanup still makes the final call, so a term that sounds very different from how it is spelled may come through as heard.

There's no model retraining, no per-user fine-tuning, and no audio leaving your Mac. Adding or removing a term takes effect on the next dictation.

Earlier versions also ran a second speech model that swapped vocabulary terms into the raw text. Version 0.3.8 turned it off, because it added wrong terms more often than it fixed missed ones.

How to add, edit, and remove terms#

Vocabulary is managed in the Vocabulary tab of the Evoglyph dashboard. For a full overview of the dashboard and its other tabs, see App dashboard.

Open Evoglyph's dashboard from the menu bar icon, then go to Vocabulary. The vocabulary panel is a simple list: one term per row, an Add button at the top, and a delete control on each row.

Changes save immediately. The next time you dictate, your updated list is in effect; there's no apply step, no restart.

Note

The vocabulary UI is being polished as part of the launch onboarding work (Evoglyph#697). The behavior described above is stable; the visual layout may shift slightly between releases.

What to add (and what not to)#

Good candidates are words the base model has no reason to know: your domain's jargon, brand names, and acronyms. Some categories that pay off immediately:

Bad candidates: common English words. Adding the, and, but, that doesn't help. The base model already knows them, and Evoglyph skips matches made only of ordinary English words, so these entries never reach cleanup.

Best practices#

Troubleshooting#

Term isn't being recognized

Open the Vocabulary panel and confirm the spelling is exactly what you expect. Cleanup uses the term as written, so Postgress comes out as Postgress. If the spelling is right, the speech model may be hearing something too far from the term to match. Record a few pronunciation samples for it so Evoglyph learns how it hears you.

Term gets transcribed with the wrong capitalization

Cleanup uses the casing of your entry. Edit the entry to match the casing you want. If you have both Postgres and postgres in the list, delete the one you don't want.

Adding terms doesn't seem to help accuracy

Check that you're adding the right kind of term. Vocabulary helps most with rare or domain-specific words. Common English (that, about, over) never reaches cleanup as a vocabulary match. Restrict your list to words the base model is unlikely to have seen often.

A vocabulary term keeps appearing where it doesn't belong

The term is close enough to a word you use for something else that cleanup swaps it in. Delete it, or make the entry more specific. A short entry is the usual cause; replace it with the full term you mean.

For deeper accuracy issues unrelated to vocabulary (slow transcription, wrong audio device, or empty output), see the troubleshooting guide.

Was this helpful?