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.
  1. Put Talklucent in your Applications folder and open it.
  2. The first time it opens, the Set up Talklucent window appears. The next section walks through it.
  3. 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.

  1. Microphone. Click Allow… and accept the prompt. Talklucent hears you only while you are dictating.
  2. 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.
  3. 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.
  4. 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.

KeyTo start withWhat you can set
Right Option ⌥EnglishAny language you speak, and any language to write in.
Right Command ⌘OffA second pair, for example Spanish → English.
Right Shift ⇧OffA 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.

  1. Click where you want the text to go.
  2. 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.
  3. Talk.
  4. Tap the key again (or let go, if you held it). The pill shows Transcribing…, then Cleaning up… or Translating….
  5. 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.

  1. Open Settings › Words to spell exactly.
  2. Type one word or name per line. Lines that start with # are ignored.
  3. 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.

  1. Install Talklucent from your TestFlight invitation and open it.
  2. 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.
  3. The speech model downloads first, about 630 MB. Use Wi-Fi.
  4. 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.

  1. Open the iPhone Settings app and go to General › Keyboard › Keyboards › Add New Keyboard, then pick Talklucent.
  2. 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.
  3. 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.

  1. Tap Tap to talk on the keyboard. Talklucent opens and shows Listening.
  2. Go back to your app with ◀ in the top-left corner and keep talking.
  3. On the keyboard, a wave moves with your voice. Tap anywhere on it (Tap to finish) when you are done.
  4. 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.

  1. 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.
  2. On the keyboard, the chip at the top right shows the mic's language, for example EN, ES or ES → EN.
  3. 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.

  1. Select the text you want to change. The pen key lights up.
  2. Tap the pen.
  3. Say how to change it, like "make it friendlier" or "shorter".
  4. 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.