Keyboophelp NEWAissia RU ← to site

How it works

Short answers to “how do I use this thing”. Can't spot yours? Type the question into the search box up top: it looks through every section at once.

Nothing found for “”. Don't panic: try other words, e.g. “layout”, “voice”, “translate”, “access”.

Installation

How to install Keyboop

  • Download the .dmg from keyboop.com and open it.
  • Drag Keyboop into the Applications folder (the shortcut is right there in the window).
  • Launch it. Keyboop lives in the menu bar (the icon next to the clock). There's no main window: it's a background helper.

Or with a single Homebrew command: brew install --cask keyboop. Updates still arrive from inside the app.

macOS says it's “damaged” or won't let me open it

Keyboop is notarised by Apple, so it normally opens straight away without a single warning. If you still see “is damaged and can't be opened” (with a “Move to Trash” button), it's almost always an incomplete download or launching it straight from the .dmg rather than from Applications.

The cure: mount the .dmg again → drag Keyboop into Applications → launch it from there. If it happens again, download the .dmg afresh from keyboop.com (the old file may have been cut short).

Allow Accessibility access

Without it Keyboop can't fix your layout or hear its hotkeys. It asks on first launch. Click “Open Accessibility” and switch Keyboop on in the list. Once it's on, Keyboop starts working by itself, no restart needed.

Input Monitoring is usually NOT required.

After an update, access shows as on but doesn't work

A one-off side effect of a signature change: remove Keyboop from the Accessibility list (the “−” button) and add it back (“+”, or just drag it in). Later updates keep the permission, so this is a one-time chore.

Which macOS do I need?

Apple Silicon (M-series): macOS 14 or newer. Intel Macs: macOS 13 or newer (voice input runs on Whisper on the CPU there, so it's slower and warmer, and the Parakeet engine isn't available on Intel). Translating a selection works on macOS 15+.

Layout switching

Automatic switching: how it works

You typed a word on the wrong layout. On Space, Enter or Tab it gets quietly fixed: ghbdtn → «привет» (Russian for “hello”, typed with the English layout on), and the other way round: руддщ → “hello”. The decision rests on a dictionary, letter-combination frequencies and the context of the phrase (the neighbouring words), both ways, RU↔EN.

The triggers (Space, Enter, Tab) can be switched on and off in Settings → Switching → Triggers.

Fix it by hand when it guesses wrong

Press ⌥⇧ (Option+Shift) to switch the last word. You can change the hotkey to your own in Settings.

Switch a whole line or several words

Noticed the wrong layout late, and it's more than the last word?

  • Select the line and press the switch hotkey: everything selected gets fixed.
  • In manual mode (with auto switched off), one hotkey fixes the whole phrase you typed at once. Valid words stay put: “hello ghbdtn” → “hello привет”.

Fix as you type, without waiting for the space

The moment a letter combination becomes impossible in the current language, Keyboop fixes the word mid-typing, without waiting for the space. On by default. The replacement happens exactly at the keystroke, so the next letter can't squeeze into it. If it gets in your way, one toggle turns it off: Settings → Switching → Fix as you type.

Switch sound

When it fixes a word, Keyboop gives a quiet “boop”. The sound and its volume are set (or switched off) in Settings → Switching → Sound on switch.

Exceptions and learning

Words to leave alone

Settings → Exceptions holds a list of words Keyboop never switches. «вк» and «тг» (Russian shorthand for VK and Telegram) are already there as examples: brand names whose layout swap happens to spell an English word. Type your own word and press Enter (or “Add”); to remove one, click the ✕ on it.

Why doesn't «вк» switch to “dr”?

That's on purpose. Popular services (вк, тг, ок and friends) whose layout swap matches an English word are protected for everyone by default. That list is built in and ships with updates.

Don't switch in certain apps

In the same settings you can add an app and pick a mode:

  • Off: in this app I don't touch the layout at all.
  • Soft: I fix only obvious words and leave single letters and short combos (variables, commands) alone. Handy for IDEs and terminals.

There's also Mode for developers (Settings → Switching): in IDEs and terminals, auto-switching keeps its hands off.

Learn from undo

If Keyboop switches a word and you immediately undo it back to how it was, it notices. On the third such undo of the same word, a banner in the top right corner asks: Keep “word” as is? Click “Add” and the word goes into exceptions, and Keyboop confirms it will leave that word alone from now on. Click “No thanks” and it never asks about that word again. Nothing lands in exceptions silently. Learned words have their own list in Settings, and any of them can be removed.

Snippets

Abbreviations that expand

Type a short abbreviation, press Space, and it unfolds into a whole phrase: br → “Best regards, …”, eml → your e-mail. Your own snippets live in Settings → Snippets.

Voice input (dictation)

How to dictate

  • Press the dictation hotkey (Right ⌥ by default), speak, and press it again. The text gets typed in right where you are. That's how it works for everyone who installed Keyboop recently.
  • If “hold and talk” suits you better, Settings → Voice input → Mode has a Hold option. Long-time users who never changed this setting already have it.
  • Punctuation puts itself in.
  • Esc while recording cancels.

You need to download a recognition model

Recognition runs entirely on your Mac, so the model has to be downloaded once: Settings → Voice input → pick a model (Whisper, or Parakeet on the Apple Neural Engine) and click “Download”. After that you don't need the internet: recording and recognition both live on your Mac. The full list of occasions when Keyboop goes online at all is on the privacy page.

Dictation doesn't start on the first press

Fixed in recent versions: recording starts straight away, including right after the previous phrase. If it still stays quiet, check that microphone access is granted (Keyboop asks the first time you use it) and that a model is downloaded.

I dictated, but the text didn't land (the window changed)

Nothing is lost: everything you dictated is kept in the history, which opens from the menu bar icon's menu. More on it below.

Dictation history

Keyboop keeps a local history of recognised text, reachable from the icon's menu → Dictation and clipboard history… Double-click an entry to copy it to the clipboard. If the text didn't end up where it should (focus moved, a field “ate” the insert), the history is your safety net: nothing is lost. It's stored encrypted on this Mac and goes nowhere. How long to keep it, one-click clearing and switching it off entirely are in the voice input settings, where you can also put the history behind a password.

Translate selection

Translate what you typed

Select your own text in an input field, somewhere you can type (an email, a chat, a note, an editor), and press ⌃⌥T (Control+Option+T). The selection gets replaced with its translation; Keyboop works out the RU↔EN direction itself. Mind the catch: the translation goes in place of the selection, so read-only text on a web page can't be translated this way (there's nowhere to put the result). For that, use your browser's translator.

It runs on Apple Translation, on your device (macOS 15+). The clipboard comes through unharmed.

Privacy

What Keyboop sends out

Of what you type and dictate, nothing leaves your Mac. No telemetry, no keylogging, no analytics. Keyboop goes online only for obvious reasons: you download a voice model, you open a link from the menu, you send feedback via “Report a problem…” (all three started by you), and the app checks for updates. The update check sends exactly what visiting any website does: your IP and the version number. Recognition, switching and translation happen entirely on your Mac. More details.

What about password fields?

In secure input fields (passwords) Keyboop switches itself off automatically and collects nothing. And the key thing about the clipboard: Keyboop fixes words by typing the characters directly, so the clipboard isn't involved at all. One exception: selected text in apps where the system won't hand over the selection (Chrome, Slack, VS Code). There Keyboop copies the selection with a behind-the-scenes ⌘C and immediately puts the clipboard back exactly as it was, images and formatting included, and only after making sure it was the one that changed it. Punto did it differently and ran every single fix through the clipboard, hence the overwritten copies.

Hotkeys

Default shortcuts

⌥⇧Switch the layout of the last word (manually). Can be changed in Settings.
Right ⌥Dictation: press, speak, press again. Settings also offer a “Hold” mode.
⌃⌥TTranslate the selected text.
EscCancel the current dictation.

FAQ

What is Keyboop?

A free, open-source keyboard layout switcher for macOS. Typed ghbdtn when you meant «привет» (Russian for “hello”, typed with the English layout on)? Keyboop erases the word and retypes it in the right layout, without touching the clipboard. Plus voice input and translation of selected text. Everything runs on the Mac itself.

Does voice input work offline?

Yes. Speech is recognised right on your Mac, and your voice goes nowhere. You need the internet once: to download a recognition model with a button in Settings.

Is it really free? What's the catch?

No catch. No subscription, no “Pro”, no ads, no accounts. There's nothing to track and nothing to sell: your input never leaves the Mac. The code is open, so you can check.

How is it different from Punto Switcher?

Above all, Keyboop doesn't break the clipboard. We took apart the macOS build of Punto Switcher (the classic Russian layout switcher) that Yandex distributes, version 2.1.5: every single fix went through the clipboard, and the clipboard was put back on a timer with no checks. Hence the overwritten copies. Plus voice and translation, privacy by default, and open source. Punto Switcher is a Yandex program, and we have nothing to do with it.

How do I update?

Keyboop finds new versions by itself. When one ships, a banner appears by the clock with an “Update” button. Tired of clicking it every time? Right next to it is “Update automatically”: from then on Keyboop installs updates quietly, while you're away from the keyboard. Updates are signed and verified, so nobody can slip you a fake build.

It's all set in Settings → Updates (that's also where “Check now” lives, and where you can switch updates off entirely). To find out what's new, look at the “What's new” page or follow the Telegram channel @keyboop (it's in Russian).

Didn't find your answer

Drop me a line and I'll sort it out. Contacts and a feedback button are in the app (Settings → About) and on the site.

wrong layout? Keyboop. · from the boop family · keyboop.com · privacy · Aissia, co-created by the author · RU · ← home