User guide · Mac and iPhone
How to use Talklucent
Talklucent turns what you say into text where your cursor is. This guide walks you through setting up the Mac app and the iPhone app and keyboard, then everything you can do with them.
Mac
Install and open Talklucent
Talklucent lives in the menu bar. It has no Dock icon.
- You need macOS 14 or later.
- On a Mac with Apple Silicon, Talklucent uses the Whisper speech model on your Mac. It downloads once, about 632 MB.
- On an Intel Mac, Talklucent uses Apple's on-device speech recognition, which is made for English. Speaking other languages needs Apple Silicon.
- Put Talklucent in your Applications folder and open it.
- The first time it opens, the Set up Talklucent window appears. The next section walks through it.
- Look for the Talklucent icon in the menu bar. Click it for the menu: Open Talklucent…, Setup…, Paste automatically, Clean up with Claude, Sign in for cleanup… (or this week's words, once you're signed in) and Quit Talklucent.
On a full menu bar, the icon can hide behind the notch. Talklucent still works. To get to its window, open Talklucent again from the Applications folder in Finder while it is running.
The Setup window
Four steps, once. Each one turns into a green check when it is done.
- Microphone. Click Allow… and accept the prompt. Talklucent hears you only while you are dictating.
- Accessibility. Click Open System Settings… and switch Talklucent on. This lets Talklucent notice the talk key and paste text into the app you are using. Talklucent picks up the switch without a restart.
- Sign in (optional). Cleanup takes out the "um"s and fixes punctuation, and translation turns what you say in one language into text in another. Both run on Talklucent, which uses Claude. Type your email, click Email me a code, then type the 6-digit code and click Sign in. No password. Or click Skip to dictate without cleanup.
- Speech model. On Apple Silicon, Whisper downloads (you see the progress), then gets prepared for your Mac. The first time takes a few minutes. After that it loads in seconds.
When the step list is done, the window says: put your cursor in any text box, press your talk key, talk, press it again. Click Done. If you click Finish later, open the window again any time with Setup… in the menu.
On an Intel Mac, macOS also asks to allow Speech Recognition for Talklucent. If Talklucent reports that there is no on-device English speech model, turn on Dictation once in System Settings › Keyboard.
Talk keys
Each talk key has its own languages. You pick the language with the key you press.
| Key | To start with | What you can set |
|---|---|---|
| Right Option ⌥ | English | Any language you speak, and any language to write in. |
| Right Command ⌘ | Off | A second pair, for example Spanish → English. |
| Right Shift ⇧ | Off | A third pair, for example English → Japanese. |
Tap to start, tap to stop
Tap the talk key once to start. Talk as long as you like, then tap it again to stop. If you prefer push-to-talk, hold the key down while you talk and let go when you finish.
Right Shift waits a moment
Shift goes down for every capital letter, so Right Shift only counts as a talk key after you hold it alone for 0.2 seconds, or tap it on its own. Typing capitals never opens the mic.
Change your keys
Open the Talklucent window and go to Settings › Talk keys. Switch a key on, then pick what you Speak and what to Write: the same language for clean dictation, or a different one to translate. Switch a key off to free it.
Translation always uses Claude, so a key that writes in another language needs you signed in, even when cleanup is off.
Dictate
Works in any app where you can type.
- Click where you want the text to go.
- Tap your talk key. You hear a short sound, and a pill at the bottom of the screen shows Listening…. A red dot in the pill moves with your voice.
- Talk.
- Tap the key again (or let go, if you held it). The pill shows Transcribing…, then Cleaning up… or Translating….
- The text is pasted at your cursor, and the pill shows Pasted · also on clipboard.
The text is always on your clipboard
Every dictation goes on your clipboard too, so ⌘V pastes it again. If you switch off Paste into the app I'm using in Settings, Talklucent only copies, and the pill says Copied · ⌘V to paste.
Cancel
While you hold the talk key, press any other key. The recording is dropped and nothing is typed. A shortcut that uses your talk key, like Right Option plus a letter, is dropped the same way.
Limits
- A recording stops on its own after 10 minutes.
- A recording belongs to the key that started it. The other talk keys do nothing until it ends.
Home, History and Settings
One window with three sections. Open it from the menu with Open Talklucent…, or open Talklucent again from Finder while it is running.
Home
Your words today, this week and all time, your speaking speed, time saved compared with typing, and your day streak. Below that, a chart of words per day for the last 14 days (hover a bar for the exact count) and the apps you dictate into most.
History
- Every dictation, newest first. Search with Search what you said.
- Copy puts a dictation back on your clipboard.
- When cleanup changed your words, open What you said, before cleanup to see the original.
- A dictation that failed shows Needs attention. See When something goes wrong.
Settings
- Talk keys: a key for each mode.
- Output: Paste into the app I'm using.
- Account: sign in with an emailed code, see this week's words, Sign out or Delete account….
- Cleanup: Clean up with Claude on or off.
- System: Open Talklucent at login, the Microphone and Accessibility status, and which speech model your Mac uses.
- Words to spell exactly: your word list.
Your word list
Names, brands and jargon that Talklucent should always spell your way.
- Open Settings › Words to spell exactly.
- Type one word or name per line. Lines that start with # are ignored.
- Click Save words.
When you're signed in, cleanup uses the list to fix spellings. When you're not, the list goes to the speech model instead.
When something goes wrong
Talklucent saves every dictation before it pastes, so your words are never lost.
- Transcription failed. Talklucent keeps the recording. In History, click Retry on that dictation. The new text goes to History and your clipboard.
- Cleanup or translation failed. You get the transcript as heard instead, and History keeps a note of what failed.
- The menu shows Blocked: grant Accessibility or Blocked: grant Microphone. Use Grant Accessibility… or Grant Microphone… in the menu, or the Allow… buttons in Settings › System.
- Nothing was pasted. Press ⌘V. The text is on your clipboard.
iPhone
Install and first launch
The iPhone app is in testing on TestFlight. It needs iOS 18 or later.
- Install Talklucent from your TestFlight invitation and open it.
- The Talk tab shows a setup list with three steps: Speech model, Sign in and Talklucent keyboard. Each one shows Done when Talklucent sees it finished, and the list goes away when all three are done.
- The speech model downloads first, about 630 MB. Use Wi-Fi.
- Then it shows Preparing for this iPhone with the time left. This takes a few minutes. Keep Talklucent open: leaving the app pauses it.
The Preparing wait happens again after every app update. Normal launches take seconds.
Add the Talklucent keyboard
You dictate through the keyboard, in any app.
- Open the iPhone Settings app and go to General › Keyboard › Keyboards › Add New Keyboard, then pick Talklucent.
- Tap Talklucent in the list and turn on Allow Full Access. The keyboard needs it to talk to the app. Without it, the keyboard shows Turn on Full Access.
- In any app, tap a text field and switch to the Talklucent keyboard with the globe key.
The Talklucent keyboard step in the app shows Done after you use the keyboard once and come back to the app.
Besides the mic button, the keyboard has the globe key, the pen, @, space, delete and return.
Dictate with the mic button
One button: Tap to talk.
Why the app opens
iPhone keyboards can't use the microphone. The Talklucent app holds the mic for the keyboard while you type in other apps, and the orange mic dot stays on while it does. So when the mic is off, your first tap on the keyboard opens Talklucent for a second, already listening.
- Tap Tap to talk on the keyboard. Talklucent opens and shows Listening.
- Go back to your app with ◀ in the top-left corner and keep talking.
- On the keyboard, a wave moves with your voice. Tap anywhere on it (Tap to finish) when you are done.
- Your words go where your cursor is.
To drop a dictation, tap cancel while it is listening.
The mic stays on
After the first dictation, the mic stays on, and the keyboard starts listening right away without opening the app. The keyboard shows when the mic turns off. Choose how long it stays on in Settings › Mic stays on: 5 minutes, 15 minutes (the default), 1 hour, or Until I end it. Each dictation restarts the clock. To turn it off yourself, open Talklucent and tap Turn mic off on the Talk tab.
A dictation that finishes more than two minutes before you get back to a text field is not typed in. It stays in History, ready to copy. If Talklucent didn't hear anything, check which mic is on, your AirPods or your iPhone.
The language chip
English is always on. Other languages are optional.
- In the Talklucent app, open Settings › Languages, pick what you Speak and what to Write, and tap Add. Add as many as you like; swipe left to remove one.
- On the keyboard, the chip at the top right shows the mic's language, for example EN, ES or ES → EN.
- Tap the chip to move to the next language, then tap the mic.
Translation uses Claude, so a language that writes in another language needs you signed in.
Edit by voice with the pen
Rewrite text you already have by saying how to change it.
- Select the text you want to change. The pen key lights up.
- Tap the pen.
- Say how to change it, like "make it friendlier" or "shorter".
- Tap to finish. The new text replaces your selection and is copied to your clipboard.
If the selection is lost on the way, nothing is typed: select the original and paste. If the edit fails, nothing changes. The pen needs you signed in.
Settings and History
The app has three tabs: Talk, History and Settings.
Settings
- Account: tap Sign in with Apple, or type your email, tap Email me a code and type the 6-digit code. Once you're in, you see this week's words, Sign out and Delete account.
- Talklucent Pro: the plans, Restore Purchases, and Manage subscription once you subscribe. See Free and Pro.
- Your name (optional): cleanup keeps your words in your voice. Without a name it says "the speaker".
- Clean up English: on or off. Without cleanup you get your words exactly as heard, fillers included.
- Mic stays on: how long the mic stays on after your last dictation.
- Languages: the translations the language chip can switch to.
- Word list: one name or term per line, spelled exactly like this in every dictation. Tap Save word list.
- Version and Log.
History
Words today, this week and minutes saved at the top, then every dictation on your iPhone, newest first, with search. Tap a dictation to copy it.
Both
Free and Pro
The same plans on the Mac and the iPhone.
- Speech turns into text on your device with no account and no limit.
- Signed in, cleanup, translation and voice edits are free for 2,000 words a week. When you run out, Talklucent tells you the day and time they come back.
- Talklucent Pro raises that to 50,000 words a week (fair use). It's $9.99 a month or $79.99 a year, and your first subscription starts with 2 weeks free.
- iPhone: Settings › Talklucent Pro. Apple bills your Apple ID. Manage or cancel in iPhone Settings › your name › Subscriptions.
- Mac: Settings › Account › Pro Monthly or Pro Yearly opens checkout in your browser. Manage subscription changes your plan or card, or cancels.
- One subscription covers both apps when you sign in with the same account.
What stays on your device
The same rules on the Mac and the iPhone.
- Speech becomes text on your device. Your audio is never uploaded.
- Cleanup, translation and the pen send text only. They send the transcript (and, for the pen, the selected text) to Talklucent, which passes it to Claude and keeps only a count of the words. When you dictate in English with cleanup off, or when you're not signed in, nothing you say leaves your device.
- History stays on your device. Every dictation is saved on your Mac or iPhone. Talklucent does not upload it.
- The log records timings and steps, never what you said.
- Your sign-in stays in your device's Keychain. Talklucent keeps your email, your weekly word counts and, if you subscribe, the store's record of your subscription. Delete account in Settings deletes them. It doesn't cancel a subscription, so cancel that first.