Getting started
What you need: a Mac with Apple silicon (M1 or later) and macOS 14 or later. Meeting notes need macOS 14.2 or later. Keep about 2 GB free for the models.
Open the app and setup walks you through it, one screen at a time:
- Models. One model hears you and one cleans up your words. For English, choose Express. For other languages, Lite. Downloads carry on while you go through the next screens.
- Permissions. Microphone, to hear you, and Accessibility, to notice your key and type into other apps. Each card ticks itself when macOS grants it.
- Microphone. A quick check that it hears you. Nothing is kept.
- Your key. Right Option to start with. You can choose another.
- Try it. Three real dictations, for practice. They aren’t saved or counted.
- Ready. Add names the app should know, and choose whether it opens at login.
“Skip for now” is fine: Home keeps a reminder for anything still missing. Settings › About › Run setup again starts it over.
Ramblebee lives in your menu bar. A thin bar at the edge of your screen shows it’s ready. Point at it for Dictate and Notes, drag it to another edge, or right-click it to hide it.
Dictating
- Hold Right Option, talk, and let go. Your words go wherever your cursor is, in any app.
- Hands-free: tap Right Option twice quickly, or press Option-Shift-Space, then talk as long as you like. Press the key again, or click ✓, to finish. ✕ cancels.
- Cancel with Escape. If you’d said more than a second, the pill offers Undo for a few seconds to bring it back.
- Take it back: say “scratch that” as a sentence of its own to drop the sentence before it. Dictate just “undo that” to remove your last dictation, or choose Undo Last Dictation from the menu bar.
- Paste it again with Control-Command-V, to put your last dictation where your cursor is now.
- Change your mind mid-sentence and it keeps the last thing you said. Count points out loud and you get a list. Start with a greeting in an email and it’s laid out as one.
A dictation can be up to 20 minutes long. Spaces, capitals and full stops are fitted to the text around your cursor, and whatever you’d copied is put back on the clipboard afterwards.
To use another key, open Settings › Shortcuts. Fn, Right Option, Right Command or Right Control can work on their own, or you can choose a function key or a combination. Standard Mac shortcuts, such as Command-C, can’t be chosen.
Cleanup and styles
Cleanup takes out the ums and repeats, applies your corrections and punctuates. It runs on your Mac with Standard, our own model trained for dictation. Advanced is larger and more careful, and takes more memory. You can also use a cloud model with your own API key, or turn cleanup off in Settings › Cleanup and keep a light cleanup that only removes hesitations.
Styles (Library › Styles): Natural, Verbatim, Concise, Professional or Casual. You can give any app its own style, and its own language and engines.
Names and your words
- Dictionary (Library › Dictionary): words to listen for, and replacements, such as “ramble bee” written as “Ramblebee”.
- Learning: fix a name just after dictating it and the app offers to remember it.
- Snippets (Library › Snippets): say a short cue, such as “my address”, and get the full text.
- Names on screen: names around your cursor help spelling. “Use what is on screen” in Settings › Accuracy decides whether they’re used only on your Mac, which is the default, also by a cloud model you chose, or not at all.
- Code names (Premium): in a code editor or terminal, say a file or function name and it’s spelled the way it is in your project.
Command Mode Premium
Hold Right Command, say what you want done, and let go. It needs cleanup to be on.
- With text selected, it rewrites the selection: “make this shorter”, “turn this into bullet points”, “translate to Spanish”.
- With nothing selected, it changes what you just dictated (“make that more formal”), replies to the conversation in the window (“reply saying I’ll be there at five”), or writes something new at your cursor.
- Ask a question (“what does this mean?”) and the answer appears in a card, with Insert, Replace and Copy.
- Saved commands (Library › Commands) turn a short cue into a full instruction. Fix this, Shorter, Summarize and Translate are there to start with.
Command Mode works best with the Advanced model downloaded. With only Standard, read a reply before you send it.
Notes
Control-Option-N opens Notes, a window that floats above your work. Type, or hold your key to dictate into it, or click its microphone button. It understands Markdown: headings, lists and to-dos you can tick. Copy gives you Markdown and formatted text. Up to five notes can be open in tabs.
Transforms (Premium) change the selection, or the whole note: Fix this, Shorter, Summarize, Translate, or anything you ask for.
Meeting notes Premium Beta
- Start from the Meetings tab, or when the app notices a call. Under “When a call starts” you can have it ask, start by itself, or do nothing.
- Calls it notices: Teams, Zoom, Webex, Slack, FaceTime and Discord, and Google Meet, Teams, Zoom, Webex, Whereby or Jitsi in your browser. Any other app that keeps your microphone for 45 seconds is offered too.
- While it listens, the pill shows a dot and the time. Point at it to stop. Notes stop by themselves when the call ends.
- The first time, macOS asks to let the app hear your Mac’s sound. Without that, only your side is written down.
- Afterwards you get the transcript, then a summary, key points, decisions and action points, with who said they’d do it and when, and a title. Tick action points off, name the voices, or ask a question about the meeting.
- Notes are written as General, Stand-up, One-on-one, Interview or Action items. Write again tries another.
Notes need the Advanced model. Telling voices apart needs the small Voices model, and meetings in English and Hindi need the English and Hindi model; the Meetings tab offers each. Headphones help: without them, the app takes out the echo of the call as best it can.
Tell people you’re taking notes. Recording laws differ by place, and many require everyone’s consent.
Models and storage
Settings › Storage lists the models on your Mac, what uses each one, and its size, with a way to remove it. Every download is checked before it’s used. On a Mac with 8 GB of memory, Standard is the better choice for cleanup. Each model’s maker and licence are in Settings › About and on our Credits page.
Privacy and API keys
- Keep everything on this Mac (Settings › Privacy) starts on and blocks every cloud request.
- To use a cloud model, choose a provider in Settings › Speech or Settings › Cleanup and paste your API key. Keys are kept in your Mac’s Keychain, and the provider bills you directly.
- History is off until you turn it on, and you choose how long it’s kept.
Our Privacy Policy has the details.
Fixing problems
Holding the key does nothing
Open the app’s window: the top right says “Shortcuts off” or “Setup needed” when something is missing.
Turn the app on in System Settings › Privacy & Security › Accessibility. If it was already on before an update, turn it off and on again.
Then choose Retry Shortcuts from the app’s menu in the menu bar.
Another app may use the same key. Choose another in Settings › Shortcuts.
Pressing fn opens the emoji picker
In System Settings › Keyboard, set “Press 🌐 key to” to Do Nothing. Settings › Shortcuts in the app reminds you while it isn’t.
“Ramblebee can’t hear you: microphone access is off.”
Turn the app on in System Settings › Privacy & Security › Microphone, then try again.
“No microphone was found.”
Connect a microphone, or choose another in Settings › Speech.
“The microphone wasn’t ready” or “The microphone changed during the recording”
This happens while headphones connect or the Mac switches microphones. Wait a moment, then press your shortcut again.
“Didn’t catch anything.”
Keep holding the key until you’ve finished speaking.
Check the microphone chosen in Settings › Speech. Settings › About › Run setup again has a microphone check that shows whether it hears you.
“Couldn’t transcribe that.”
Click Try again in the pill, or choose Retry Last Dictation from the menu bar. The recording is kept in memory until your next dictation works, so nothing is lost.
“Inserted without AI cleanup”
Your words went in with only the basic cleanup, because the cleanup model had a problem. Check Settings › Cleanup: that its model is downloaded, or, for a cloud model, that your API key is right.
My words didn’t appear
If nothing could take the text, it waits in a card headed “Not inserted”, with Copy and Save as Note.
Click where the text belongs and press Control-Command-V to paste your last dictation there.
Password fields are never typed into.
My words came out twice
Another dictation app is probably listening to the same key. Quit it, or give one of them a different key.
A download failed
The message says why. For space, Settings › Storage shows what’s using it: a download needs its own size plus 500 MB to spare.
For the connection, try again once you’re online. A damaged download is deleted by itself, so just start it again.
Dictation feels slow
The first dictation after installing or updating takes a few seconds longer, once, while macOS checks the app.
On a Mac with 8 GB of memory, choose Standard in Settings › Cleanup: Advanced takes about 3 GB while it runs.
For English, Express is both quick and accurate. Universal is more accurate in other languages but slower. With a cloud model, speed depends on the provider.
Meeting notes only have my side
Allow the app in System Settings › Privacy & Security › Screen & System Audio Recording, in the audio-only part. Meeting notes need macOS 14.2 or later to hear the other side.
“Ramblebee closed unexpectedly”
Sorry about that. If it happens again, make a diagnostics report (below) and send it to us, so we can fix it.
Making a diagnostics report
A report helps us see what went wrong without seeing anything you said.
- Open Settings › About and click Make a Report…
- Read it: it shows everything it contains. It has no words, recordings, notes, keys or file paths.
- Click Save… and attach the file to an email, or Copy and paste it in.
Then tell us what happened. The app never sends a report by itself.
Keyboard shortcuts
Change any of them in Settings › Shortcuts.
Uninstalling
- Open Settings › Storage and click Remove Everything… It deletes the models, history, notes, meetings, settings and API keys, stops the app opening at login, and quits.
- Drag the app from Applications to the Bin.
- If you like, remove it from the lists in System Settings › Privacy & Security.
Still stuck?
Contact us or report a problem. Apple silicon · macOS 14 or later.