Get the most out of Lispr.
Lispr is small on purpose — there's no settings window, no sign-up, no surprise. This page covers what it does, how to fix the few things that occasionally go sideways, and what happens to your voice.
First-time setup
Lispr walks you through this on first launch — this is the same flow, written down in case you need to redo it.
1. Microphone
Lispr needs to hear you. macOS will prompt the first time; if you missed the prompt or revoked the permission, grant it in System Settings → Privacy & Security → Microphone — toggle Lispr on.
2. Accessibility
Lispr inserts the recognized text where your cursor is — that requires the Accessibility permission. Grant it in System Settings → Privacy & Security → Accessibility — toggle Lispr on.
3. Input Monitoring (optional)
Lispr doesn't need it: the Accessibility permission above already lets it see the trigger key from any app. macOS may still list Lispr under System Settings → Privacy & Security → Input Monitoring — granting or skipping it changes nothing.
None of these create an account or send anything off your machine on grant. They unlock the parts of macOS Lispr needs to actually work.
Daily use
Push to talk
Hold the right ⌥ key, speak, release. Text appears at your cursor in any app. That's it — there's no wake word, no listening mode, no settings.
Latched (hands-free) mode
Double-tap the trigger key and Lispr keeps recording until you tap again. Useful when you need both hands free.
Cancel mid-recording
Press Esc while recording to drop it — nothing is inserted and no text comes back. Audio is streamed as you speak, so part of it may already have reached the transcription proxy; it isn't stored there.
Alternative trigger keys
If right ⌥ is taken by another shortcut on your Mac, pick a different trigger from the menu-bar icon: ⌥, ⌃, ⌘, ⇧ or Fn — and for the two-sided keys, left, right or either.
Languages
Lispr transcribes via Whisper, which is multilingual. The language is detected automatically — you can even switch mid-sentence and it follows. About 99 languages are recognised, no setup required.
Smart sentence joining
If you dictate one phrase, then dictate again right after, Lispr inserts a period and a space between them — no run-on sentences. It only auto-joins after its own previous insertion, so it doesn't touch text you typed yourself.
Clipboard
Lispr uses the clipboard internally to insert text — but it restores whatever you had copied immediately afterwards. Your ⌘V still gives back the link or paragraph you copied an hour ago.
Updates
Lispr auto-updates via Sparkle — when a new release is signed, your installed Lispr offers it the next time the app launches. See the changelog for what changed in each version.
Troubleshooting
The trigger key doesn't do anything
- Check that Accessibility is granted (step 2 above) — without it Lispr can't see the key press or type into other apps.
- Make sure no other app is grabbing right ⌥ — Karabiner, BetterTouchTool, Raycast hotkeys, Magnet etc. If so, switch Lispr to Fn from the menu-bar icon.
"We didn't catch that"
Lispr filters very short and silent recordings (since 0.39), so an accidental tap doesn't turn into random text. If you get this and you did speak: hold the key a moment longer before talking, and check that the right microphone is picked in the menu.
Text ends up in the wrong app
Lispr inserts at whatever cursor is focused when you release the trigger key. If you switched apps mid-recording, the text goes to the new app. Tip: keep your cursor in the destination before holding the key.
The menu-bar icon is missing
- On macOS 11–12 specifically, an earlier build (≤ 0.24) could lose the icon — update to the latest from the changelog page; this was fixed in 0.25.
- If you're on a recent macOS and still don't see it: your menu bar might be full and the icon is hidden under Control Center / Bartender. Try widening the menu bar by hiding a few icons.
Transcription timeout
If your network blips mid-upload, Lispr gives up after about 20 seconds without a word from the server and tells you, instead of spinning forever. Try again — the next attempt goes out on a fresh connection and usually succeeds.
Sparkle can't fetch the update
The DMG and appcast are served from proxy.lispr.ai over a TCP-only path (since 0.39) — this bypasses HTTP/3 issues some networks have. If your network still blocks it, you can always download the latest DMG directly from lispr.ai and replace the app manually.
Very long recordings
Lispr auto-stops a single recording after two hours. Nothing is thrown away: it finishes like a normal key release and transcribes what you said.
Privacy quick reference
The full story is on the Privacy Policy; here's the short version most people are asking about.
Where does my voice go?
From your Mac it goes over an encrypted connection to an edge proxy we run, which forwards it to Groq for transcription. Groq returns the text, the proxy returns it to your Mac, and the audio is discarded immediately. By default no recording is kept on a server and none of it trains a model — the exceptions are the two sharing settings in the app, both off until you switch them on.
Is there an account?
Not required. You can download Lispr and dictate without signing up for anything. There is an optional account for paid plans — you sign in with a one-time email code, and there's still no password or profile.
What about logs?
Lispr sends diagnostic X-Lispr-* headers with each transcription request — timings, error codes and a random per-install id, never audio or transcripts. We keep the resulting counters to see what breaks, and you can switch the whole thing off in the menu.
Does it work offline?
No — transcription runs in the cloud, which is why it's both fast (about 0.35 s median from key release to text at your cursor) and accurate. If you need fully-local dictation, macOS's built-in Dictation is a fine alternative; that's the trade-off we made.
Still stuck?
If something here didn't answer your question — write to us with the version (menu bar → About Lispr) and what you were doing when it broke. We'll dig in.
[email protected]