You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Added
Calendar, a new page in the sidebar. Click Connect Calendar to allow access, and it shows the calendars already on this Mac, such as iCloud, Google and Exchange, by Day, Week or Month, like the Calendar app. Week is the default. Day and Week lay out the hours with all-day events on top and a line at the current time, and Month shows up to three events a day. Use the arrows or ⌘← and ⌘→ to move, Today or ⌘T to come back, and click a day to open it. Click an event to see its time, calendar and invitees. A meeting with a video link has Join, and one that starts within 15 minutes or is under way has Take notes, which starts meeting notes with that event's title and invitees. The page says how many calendars it reads and from which accounts, and Choose calendars opens Settings to leave some out. Add Account…, on the page and in Settings > Calendar, opens Internet Accounts in System Settings, where you sign in to Google, Outlook, Exchange, Yahoo or iCloud with your email; the calendars appear once this Mac syncs them. For Outlook, choose Microsoft Exchange. BetterWispr never sees your password. It updates when your calendars change. If access is off, the page says so and opens System Settings; if this Mac has no calendar accounts, it offers Add Account…. BetterWispr only reads calendars and never changes them, and declined events aren't shown.
Hold only, a third shortcut behavior in Settings > Shortcut. Dictation runs only while you hold the shortcut and finishes when you let go. A quick tap no longer starts hands-free dictation: it ends the dictation without transcribing or pasting anything and shows "Keep holding" with the shortcut. Hold or tap stays the default and works as before, and saved settings keep their behavior.
Capsule position, in Settings > App under Floating recording capsule. The capsule can sit at the bottom center, bottom left or bottom right of the screen. Bottom center is the default. A meeting prompt set to appear at the top still appears at the top center. Right-click the capsule's controls to move it or hide it.
Hide the capsule while you're not dictating by turning off Floating recording capsule in Settings > App, or by right-clicking the capsule and choosing Hide capsule. Hiding it from the capsule shows a toast that says where to turn it back on and offers Undo.
Dictate and format, a second shortcut in Settings > Shortcut that is fn ⌃ (hold fn and Control together) by default, the key pair other dictation apps use for their second mode. Like fn alone, it needs Accessibility. Record another shortcut there, or click Reset to go back to fn ⌃. If your dictation shortcut is fn alone, press ⌃ before fn. It works like your dictation shortcut and follows the same hold or toggle behavior. It sends the English dictation to the cleanup provider chosen in Style, which must be Claude Code, Codex, an API connection or Ollama (Apple Intelligence and the built-in model aren't used for it; until you choose one, fn ⌃ shows an error that opens Style), shaped for the app you are in:
email gets a greeting and paragraphs, with a sign-off only when you say one or usually write one
work chat is short, with code and identifiers in backticks
personal chat stays relaxed
AI prompts stay literal and plain
documents get paragraphs and lists
other apps get the usual cleanup, with a notice that the app has no layout yet
Start with a request such as "write an email to Sam saying …" or "… with this content …" and the rest is written as that email, without the request words. The request can also follow a few words, as in "okay so please write an email to Sam …", and questions you ask in the email body are kept. In Notes, TextEdit, a browser page or an app with no layout, a spoken email request is laid out as an email too. If the provider's edit can't be used, a simple greeting and body are laid out on this Mac instead. Gmail, Outlook on the web, Proton Mail, Fastmail, Yahoo Mail, Slack, Teams, Google Chat, WhatsApp Web, ChatGPT and Claude in a browser count as their kind of app. No facts are added that you didn't say. If the provider isn't ready or you spoke another language, the dictation gets the usual cleanup and a notice says why. While Save dictation history is on, your edits of a formatted dictation are kept on this Mac, at most 8 per kind of app. A few of them guide later formatting there as style references, not content. Settings shows how many are kept and can forget them. Your normal dictation shortcut is unchanged.
Cohere Transcribe, an on-device speech model in Models for English, French, German, Spanish, Italian, Portuguese, Dutch, Polish, Greek, Arabic, Japanese, Chinese, Vietnamese and Korean, with punctuation. It is a 2.2 GB download that runs on the Neural Engine and needs macOS 15 or later, so it isn't listed on macOS 14. It can't detect the spoken language: choose it in Settings > Spoken language, where the automatic choice reads System language and uses the first of your Mac's preferred languages it supports, or English. Vocabulary isn't used as a hint. The first transcription after the model loads can take about a minute while macOS prepares it, which BetterWispr does in the background after loading. Requested in #36.
Dictation languages now works with Parakeet. Under Settings > Microphone and language, with Spoken language on Detect automatically, check the languages you speak in the list that opens. When they all use one alphabet, Parakeet never writes letters from another, so English and Portuguese no longer turn into Cyrillic words. Choosing languages with different alphabets, or All languages, keeps every alphabet as before. Parakeet TDT v3 and Parakeet Ultra filter this way; the other Parakeet models ignore the list. Words from another language written in the same alphabet, such as Polish, can still appear. The --languages option of the command-line tool applies to Parakeet too.
Add interface languages through native translation folders, with a contributor tool to prepare templates, check resources and package the declared languages.
French interface, app status messages and permission descriptions follow the macOS app language, with English as the fallback. Native plural rules and localized keyboard labels preserve model identifiers, saved data, prompts and user-provided names.
Summary language for meeting notes, under Models > Meeting notes and in the Notetaker settings menu. Same as meeting is the default: notes are written in the Spoken language set when the meeting was recorded, or, with automatic detection, in the language spoken most in the transcript. Before, notes were usually written in English. Choose a language to always write notes in it, with every notes provider. If Apple Intelligence can't write in that language on this Mac, Models and the meeting's Generate summary card say so, and no summary is written until you pick another language or notes model. Ask answers are unchanged.
Write numbers as digits, in Settings > After you speak and on by default. Every spoken number becomes digits, in the pasted text and in Parakeet's live preview, with any speech model, in English and in every other language written with spaces between words: "two cats" is typed as "2 cats", "quatro mil quinhentos e sessenta e sete" as "4567" and "doscientos cincuenta mil" as "250000". Numbers spoken one after another join when there are three or more, when they sound like a year, or after "number", "PR", "issue" or "ticket", so "PR número quatro cinco seis sete" becomes "PR número 4567", "call five five five" "call 555" and "nineteen ninety nine" "1999"; a later number of 100 or more starts a new one. Two other numbers in a row stay as words, so a time such as "eleven thirty" or "son las dos treinta" and "fifty fifty" are kept as spoken. Outside English no thousands separator is added. A decimal or grouping mark is written only where it is said between numbers, so "três vírgula cinco" becomes "3,5" and "zero ponto um ponto seis" "0.1.6". "One", "um", "une" or "ein" on its own stays a word, since it is usually an article or pronoun, unless it follows "number", "PR", "issue" or "ticket", and "thousand" or "mil" on its own stays a word too. Number words for languages other than English come from macOS, and the language comes from Settings or, on Auto, from the text. In English this replaces keeping small numbers as words, so "one or two" is typed as "one or 2"; English amounts keep their separators, such as "250,000", except after "number", "PR", "issue" or "ticket". Turn it off to keep every number as spoken words. Medium cleanup may still write numbers as digits.
Mute your microphone during a meeting note. Click the microphone button in the meeting toolbar to mute it, and click again to unmute; the arrow next to it still chooses the microphone. While muted, the button turns red and only other apps' audio (Them) is recorded and transcribed. What you said just before muting is still transcribed. Each new meeting starts unmuted.
Send keys, in Settings > Send keys and empty by default. Add an app and record the key that submits in it, and BetterWispr presses that key after pasting a dictation there, so dictating into a chat or agent client that Send to Claude cannot recognize still submits hands-free. A bare Return, Tab or ⌘Return all work. The recorder refuses ⌘Q, ⌘W and Delete or Forward Delete, with or without other modifiers, saying why, and refuses your dictation shortcut, which would clash with the send. A modifier on its own is refused because it submits nothing, and Esc leaves the recorded key as it is rather than being recorded. Terminal and iTerm2 aren't offered, because a key there could run a shell command; Send to Claude still covers Claude Code in them. Each app has its own switch, so a rule can be turned off without losing its key, and a rule for an app that is no longer installed says so instead of disappearing. The capsule shows ↵ for Return, or a keyboard glyph for anything else, and its tooltip names the key. Unlike Send to Claude, a send key fires wherever the cursor is in the app rather than only in a field BetterWispr recognizes, so pick a key that cannot do damage in the app's other fields; hold Shift as you dictate to paste only. The wait before sending, Don't send, "Pasted, not sent" and taking over a pending send by dictating again all work the same as for Send to Claude. Needs Accessibility. Contributed by Mike Lyons (frenchie4111).
Allow any Claude Code sign-in for meeting notes, under Models > Meeting notes when Claude Code is the notes provider, off by default. Claude Code normally needs a Claude subscription sign-in. With this on, meeting notes also work when it is set up with an API key, a cloud provider, or a gateway or proxy. Models shows where Claude Code says it will send meeting text, including a custom base URL in its settings files, and nothing is sent until you confirm that destination. If the destination changes, BetterWispr asks again before sending. Each request is capped at an estimated $1, and the summary names the model and destination that wrote it. Ask, Medium cleanup, screen and clipboard context and correction review don't use this switch: they still need a Claude subscription, and Medium keeps Light cleanup otherwise. Without it, a Claude Code that is signed in another way says so and points to this switch.
Mute other apps while dictating, in Settings > App and on by default on macOS 14.2 and later. It silences browsers, Spotify and every other app while the microphone is recording, so a video in Safari or Chrome or a song in Spotify goes quiet while you speak and is heard again when you stop. Other apps are muted rather than paused, so videos keep playing silently. BetterWispr’s own sounds still play, and your volume and mute settings are not changed. Nothing is muted while meeting notes record, or when a browser or a known call app such as Zoom, Teams or FaceTime is using the microphone as the recording starts. A call in any other app goes silent while you speak. If muting fails, a message says so and the dictation carries on. Whether other apps come back on their own if BetterWispr crashes during a dictation hasn't been tested. The first dictation that mutes asks for System Audio Recording, and nothing goes silent until you allow it. If you turned the setting off, turning it back on asks right away. A workspace saved before this change has Pause music while dictating and Mute other apps while dictating turned on once, since both used to be off by default; turn either off in Settings > App and it stays off. Pause music while dictating is a separate setting and works as before.
English Medium cleanup infers bullet lists and numbered steps from the meaning of the transcript, without requiring “list”, “shopping list”, ordinals or bullet commands. Natural repetitions and mixed transitions can form a list of three or more items, or two when you number them; connected narratives and comparisons remain prose, and "new line" and "new paragraph" still break the text. Uses the selected cleanup model, including Apple's on-device model, with a second call only when a dictation looks like a list. Selected-text cleanup never forms a list. Light cleanup keeps its filler and stutter removal without guessing list structure.
Quitting BetterWispr in the middle of a dictation keeps it. A dictation that is still recording or transcribing is saved to Failed Dictations, and History lists it under Not transcribed after the next launch. Before, quitting deleted it.
Keep a dictation that couldn't be transcribed. When the speech model or an API connection fails, BetterWispr keeps the recording instead of deleting it, and Try again on the error card transcribes that same recording with the speech model selected now, rather than starting a new dictation. The audio is also copied to ~/Library/Application Support/BetterWispr/Failed Dictations, readable only by your macOS user, so it survives closing the card and quitting. History lists these under Not transcribed, where Transcribe opens one on the Transcribe page, the folder button shows it in Finder and the trash button deletes it. A recording is deleted once it is transcribed, after 7 days or a shorter Keep history age limit, or when more than 20 are kept or they pass 1 GB in total. The oldest go first, and the recording that just failed is always kept, even if it is larger than 1 GB on its own. The folder is left out of backups. Cancelled dictations and ones with no speech are not kept, nothing is copied to disk while Save dictation history is off, and turning it off deletes what is kept. When the selected speech model is an API connection or Codex, the button reads Send to and names where the audio goes, and a failing local model never falls back to one.
Keep history, in Settings > App under Save dictation history. Choose Forever, the latest 100 dictations, 3 days, 2 weeks or 3 months. Older dictations are deleted from this Mac when BetterWispr opens and after each dictation, and a toast at launch says how many went. A choice that would delete dictations asks first, says how many and warns that usage totals and Insights will shrink, since they count saved dictations. It is Forever by default, so nothing is deleted until you choose. While Save dictation history is off, Keep history deletes nothing. If the Mac's date moves ahead by more than a day since BetterWispr last checked it, age limits wait until the new date has held for a day, so a clock set ahead by mistake doesn't delete dictations. A clock left wrong for longer than that is treated as correct.
Add a space after pasting, in Settings > After you speak and off by default. Each pasted dictation ends with a space, so the next one doesn't run into it. It is skipped when the text ends in Chinese or Japanese, or already ends in a space or line break, and History keeps the text without it. A dictation that joins one waiting to be sent to Claude uses that space instead of adding its own.
Sound volume, in Settings > App under Dictation sounds. A slider sets how loud the start, finish, cancel and needs-attention sounds play, and plays the start sound when you let go. It starts at the level the sounds always used.
Notify when a word is learned, in Settings under Learn from my corrections and on by default. Turn it off to stop the "Learned …" toast after you fix a dictation. Corrections are still added to Vocabulary, where entries marked Learned can be reviewed and removed. Without the toast there is no Undo button.
Send to Claude, in Settings > After you speak and off by default. After pasting, BetterWispr presses Return when the cursor is in Claude Desktop's message box, the Claude Code panel in VS Code, or a Terminal or iTerm2 tab where Claude Code is running, so a dictated prompt is submitted hands-free. Anywhere else, such as a shell or a file, the text is only pasted. A tab counts only while a Claude Code process is in front in it: Terminal and iTerm2 are asked which tab is focused once you allow it. VS Code terminals and Ghostty paste without sending because a stale title cannot prove which process receives Return. Return also answers a question Claude Code is asking, such as a permission prompt. The capsule shows ↵ when a dictation will be sent. Hold Shift as you finish, or start with Shift and your shortcut, to paste only. After pasting, the capsule counts down for a second: dictate again to add more, and the next dictation is pasted after the first and sends both, or press Escape or click Don't send. Wait before sending changes the countdown, from 120 ms to two seconds. Return is skipped, with "Pasted, not sent", when you switched apps or fields. In VS Code this turns on its accessibility support, which may ask once whether to optimize the editor for a screen reader; No is fine.
Tell me when no speech is heard, in Settings > App and on by default. Turn it off, and a dictation that ends without words closes quietly instead of showing "No speech heard." with a sound. The card still appears when an earlier dictation was waiting for this one to send it, since that dictation stays pasted but not sent.
Codex · Subscription under Models > Subscription transcription. Explicit selection sends audio directly to an unofficial ChatGPT endpoint using your local Codex sign-in. No separate transcription server or helper is required. BetterWispr does not store or refresh credentials. Local defaults and notes providers stay independent. See setup. The developer CLI accepts --model codex for batch transcription.
Transcribe audio and video files and web links from the new Transcribe page in the dashboard. Drop or choose an MP3, M4A, AAC, WAV, AIFF, CAF, FLAC, MP4, MOV or M4V file, or paste a link such as a YouTube video. BetterWispr transcribes it on this Mac with the model you pick on the page, or with an API connection only if you pick one. Links download with yt-dlp, a free open-source downloader. Nothing downloads until you click Install yt-dlp, and BetterWispr checks it against its published checksum first. YouTube links work best with Deno installed (brew install deno). Long recordings are cut at the quietest moment every 30 to 60 seconds. On three TED videos, cutting this way got 1,233 words wrong out of 12,592, against 1,282 when sending the whole file at once and 1,335 when cutting it like meeting audio. Transcripts keep their timestamps, can be copied or exported as plain text or Markdown, and label Speaker 1, Speaker 2 when Speaker detection is installed. BetterWisprCLI --media PATH|URL does the same from the command line, and --download-yt-dlp installs yt-dlp.
A built-in notes model that runs on this Mac. Download Qwen3.5 2B (1.28 GB) under Meeting notes in Models, and it writes meeting notes, edits Medium dictation and answers Ask without Apple Intelligence, Ollama, a CLI or an API key. It supports macOS 14. It uses about 1.5 GB of memory while it works, most of it the model file read from disk, and frees it after five idle minutes. BetterWispr uses it only when you choose it, and it never downloads on its own. A finished download makes it your notes provider unless you picked another one meanwhile. A 2B model can repeat points or give a task to the wrong person, so check its notes. BetterWisprCLI --download-builtin-model installs it, and --notes-model builtin uses it with --meeting and --bench.
Ask questions about one meeting from its Ask tab, or about all your meetings from the Notetaker page. Answers cite the transcript lines they came from, and clicking a citation opens the meeting at that line. Ask sends your question and the meeting lines that best match it to the notes provider you pick for Ask, or to the one that writes your summaries when you keep Same as notes. A meeting that is still being processed can be asked about from its transcript so far.
Ask keeps your questions and answers. A meeting's Ask tab shows the ones about that meeting, and the Notetaker page shows the ones about all your meetings, after you quit and reopen BetterWispr. Each answer names the model that wrote it. Clear removes them from this Mac after you confirm. Deleting a meeting also removes the answers about all meetings that cite it. A question that fails or is cancelled isn't kept.
What did I miss? in the Ask tab of a meeting that is recording. It answers from the last five minutes of the transcript, with citations, and leaves out My thoughts.
Filters for Ask on the Notetaker page. Ask about meetings from today, the past 7 days or the past 30 days, and about meetings with one Calendar invitee.
Provider presets for a new notes API connection in Models. Pick OpenAI, Anthropic, Google Gemini or OpenRouter to fill in its address and a fast model, then add your API key. Anthropic says its OpenAI-compatible API is not a long-term or production-ready solution.
Calendar for meeting notes, in Settings > Calendar and off by default. Turning it on asks macOS for Calendar access. A note started during an event, or up to five minutes before it, takes the event's title and lists the people invited under its date. BetterWispr reads the calendars already in the Calendar app on this Mac, from every account including shared and subscribed calendars, so it works offline and needs no sign-in. Each calendar has its own switch, and calendars added later are included. Declined and cancelled events are skipped. When events overlap, the one with a Zoom, Google Meet, Microsoft Teams or Webex link wins. The event title and invitees go to your notes model with the transcript. Invitee names also help the speech model recognize them.
Connected apps, in Settings and off by default. Turn on Share meetings with AI apps, and Claude Desktop, Claude Code, Cursor and other apps that support MCP can list and search your meetings and read their summaries, action items, your notes and transcripts with speaker names and timestamps. Settings shows the line to run for Claude Code, the snippet to paste for Claude Desktop and Cursor, and the command for other apps, each with a Copy button. Connected apps can only read, never change or delete anything. BetterWispr checks the setting on every request, so turning it off stops sharing right away without restarting the other app. BetterWispr itself sends nothing over the network, but an app you connect sends what it reads to its AI provider. Long meetings arrive in parts, and files from the Transcribe page are not shared.
Correct the speakers after a meeting. Click the speaker name on any line to give it to another speaker or a new one, or to move one of your lines back to Me. Use the menu beside a speaker's name field to merge that speaker into another. A merged speaker keeps its target's name, or takes the other name when the target has none. A merge can't be undone, but you can move lines back one at a time. The speaker menus appear once the meeting has finished processing.
A meeting recorded without Speaker detection offers to download it. The download applies from the next meeting, and you can dismiss the offer for good.
Setup offers Speaker detection below the speech model. It is optional, and nothing downloads until you click Download. If you click it while the speech model is still downloading, Speaker detection starts once the speech model is ready.
Name a speaker after someone invited to the meeting. When Calendar added the meeting's invitees, the button beside each speaker's name field lists the invitees no speaker has been named after yet. Pick one to fill in the name.
Tell apart people in the room, in Models > Meeting speakers and off by default. With Speaker detection installed, it also separates the voices on your microphone, so people sitting with you get their own speaker numbers next to the people on the call. The voice heard longest on your microphone stays Me, not counting the call's sound picked up from your speakers. If the wrong voice ends up as Me, click the speaker name on a line to move it. Your microphone audio stays on this Mac until the speakers are found, then BetterWispr deletes it. How well it separates people in a room has not been measured.
Speaker labels during a call. With Speaker detection installed, the lines from the other side of a call show Speaker 1, Speaker 2 and so on while the meeting records, a moment after each line appears, where before they stayed Them until the meeting ended. BetterWispr listens again to the last five minutes of call audio on this Mac after each new line, using the Speaker detection models already downloaded, so nothing new downloads. The labels are a first guess: a line's speaker can change while the meeting records, one person can briefly show as two speakers, and someone who was silent for more than five minutes can come back under a new number. The pass after the meeting replaces them and keeps each number with the voice that mostly had it. Your microphone lines stay Me during the call, and without Speaker detection nothing changes. Measured only on synthetic conversations spoken by macOS say voices, not on real calls: over seven two-minute conversations with one to four voices, 48% to 80% of line time had the right speaker when first shown and 92% to 100% when the call ended, and three of the seven showed one speaker more than there were. Over two ten-minute conversations with three voices, one had 65% right when first shown and 94% at the end, and the other 54% and 63%, where the pass after the meeting also merged two of the voices. Each listen took about 0.9 seconds on an Apple M4 Pro with five minutes of audio. How much it slows transcription during a real call has not been measured.
My voice, in Models > Meeting speakers. Click Record My Voice and talk for 30 seconds, and BetterWispr saves a profile of your voice and deletes the recording. When Tell apart people in the room is on, the microphone voice closest to your profile stays Me, even if someone beside you talks more. Without a profile, or when no voice in the meeting is close enough to it, the voice heard longest stays Me as before. A sample with less than 20 seconds of speech is refused, because a shorter one gave a profile that matched nothing. The profile is stored with remembered voices in Voices.json, readable only by your macOS user, is never uploaded, and Time Machine backs it up. Remove deletes it, and Forget Voices deletes it too. Measured only with macOS say voices: with one of three voices on the microphone recorded as My voice, 92% to 100% of microphone time was rightly marked Me or not across six choices of voice. A synthetic voice sounds the same in every recording, so real voices will match less often, and that has not been measured. A remembered voice can't be marked as Me yet.
Remember named voices, in Models > Meeting speakers and off by default. When it is on and you name a speaker, BetterWispr saves a profile of that voice with the name. In later meetings, when a speaker's voice is close enough to a saved profile, the speaker's name menu offers "Sounds like" with that name as its first choice. No name is filled in until you pick one, so the transcript and the notes show only names you chose. If you give that speaker a different name and then press Return, click away from the name field or pick an invitee from the menu, BetterWispr deletes the profile that made the suggestion. A name you type and erase deletes nothing. Close enough means within the cutoff SpeakerKit uses to group one person's speech inside a single meeting. That cutoff was not tuned for matching across meetings, and how often the suggestion is the right person has not been measured. A voice profile can identify a person, and privacy laws such as the GDPR and Illinois' BIPA can treat it as biometric data, so ask people before you name them. Profiles stay in ~/Library/Application Support/BetterWispr/Voices.json, readable only by your macOS user. They are never uploaded or written into meeting files, but Time Machine backs them up. Forget Voices deletes them all. Deleting a meeting deletes the profiles named in it, and the delete confirmation says so. Name speakers before you quit BetterWispr. A meeting's voices are kept only in memory, so a name given after a relaunch isn't remembered. The profiles come from the Speaker detection models. Their CC BY 4.0 license sets conditions only on sharing the models, and BetterWispr shares neither the models nor the profiles.
Press Escape to cancel a dictation from any app while it is starting, recording or transcribing. Escape also works with your shortcut's Option, Control or Shift still held, but never with Command, so Command-Option-Escape stays Force Quit. Undo still appears when audio was captured. Escape goes back to the app you're in as soon as the dictation ends. Hovering the capsule while you dictate shows "Esc to cancel".
An optional second shortcut for cancelling a dictation, in Settings > Shortcut. It is off by default and Escape keeps working. Record a combination with a key, such as ⌃⌥K or F5, and it cancels from any app while a dictation is starting, recording or transcribing, without pasting it. A modifier key alone can't be used, and neither can your dictation shortcut. The combination works as usual in other apps whenever you aren't dictating. Clear turns it off.
Clean up selected text with an optional shortcut, in Settings > Shortcut. It is off by default. Select text in any app and press the shortcut, and BetterWispr edits it like a Medium dictation with the cleanup provider from the Style page, then pastes the edit over your selection. The selected text goes to that provider, as a Medium dictation does. It needs Accessibility and at least four words of English, and it never reads a password field. If you switch apps or change the selection before the edit is ready, nothing is pasted and the edit goes to the clipboard. A toast says when the provider changes nothing or its edit is refused, and Cancel on the progress toast stops it. Starting a dictation stops it too, so the two never paste at once. A modifier key alone can't be used, and neither can Escape or your dictation or cancel shortcut. Clear turns it off.
Fn (🌐) can be the dictation shortcut on its own. In Settings, click the keyboard shortcut and press and release Fn. Like other single modifier keys it needs Accessibility, and it only starts dictation when no other modifier is held. Set "Press 🌐 key to" to "Do Nothing" in System Settings > Keyboard so macOS doesn't also show emoji or switch the input source.
Choose a cleanup provider for Medium cleanup on the Style page. It is Same as notes by default, so Medium keeps using your notes model until you pick another, such as a small Ollama model for dictation while a larger one writes meeting notes. Apple Intelligence, the built-in model, Ollama, Claude Code, Codex and API connections can be picked, and an API connection is used only when you pick it. If the provider you pick isn't ready, Medium dictations get Light cleanup.
Pause music while dictating. A new setting pauses Music and Spotify while the microphone is open for a dictation and resumes only what it paused when you stop or cancel. It is on by default and asks macOS for permission to control those apps when BetterWispr starts or when you turn it on, for each one that is open and hasn't been asked yet. Together with Mute other apps while dictating, Spotify and Music pause, and a video in your browser goes silent, while you speak.
A start sound plays when the capsule begins listening, so you know the microphone is open before you speak. It is the macOS Tink sound, and a started.wav file in ~/Library/Application Support/BetterWispr/SoundOverrides replaces it. It stays quiet when a dictation fails to start, while a meeting is being recorded, and with Dictation sounds off.
Choose each dictation sound in Settings > App. With Dictation sounds on, Start, Finish, Cancel and Needs attention each list the macOS system sounds, and picking one plays it. A sound you don't pick stays Tink, Purr, Bottle or Basso. A file in SoundOverrides still wins over the picker, and that picker says so and is greyed out. Previews stay quiet while a meeting is being recorded.
Hide capsule while dictating, in Settings > App and off by default. The capsule stays out of sight while you speak and while your words are transcribed. Errors, Undo and the copied and finished cards still appear, and the capsule comes back for the last 30 seconds before a long dictation stops. Escape and your cancel shortcut still cancel, and the menu bar icon turns into a microphone while you speak. Show words as you speak is off while the capsule is hidden.
A Cream theme, in Settings > Appearance, for a warmer page than Light's pure white. It paints the dashboard, the welcome guide and the Notetaker panel cream with slightly lighter cards, and keeps the system text colors and controls. Body text passes WCAG AA contrast. Grey secondary text is about 3.9:1, the same as in Light.
Unload speech model when idle, in Settings > Microphone and language. Choose After 5 minutes, After 15 minutes or After 1 hour to free the speech model's memory between dictations. The next dictation loads the model again from disk, so it takes a moment longer to finish. It is Never by default, the timer never runs out during a dictation, and waking or unlocking the Mac doesn't load a freed model back. The built-in notes model keeps its own five-minute unload.
Each speech model in Models lists the languages it supports by name, in your Mac's language. A model with one language shows its name, and a model with more shows a count, such as "25 languages", that opens to the full list.
Dictation languages, in Settings > Microphone and language, shows with a Whisper model and Spoken language set to Detect automatically. Pick the languages you speak, such as English and Spanish, and detection chooses the most likely of them instead of any language Whisper knows. With languages picked, the first 30 seconds of a dictation decide its language, which takes one more pass over that audio before transcribing. All languages, the default, detects as before. Other models ignore the list. BetterWisprCLI --transcribe-file PATH --languages en,es does the same.
Chinese script, in Settings > Microphone and language. Choose Simplified or Traditional to get Chinese dictation in those characters, whichever script the speech model wrote. It shows when Spoken language is Chinese, or Detect automatically with a model that supports Chinese, where it converts only dictations recognized as Chinese, so Japanese stays as it is. The conversion uses the converter built into macOS and runs on this Mac. As recognized, the default, leaves the characters alone, and History's Original transcription keeps what the model wrote.
The dashboard sidebar shows the app version with a What's new link to the changelog. About has new Changelog and Support rows, and Support opens Buy Me a Coffee.
Changed
Home's greeting card is a plain card now, without the colored glow in its corner.
Settings fills the width of the window instead of staying in a narrow column in the middle.
Setup recommends Parakeet Ultra and lists Apple on-device speech only when it supports your language on this Mac. If Apple is your selected model and it isn't available, setup says so, keeps your setting and holds Continue until you pick another model. Models marks Apple as unavailable and turns off its Use button.
Dictation no longer stops at two minutes. It used to stop at two minutes without warning. Now it records until you release or press your shortcut, with a brief reminder every hour, up to a limit of 4,278,190,080 audio frames: about 24 hours 45 minutes at 48 kHz, half that at 96 kHz. At the limit it finishes by itself and transcribes what it captured. The live preview still stops following after ten minutes, and the full recording is transcribed when you finish.
A recording of ten minutes or longer now asks before it is sent to an API connection and before it is pasted automatically. If you don't send it, the audio stays on your Mac and you can try it again. If you don't paste it, the text is left on your clipboard. Local models never ask before transcribing.
API connections now load only the pieces of a long recording that are being uploaded, instead of holding the whole recording in memory first.
A long dictation sent to an API connection is uploaded in pieces at the same time, up to four at once, instead of one piece after another. The transcript keeps the pieces in order. If the provider answers that it is rate limiting (HTTP 429) or a piece times out, BetterWispr keeps the answers it has and sends the remaining pieces one at a time. A piece that fails then fails the dictation: nothing is pasted, and the recording is kept so you can try again.
A dictation interrupted by a microphone or recording failure now keeps what was captured, so you can try it again and find it in History when history is on. Before, the audio was deleted.
Recordings left in the temporary folder by a crash are deleted at the next launch, once they are more than a day old.
Hold to talk in Settings > Shortcut is now named Hold or tap, and its caption says how to finish a hands-free dictation. It works as before. Hold the shortcut to speak and release to finish, or tap it once to dictate hands-free and press it again to finish.
With a Whisper model selected, Spoken language in Settings offers every language that model supports, about 100, instead of the shorter list shared with the other models.
Speaker detection now works on macOS 14. It still needs the call audio the notetaker records on macOS 14.2 or later. It uses new models from Argmax SpeakerKit, about 15 MB, in place of the ones 0.1.5 downloaded. If you installed Speaker detection in 0.1.5, Models shows it as not downloaded, so download it again under Meeting speakers. Once the new download finishes, BetterWispr removes the 0.1.5 files, about 21 MB. Meetings you already recorded keep their speaker labels and names. The speaker accuracy figures in 0.1.5 were measured with the old models and have not been measured again with the new ones.
Use screen context now also fixes misspelled names in a dictation with the names in the window you dictate into, such as a teammate's name in a chat. It works at every cleanup level, so its switches now show without Medium. It needs Parakeet with the phrase booster and English or automatic language. Text read for spelling stays on this Mac. Only Medium cleanup sends screen context to your notes model, as before.
Start the next meeting while the last one is still processing. Stopping a meeting no longer locks the notetaker while it transcribes its last chunks, finds speakers and writes notes. The capsule, the menu bar and the dashboard can start a new meeting right away, and the stopped one finishes on its own. Its last words stay in its own transcript, and the dashboard does not jump to its note while the new meeting records. Skip, Cancel and Update summary act on one meeting. While two meetings overlap, each holds its own copy of the speech model.
Fixed
The floating capsule no longer blocks clicks in apps behind it. Its invisible window covered a large area at the bottom of the screen, so buttons there, for example in apps tiled in split view, could not be clicked. Only the capsule itself and a small margin around it now take the pointer, and hovering it still opens its controls.
The capsule no longer uses Liquid Glass on macOS 26 and later, where it could turn gray over bright windows and make its white text and icons hard to read. It now uses the same background as earlier macOS versions.
A dictation started while AirPods are playing for your iPhone or another device no longer records only silence. macOS could hand the AirPods to your Mac a moment after BetterWispr opened their microphone and then never send their sound. When a microphone sends nothing but exact silence for 2 seconds, BetterWispr restarts it once and hears what you say after that.
Audio interfaces with more than two inputs, such as Focusrite Scarlett interfaces, no longer fail with "No microphone input is available". BetterWispr records the interface's first two inputs, where its microphone inputs usually are, and leaves out loopback channels.
Stopping a dictation while BetterWispr is busy no longer throws the recording away with "The microphone stopped delivering audio". BetterWispr waited for the last moment of audio on the same thread that draws its windows, so a busy app could miss it even though the audio had arrived.
Leaving History no longer freezes BetterWispr for minutes when you have many dictations. History built every saved dictation at once, so a long history took seconds to open. Switching to another page then made macOS take thousands of views apart one at a time. History now builds only the dictations on screen.
Pasting into Screen Sharing works. BetterWispr now presses Command as a key of its own around V, the way a keyboard does. Screen Sharing passes Command to the other computer only when it sees that key, so it used to type the letter "v" there. Screen Sharing also misses clipboard changes made while its window is in front, so BetterWispr first chooses Edit > Send Clipboard, and your text stays on this Mac's clipboard. With Use Shared Clipboard on, Screen Sharing dims Send Clipboard, so BetterWispr turns that setting off, sends the clipboard and turns it back on. This adds about a second before the paste. When Send Clipboard can't be chosen, BetterWispr copies the text and doesn't paste, because the other computer would paste whatever it last copied.
Automatic paste checks that the field focused when dictation started still has focus. If you move to another field or tab in the same app, BetterWispr copies the transcript for manual paste. Apps that do not expose their focused field through Accessibility keep the existing app-level check.
Back-to-back dictations no longer restore an older clipboard snapshot over something you copied between them. Clipboard restoration also preserves rich-text formats and an empty clipboard.
An Ask answer that finishes after you delete a meeting it cites is discarded, so it cannot restore references to that meeting in your saved questions and answers.
Long meetings no longer fail with "The model couldn't condense this meeting enough". BetterWispr shrinks a long transcript in up to 8 rounds instead of 3, asks for fewer words when the notes model writes more than it was asked for, and when the model still can't shrink the meeting enough, writes notes for each remaining part and joins them in order. Such notes can be long and repeat a point, but every part of the meeting goes into them. The Summary tab also lets you pick another notes model next to Generate summary, so you can retry without going to Models.
Dictation sounds now play on a new install. With the setting on, BetterWispr stayed silent unless you had added your own sound files, because none ship with the app. Finishing a dictation now plays the macOS Purr sound, cancelling plays Bottle, and a problem that needs your attention plays Basso. A finished.wav, cancelled.wav or attention.wav file in ~/Library/Application Support/BetterWispr/SoundOverrides still replaces the matching sound.
Claude Code and Codex are now found when installed through nix or anywhere your login shell can run them, so Meeting notes and Medium cleanup no longer report them as missing.
Tagalog dictation with Smallest AI no longer fails as an unsupported language. BetterWispr renamed the language's code on the way out, and Smallest AI accepts only the original. Javanese and Norwegian are now sent the same way, with the codes Whisper uses.