The menu bar dictation icon: the capybara, and what he is telling you
By Ryleigh Newman · Published · Updated
The capybara in your Mac's menu bar is YapToText's status light, and clicking him opens a small panel of controls for dictation without opening a window. He is there from the first launch, and the Icons card on the Home page can swap him for a plainer icon or hide him. He helps most when your hand is already on the mouse, or when you want to know what the app is doing at a glance.
His speech bubble turns red while you record, becomes a spinner while your words are transcribed and cleaned up, flashes green when the text lands, and turns orange if something went wrong. When nothing is happening he sits quietly in the menu bar's own color and blinks every few seconds, which is the one thing he does purely for fun.
This app is completely free. You don't have to make an account. There are no subscriptions, no difficult downloads, and nothing is locked. Made for Apple silicon Macs. Source on GitHub.
This guide in other languages: العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
On this page: 10 sections
Read what each color means
Only the speech bubble changes. The capybara himself stays in the menu bar's own color. Red means listening, a spinner means working, and green means your text landed.
- Plain, no color. Idle. The icon matches a light or dark menu bar like every other item there, and he blinks every few seconds.
- Red, breathing. Recording. The bubble shifts between bright and deep red, and its three dots bounce while he listens.
- A spinner where the bubble was. Transcribing, or the cleanup model is working. Version 1.4 made it visible on a light menu bar, and 1.3.1 stopped it running backwards.
- Green. Your text was just inserted.
- Orange. That dictation hit an error, and the floating panel shows what went wrong.
Use the panel
Click the capybara to open the panel. From top to bottom:
- Start Dictation. Does the same thing as tapping your dictation key, Right Command by default. While you record it turns into three round buttons: cancel, pause or resume, and stop and insert. While the app is still working on your words, only cancel remains.
- Mode. The left pill shows the current mode. Its menu numbers your modes 1 to 9, the same numbers you can press mid-dictation, and any past nine sit under More modes. With Post-transcription analysis off, the pill is grayed out, because modes do nothing then, and clicking it explains why and offers to turn analysis back on.
- Input. The right pill chooses which microphone YapToText listens to. System Default follows macOS, and below it is every input on the Mac.
- Transcribe file. Opens a file picker for any audio or video file and transcribes it in your current mode. The text goes to your clipboard and into History, and with Insert text automatically on, which is the default, it is typed into the app you were using when you picked the file.
- Regenerate. Rewrites your last dictation or the text you have selected as another mode. The next section has the details.
- Insert last. Types your most recent dictation into the app you were just using. It stays grayed out until History has something in it.
- Recent. Your last three dictations, two lines each, with a copy button beside each one. See all opens History.
The row along the bottom quits the app, opens the tip jar, opens the main window and opens Settings. Everything a dictation needs is one click away, and the main window can stay closed.
Regenerate from the menu bar
Regenerate rewrites text you already have. Click it and the panel asks what to rewrite. Most recent dictation redoes your last one, and Selected text rewrites whatever you have selected.
- Most recent dictation. Redoes your last dictation as any mode with AI cleanup on: a spoken message becomes an email, a rambling note becomes a clean one. If the original is still on screen from the last five minutes, the new text is swapped in right there. Otherwise it goes to your clipboard. History keeps the new version.
- Selected text. Rewrites whatever is selected in the app you were just using, in any mode with AI cleanup on, and pastes the result over the selection. This list also offers your AI Actions as one-shot edits, such as Summarize or Translate to English.
Raw Transcription is not offered, because it has nothing to rewrite with. After you pick, the panel shows Regenerating as, holds for a beat, then fades out so the app can switch back and paste. To rewrite a selection by speaking the change instead, Quick Edit does it with one key.
Pick an icon style
The capybara is the default, but four plainer styles do the same job. The Menu bar icon picker is in the Icons card on the Home page and in Settings, General, System.
- Capybara. The mascot, with his speech bubble as the status light.
- Microphone. The standard mic symbol: outline when idle, filled while recording, with a spinner in the corner while the app works.
- Mini waveform. Nine small bars, a resting wave when idle and your real voice while you record. It has no spinner and no green flash, so the bars are all you watch.
- Speech bubble. A plain bubble, outline when idle and filled while recording.
- Minimal dot. One small dot that swells with each breath while you record.
The icon at the top of the panel changes to match, so the thing you clicked and the thing that opened look like the same app.
Turn colored status on or off
Colored status in the menu bar is a switch in Settings, General, System, on by default. With it on, every style except the Mini waveform tints with the dictation state: red while recording, green on insert, orange on an error. With it off, the icon stays monochrome in every state and adapts to the menu bar, and the spinner and the outline-to-filled change still show what is happening.
The Mini waveform works differently. With colored status on, its bars light up only while a dictation is live, in your custom accent color or in a Visualizer color you pick under the switch, and go back to monochrome at rest. Match accent puts a picked color back.
Hide the icon, or keep it after a restart
The Menu bar icon switch in the Icons card on the Home page takes the capybara out of the menu bar. Everything else keeps working: your dictation key still starts a dictation, and the floating panel still appears. The Dock icon has its own switch in the same card. If you hide both, open YapToText again from your Applications folder and its window comes back.
The capybara only appears while YapToText is running. To have him there after every restart, turn on Launch YapToText at login in Settings, General, System. It is off by default.
Limits
- Regenerate needs a cleanup model. The App Store build has one inside. On the Homebrew build, download Phi-3.5 Mini Instruct or another cleanup model on the AI Models page first.
- Selected text needs Accessibility. Without it, dictation still works and copies to the clipboard, but Regenerate cannot see what you selected.
- Password fields stay private. While Secure Input is on, which usually means a password field, no selection can be read, and Regenerate says so.
If something is off
If the capybara is missing, work down this list:
- Open YapToText. He only appears while the app is running.
- Turn the icon back on. In the Icons card on the Home page, switch Menu bar icon on.
- Make room in the menu bar. On a notched MacBook with a crowded menu bar, macOS hides items that do not fit. YapToText tries once to move him to a visible spot. Removing a few other items gives him room.
Other things that can look wrong:
- The mode pill is grayed out. Post-transcription analysis is off. Click the pill and the app offers to turn it back on.
- Regenerate says to select some text. Select the text in the other app first, then open the panel.
- Insert last is grayed out. History is empty, which happens when Save dictation history is off in Settings, Advanced, History & audio.
- The icon never changes color. Colored status in the menu bar is off, or you picked the Mini waveform without a custom accent or Visualizer color.
For problems with the dictation itself, the troubleshooting page goes step by step.
The short version
- Read the colors. Red is recording, a spinner is working, green is inserted, orange is an error.
- Click him for controls. Start Dictation, mode, microphone, Transcribe file, Regenerate, Insert last and your recent dictations.
- Change or hide him. The Icons card on the Home page has both switches.
One glance tells you what the app is doing, and one click gets you the rest. If he ever shows something this page does not explain, tell me on GitHub. Every issue gets read.
This app is completely free. You don't have to make an account. There are no subscriptions, no difficult downloads, and nothing is locked. Made for Apple silicon Macs. Source on GitHub.
Related
Questions
Why is the capybara's speech bubble red?
Red means YapToText is recording. The bubble breathes and its dots bounce until you stop, then it becomes a spinner while your words are transcribed, and it flashes green once the text is inserted.
What does the orange menu bar icon mean?
Orange means the last dictation hit an error, and the floating panel shows what went wrong. The troubleshooting page covers the common causes.
Can I change the menu bar icon to something plainer than the capybara?
Yes. The Menu bar icon picker, in the Icons card on the Home page and in Settings, General, System, offers Capybara, Microphone, Mini waveform, Speech bubble and Minimal dot.
Can I hide the YapToText menu bar icon?
Yes. Turn off the Menu bar icon switch in the Icons card on the Home page. Your dictation key, the floating panel and every other feature keep working without it.
What does Insert last do?
It types your most recent dictation into the app you were last using. It is grayed out until History has at least one dictation.
Can I regenerate a dictation as a different mode from the menu bar?
Yes. Regenerate offers your most recent dictation or the text selected in your last app, then lists every mode with AI cleanup on. For selected text, the rewrite replaces the selection in place.