Skip to documentation content
Keebye Docs

Getting started with Keebye

Install Keebye, sign in, grant the two permissions it needs, pick your push-to-talk key, and dictate your first sentence.

Keebye is a menu bar app. Onboarding opens with "Welcome to Keebye" and walks you through five steps while the default speech model downloads in the background. This page covers the same five steps.

Install Keebye

Open the Keebye DMG and drag Keebye into Applications, then launch it. Keebye runs in the menu bar only and has no Dock icon. It needs macOS 11.0 or later on an Apple Silicon Mac.

Sign in

Sign-in is required to dictate. The login window "Sign in to Keebye" offers "Continue with Google" and "Continue with Email". Keebye opens keebye.com in your system browser and brings you back to the app automatically once you finish.

Grant permissions

Onboarding asks for two permissions. Finish stays disabled until both are granted and the speech model has downloaded.

  • Microphone: press "Grant microphone access". Keebye listens only while you hold your dictation hotkey.
  • Accessibility: press "Open System Settings" and switch Keebye on. This lets Keebye watch your hotkey and paste text into any app. Keebye checks every 1.5 seconds and arms the hotkey as soon as access is granted, with no restart needed.
  • Speech Recognition is only requested if you later pick the "Native (Apple Speech)" engine. Input Monitoring is never requested.

Pick your push-to-talk key

Choose one of Fn / Globe, Left ⌘, Right ⌘, Left ⌥, or Right ⌥. Right ⌘ is the default. You can change it later in Settings and the change applies live.

Dictate your first sentence

Click into any text field, hold your hotkey, speak, and release. The pill at the bottom of the screen shows "Listening…", then "Transcribing…", then "Inserting…", and the text lands where your cursor is.

  • Hold the key for at least 400 ms and release to stop and insert.
  • Tap the key (under 400 ms) to keep recording hands-free; tap again to stop and insert.
  • Press Esc while recording to cancel. Nothing is inserted.

Frequently asked questions

Does Keebye need an internet connection?

Only for signing in, downloading a speech model, and checking for app updates. Transcription runs on your Mac. An unexpired cached session is trusted offline.

Why does the macOS microphone indicator stay on after my first dictation?

Keebye keeps the microphone stream warm after the first dictation so later dictations start faster. This is deliberate. Audio is only turned into text while you hold or toggle the hotkey.

How long does the speech model take to download?

The default Parakeet model is about 670 MB and downloads once, while you finish the other onboarding steps. The pill shows "Downloading speech model… NN%" until it is ready.

Which Macs does Keebye run on?

Apple Silicon Macs running macOS 11.0 or later. macOS is the only shipped platform.