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.
Does Heblish auto-update?
Yes — it uses Sparkle, the open-source auto-update framework. Updates
are signed with EdDSA and downloaded from this domain. You'll see a
gentle prompt when a new version is available; you can install it,
skip it, or disable update checks entirely in the menu.
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, makes no network calls (verifiable with
nm on the binary), and the source code can be reviewed.
If you want a hard guarantee, block it at the firewall — it doesn't
need the network for anything.
Is Heblish free?
Yes. If you find it useful and want to support development, that's
always appreciated — but there's no payment required.