Skip to main content
A thread is a replacement rule for dictation. When you say the trigger phrase, Vowen replaces it with your text before pasting. Threads run after the speech engine finishes, so they work the same with every local and cloud model. Threads tab listing triggers such as my email and office address, plus a regex rule

How to add a thread

1

Open Threads

Click Dictionary in the sidebar, then the Threads tab.
2

Click Add Thread

Add Thread is in the toolbar. The dialog is titled Add thread.
3

Enter the trigger

Type what you say, or more exactly, what the speech engine writes when you say it.
4

Enter the replacement

Choose Plain or Rich, then write the text that replaces the trigger.
5

Save

The thread works on your next dictation.
Add thread dialog with a trigger field, a Plain / Rich toggle and the replacement text Use the search box to filter by trigger or text. Press / or Cmd + F (Mac) / Ctrl + F (Win) to focus it. Each trigger must be unique.

Examples

How matching works

  • Case is ignored. my email matches “My Email” and “MY EMAIL”.
  • Triggers match whole words. A trigger only matches where it isn’t joined to a letter, digit or underscore. sig leaves “design” alone, and cal leaves “calendar” alone.
  • Edges are checked separately. A trigger that ends in punctuation, such as etc. or :), has no word check on that side.
  • Scripts without spaces (Thai, Lao, Khmer, Myanmar, Japanese kana, Chinese characters and Hangul) skip the word check, since they have no word gaps.
  • Every occurrence is replaced, not only the first.
  • Longer triggers go first. When two triggers overlap, the longer one claims the text. Shorter triggers still apply to the rest.
Your Dictionary misspellings are applied in the same pass with the same matching. Threads also apply to the query of a “navigate to” voice shortcut. A thread that maps “cost sheet” to a URL lets you say “navigate to cost sheet”.

Regular-expression rules

For patterns that a fixed phrase can’t describe, tick Use regular expression in the Add thread dialog. The trigger becomes a pattern and the replacement becomes a template. Add thread dialog with Use regular expression ticked, the pattern help, the timing menu and a Try it preview
  • Matching ignores case unless the pattern starts with (?-i).
  • No word boundaries are added. Use \b where you need one.
  • Refer to captured groups as $1, $2. $0 (the whole match), ${name} (a named group) and \$ (a literal dollar sign) also work.
  • Leave the replacement empty to delete the match. The list then shows removes match.
  • A pattern that matches empty text is rejected.
  • Plain / Rich is hidden for regex rules. They are always plain text.
Type a sample sentence in Try it to preview the result. It shows No match when the pattern doesn’t apply. Regex rules run in list order, after the plain threads. A rule that takes longer than 50 ms is skipped for the rest of the session.

When a rule runs

Regex rules have a timing setting: After-AI rules run whether or not AI enhancement is on for that dictation. The list marks them with after AI or before & after AI, and every regex rule with regex. Regex rules don’t apply to voice shortcut queries, and they never count toward the “simple thread” check below.

Rich text threads

In Rich mode you get a small editor with bold, italic, lists, links, headings, colors, highlights and alignment. Rich threads show a rich tag in the list. When a rich thread fires, Vowen puts both a formatted and a plain version on the clipboard. Apps that accept formatting, such as Gmail, Notion, Mail, Word and Google Docs, get the formatting. Plain-text apps get the plain version.
Rich formatting is lost when AI enhancement runs on the dictation. If a Tone, global AI enhancement or a shortcut enhances the dictation, rich threads are turned into plain text before the AI sees them.
Rich paste is also skipped when Text Insertion Method is set to Direct insertion, because that method types characters instead of pasting. See Text insertion.

A thread on its own skips AI

If a dictation is mostly a thread trigger, Vowen pastes the replacement straight away without sending it to the AI. This applies when at least one thread matched and six or fewer words remain around it, not counting filler words. “Um, my signature” pastes your signature instantly. A long dictation that contains “my signature” is enhanced as usual. There is no setting for this.

Smart spacing

After threads and AI enhancement, Smart Spacing and Capitalization adds the space the text needs and matches the capitalization around your cursor. Turn it on or off in Settings › General. It is off by default. See Text insertion. It applies to dictation, including thread replacements. It doesn’t apply to expansions.

Import threads

Click the import button next to the search box to add many threads from a CSV file.
  • Two columns: trigger, then replacement.
  • A header row is optional.
  • Existing triggers are skipped, and the preview shows how many.
  • Imported threads are plain text.
Download sample CSV saves vowen-threads-sample.csv with the expected layout.

Use cases

  • Fix repeated mistakes: “cube nets” becomes “Kubernetes”.
  • Paste boilerplate: “my signature” becomes your email signature.
  • Insert links: “portfolio link” becomes your portfolio URL.
  • Expand abbreviations: “ETD” becomes “estimated time of delivery”.
  • Format numbers: a regex rule turns “3 into 4” into “3 * 4”.
For a single term, a Dictionary entry with misspellings is often better. It also gives the speech engine a hint. Use a thread when the replacement is longer than, or unrelated to, what you said.

Threads, dictionary and expansions