Docs / Features / Auto-paste

Auto-paste

How Ditto delivers your transcription into the active app, what to do when it doesn't work, and how to use clipboard-only mode instead.

How it works

After Whisper finishes transcribing, Ditto does three things in this order:

  1. Copy the text to the clipboard using Electron’s clipboard API.
  2. Wait 50 ms so any app currently watching the clipboard has time to register the new content.
  3. Simulate Ctrl+V with @nut-tree-fork/nut-js, which sends a real SendInput keystroke to the OS. The active app receives it as if you’d pressed Ctrl+V yourself.

There’s no special integration with each target app. Ditto just types Ctrl+V into whatever has focus, the same way you would.

Turning auto-paste off

By default Ditto pastes for you. You can switch it off in Settings → General → Paste transcription automatically.

When auto-paste is off:

This is useful if you want to:

Keeping your previous clipboard

By default, every transcription overwrites whatever was on your clipboard. That’s annoying if you had something important copied before dictating.

Settings → General → Keep previous clipboard changes the flow:

  1. Ditto snapshots your current clipboard text.
  2. Sets the transcription, simulates Ctrl+V.
  3. Restores the original clipboard text afterward.

So after the paste, your old clipboard content is back where it was.

When auto-paste doesn’t land

A handful of apps don’t accept simulated keystrokes:

The transcription is still on your clipboard — it just doesn’t paste itself. Press Ctrl+V manually, or use the dedicated paste gesture of the app (some terminals use Ctrl+Shift+V or right-click).

If Ctrl+V also doesn’t work in that app (some terminals, vim in raw mode), you’ll need to paste through the app’s own mechanism (Ctrl+Shift+V in vim, right-click + Paste, etc.). Ditto can’t help past that point.

Sound feedback

Auto-paste happens fast and silently. If you’d like a small audible cue when transcription finishes, turn on Settings → General → Sound when transcription finishes. It plays a short, soft click — easy to ignore if you’ve got music on but useful in a quiet room.