What you need
- macOS 14 or later, on Apple silicon or Intel.
- A blabe trial, or a subscription and the license key from your purchase. Your account and license. Transcription is included, with no meter or monthly allowance (fair use applies), so thereâs no separate transcription bill. Or pick Free with your key and use your own xAI or Azure key.
- An internet connection. blabe needs it to transcribe.
Install
Download blabe from the download page. Open the disk image and drag blabe to your Applications folder. Then open blabe from Applications.
With Homebrew, run this instead:
brew install --cask telenel/blabe/blabe
blabe lives in the menu bar. It has no main window and no Dock icon.
First run
The first time you open blabe, a window called Welcome to blabe walks you through whatâs missing. Each page moves on by itself as soon as its step is done, and you can skip any page. It shows only the pages you still need.
- Microphone. Click Allow Microphone and choose Allow when macOS asks. blabe records only while you hold the hotkey.
- Accessibility. A short animation shows the switch to click. Click Open System Settings, and a small card beside System Settings shows what to click. Turn on blabe. macOS may first show its own message, âblabe would like to control this computerâŚâ: click Open System Settings in it. macOS may also ask for your password or Touch ID. Accessibility lets blabe hear the hotkey in any app and paste for you by pressing âV.
- Input Monitoring. Shown only if blabe still canât hear the key once Accessibility is on. Click Open System Settings and turn on blabe; the card circles its switch. If macOS offers to Quit & Reopen blabe, go ahead, and setup picks up where you left off. If blabe needs a restart to finish, a page offers Restart blabe.
- The key. Shown only if your hotkey is Fn. Click Open Keyboard Settings; the card beside System Settings circles the âPress key toâ menu. Choose âDo Nothingâ, so holding Fn doesnât also open emoji or dictation. The page moves on by itself.
- Start Your Free Trial. Click Start Free Trial to start the trial, or paste the license key from your purchase and click Sign In. Free 2-day trial, no sign-up, up to 30 minutes of audio, and no card or email. To buy a plan, choose See pricing. To use your own xAI or Azure key instead, choose Use your own API key. Choose Skip for now to do this later in Settings â Account.
- Try it. On your first run, once everything above is set up, hold the hotkey and say something. Let go, and your words appear in a practice box. Click Continue, or Skip.
- Youâre all set. The page lists whatâs set up, including a Trial or subscription started row. Click Start Using blabe. Hold Fn and speak; release to paste.
If blabe isnât in a list, drag its icon from the card into the list, or click + under the list and choose blabe in Applications.
Why each permission is needed is on the permissions page.
Try it
- Click into any text field, for example in Notes.
- Hold Fn and say a sentence. A small pill at the bottom of the screen shows a live waveform.
- Let go. The pill says itâs transcribing, then your words are pasted where your cursor is.
Taps under 0.3 seconds and recordings with only silence are ignored. A recording stops on its own after 5 minutes and is transcribed.
If you skipped a step
The menu bar icon shows a warning, and the top item in its menu names whatâs still missing: Grant Microphone AccessâŚ, Grant AccessibilityâŚ, Grant Input Monitoring⌠(only if blabe needs it), Relaunch blabe to Finish Setup or Sign In to blabeâŚ. Click it. A missing permission opens its list in System Settings with the same card beside it. Each one is explained in troubleshooting.
Settings
Open Settings⌠from the menu bar icon.
- Hotkey: Fn () by default. See Hotkey options.
- Clean up speech: on by default. Removes filler words like âumâ and âuhâ. With Transcription set to Azure, MAI-Transcribe 2 also removes false starts.
- Send automatically to coding agents: off by default. See Sending to coding agents.
- Language: Auto-detect by default. Pin a language if auto-detection gets it wrong.
- Transcription: xAI (live) by default, or Azure. See where your audio goes.
- Words to recognize, in the Words tab: names, products and jargon to spell right, separated by commas. You can add up to 50 words or names to help blabe hear them; nothing is added automatically.
- Microphone: Built-in microphone (recommended) by default. System default follows System Settings â Sound.
- Play start and stop sounds: off by default.
- Launch at login: off by default. It works best when blabe is in Applications.
- Install updates automatically: on by default. When it can, blabe downloads a new version and, once it has been idle for five minutes, installs it after a five-second notice and restarts. Turn it off and updates wait in the blabe menu instead: click the offer, then Install. Turning it off doesn’t undo an installation that has started, and an update already prepared may still install when you next quit blabe.
- Account: sign in with your license key, see your plan and usage, and sign out. See Your account and license.