Documentation

Settings: Text Output

Control insertion methods and fallback ordering by app context.

Insertion Methods

Steno supports three insertion methods:

  1. Type directly (direct)
  2. Accessibility insert (accessibility)
  3. Backup paste via clipboard (clipboardPaste)

These appear in settings as a reorderable list.

Ordering and Fallback

Steno attempts insertion in your configured order.

  • first method succeeds -> insertion finishes
  • method fails -> Steno tries the next method
  • all fail -> status is marked failed in history

Clipboard backup is always preserved by normalization logic, even if you reorder methods.

Terminal Behavior

For known terminal-like targets, Steno automatically prioritizes clipboard insertion first.

Current clipboard-first bundle IDs include:

  • dev.warp.warp-stable
  • com.openai.codex
  • com.apple.terminal
  • com.googlecode.iterm2

This improves reliability where simulated typing may be less predictable.

Verify Output

After changing insertion settings:

  1. Dictate into a code editor.
  2. Dictate into a terminal.
  3. Check History insertion status (Inserted, Copied, or Failed).
  4. If terminal performance is better than editor (or vice versa), reorder methods accordingly.

Clipboard fallback is a safety net

Even when direct insertion is blocked by app behavior or permissions, clipboard backup keeps transcript text recoverable.