Skip to main content
If OpenWhispr keeps mangling a colleague’s name, a product name or an acronym, add it to your dictionary. Words in there are passed to the transcription model as context, which makes it far likelier to pick them over a similar-sounding everyday word.

Adding words

Click Dictionary in the sidebar and stay on the Dictionary tab. Type a word and press Enter. The placeholder shows the format: “Add words separated by commas — OpenWhispr, Supabase, John Snow, ARR” — so you can add several at once. Words take effect on your next transcription; there’s nothing to save. To add a lot at once, use Import a list and paste them in, one per line or comma-separated. OpenWhispr tells you how many it found — “37 words ready” — before you commit. There’s an Export dictionary action too, which is the one to use before moving to a new machine.

What’s worth adding

Add the spelling you want to see. If you want “SOC 2” rather than “sock two”, that’s the entry.
Don’t paste your whole vocabulary in. The dictionary works as a hint to the model, and a very long list dilutes it — the fifty words you actually get wrong beat five hundred you don’t.

Auto-learn from corrections

OpenWhispr can watch for the moment you fix a transcription in the app you dictated into, and add the corrected word for you. The setting is Auto-learn from corrections, under SettingsPreferences (in the App group). It’s a good way to build a dictionary without thinking about it — the words you correct are by definition the ones being got wrong. If you’d rather OpenWhispr didn’t watch for corrections, leave it off.

Editing and removing words

Hover over a word in the list. A pencil and a appear at the right of that row — pencil to correct the spelling, to remove it.
Both controls are invisible until you hover, so the list looks read-only at rest. The same is true of snippets.
To empty the whole list, use Clear all. It asks first and can’t be undone: “This will remove all words from your custom dictionary.” Some entries are marked Added by default — those came with the app.

When it doesn’t help

The dictionary raises the odds; it isn’t an override. If a word still comes out wrong:
  • Check you’re not fighting the language setting — see languages.
  • Try the spelling you want to read, not the phonetic one.
  • For a phrase you say constantly, a snippet may serve better — it replaces a trigger with exact text rather than nudging a model.
  • Improve accuracy covers the rest.