Docs

Set up blabe

Install blabe, open it once and step through the welcome window. Each step moves on by itself when it’s done. If Microphone or Accessibility is still off, the welcome window opens again the next time blabe starts.

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.

  1. Microphone. Click Allow Microphone and choose Allow when macOS asks. blabe records only while you hold the hotkey.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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

  1. Click into any text field, for example in Notes.
  2. Hold Fn and say a sentence. A small pill at the bottom of the screen shows a live waveform.
  3. 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.