Dictation
Talk, and your words are typed where your cursor is, in any app. Hold the shortcut or tap it.
Dictate
- Click where you want the words to go, in any app.
- Hold ⌥ Space (Option and Space) and talk.
- Let go. Your words are typed in.
A small bar, the pill, shows while shoonk! is listening. Its bars move with your voice.
Hold, or tap
By default you can do either:
- Hold the shortcut while you talk, and let go when you’re done.
- Tap it once to start, talk as long as you like, and tap it again to stop.
To use only one way, go to Settings → Dictation → Hold or tap and choose Hold or Toggle instead of Auto.
Cancel
Press Esc while you’re dictating. Nothing is typed.
Change the shortcut
Go to Settings → Shortcuts and click Dictate. See Shortcuts.
Add screenshots while you talk
While you’re dictating, press ⇧⌘4 and drag a box round part of the screen. The screenshot goes into your dictation, at the point where you were talking. You can take several. When you finish, your words and screenshots are pasted together, each screenshot where you were talking about it.
This is handy for telling someone, or an AI, what’s wrong with something on your screen: “This button doesn’t do anything,” with the button right there.
Pasted into a terminal, such as one running Claude Code, Codex or OpenCode, each screenshot goes in as the path to its file, which those tools open as a picture.
Screenshots in the pill can be shown larger or taken out before you finish. To mark one up first, press ⇧⌘3 instead, draw on it, and press Add to dictation.
Where your dictations go
- They’re typed where your cursor is. shoonk! pastes them, then puts back whatever was on your clipboard before.
- Every dictation is also kept on Home, in shoonk!’s main window, so you can copy it again, play back the audio, or try transcribing it again. Dictations are kept for 3 months to start with, and pinned ones are kept for good. Change this in Settings → Advanced → Delete old dictations.
- If something stops the words being pasted, the pill says so (for example “Couldn’t paste · your words are on Home”) and nothing is lost.
Change how it pastes
Go to Settings → Dictation → Pasting and clipboard:
- Paste where I’m typing. Off, your dictations wait on Home instead.
- Afterwards, your clipboard holds: what you’d copied, or your dictation.
- Press Return for you, to send a chat message as soon as it’s pasted.
- Add a space after, so the next word you type doesn’t run into it.
Getting the words right
In Settings → Dictation → Your words:
- Language. The language you speak, or Auto-detect.
- Vocabulary. Names and words shoonk! should spell your way, such as people, products and jargon. You can also edit these on the Vocabulary page.
- Leave out “um” and “uh”.
When you dictate on your Mac with a model that can translate, you can also turn on Translate to English: whatever you say comes out in English. The switch only shows for models that can do it.
How accurate dictation is also depends on where your speech becomes text.
The pill
In Settings → Dictation → While you dictate:
- Recording bar: Waveform only (to start with), Waveform and words (words show live with models that stream), or Hidden.
- Position: Bottom or Top. With Waveform only, Right side too.
- Drag the pill while you dictate and it stays there. Put it back returns it to its usual spot.
Right-click the pill for a menu: put it back, change its position, hide it, choose where speech becomes text, or open Settings.
Sound
In Settings → Audio:
- Microphone: which microphone shoonk! listens to.
- Mute other sound while dictating, so music and videos go quiet until you stop.
- Play sounds, a soft tone when a dictation starts and stops.
If you dictate with AirPods that are connected to your phone, shoonk! takes them back for your Mac when you start dictating.