FAQ
Why does Heblish need Accessibility permission?
Accessibility is the macOS permission that lets an app observe keystrokes
system-wide. That's what Heblish does — it reads each key you press to
decide whether a word might be in the wrong layout. The same permission
is what Karabiner, Alfred, Rectangle, BetterTouchTool, and similar apps
use. The observation happens entirely locally; nothing leaves your Mac.
Why isn't Heblish on the Mac App Store?
Mac App Store apps must run in App Sandbox, which doesn't allow the
kind of system-wide keystroke observation Heblish needs. Apps like
Karabiner-Elements, Hammerspoon, BetterTouchTool, and Alfred all
distribute directly for the same reason. Heblish is signed and
notarized by Apple, so macOS opens it without the "unidentified
developer" warning — it just isn't in the App Store's catalog.
Does Heblish work with non-standard Hebrew layouts?
Heblish currently assumes the standard Israeli "Hebrew" input source
(not "Hebrew – QWERTY" or "Hebrew – PC"). If you use a different
layout, the key-to-letter mapping will be off. Let me know — adding
additional layouts is straightforward.
Can I edit the ignore list directly?
Yes. Open the file at ~/Library/Application
Support/Heblish/ignore_list.txt in any text editor (one word per
line), save, and click Reload in the Heblish menu.
How does Heblish update?
Heblish checks for a newer version automatically in the background, and
also whenever you pick "Check for Updates…" from the menu. Either way it
fetches a signed update feed (EdDSA-verified) and, if a newer version
exists, offers to install it — nothing is downloaded or installed
without your say-so. The check fetches only the version feed; it never
sends your text. Updates download from GitHub Releases, and it uses
Sparkle, the standard open-source update framework. Prefer fully manual?
Block Heblish at the firewall and check whenever you like.
Can I trust an unfamiliar app to read my keystrokes?
That is the right question to ask of any app that requests
Accessibility permission. The short answer for Heblish: it's signed
and notarized by Apple, and it never transmits your text — its only
network activity is checking for its own updates. The source code can
be reviewed. If you want a hard guarantee, block it at the firewall —
autocorrect needs nothing from the network.
Is Heblish free?
Yes. If you find it useful and want to support development, that's
always appreciated — but there's no payment required.