sttlab-tech
75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
# FocusFixer
|
|
|
|
Native macOS menu-bar utility that fixes a long-standing multi-display bug: after clicking a
|
|
window on one screen, keyboard focus can stay on a window on another screen, so typing goes to
|
|
the wrong place. Download, unzip, run — grant Accessibility when prompted (see `CLAUDE.md` for
|
|
how the app is built).
|
|
|
|
## Installing from a downloaded release
|
|
|
|
Grab `FocusFixer-vX.Y.Z.zip` from the
|
|
[releases page](https://gitea.sttlab.eu/stt/focus-fixer/releases), unzip it, and drag
|
|
`FocusFixer.app` to `/Applications`.
|
|
|
|
The app is signed with a self-signed identity (`sttlab-apps`), not an Apple Developer ID —
|
|
there's no paid Apple account behind this project. macOS's Gatekeeper doesn't trust that
|
|
signature by default, so on first launch of a version downloaded from a browser (which
|
|
macOS marks with a quarantine flag) you'll likely see it refuse to open, or ask to move it to
|
|
the bin. Pick **one** of the two options below to get past that — you don't need both.
|
|
|
|
### Option 1 — Trust the `sttlab-apps` certificate
|
|
|
|
This tells your Mac to trust anything signed by this specific certificate going forward, so
|
|
you won't need to repeat this for future versions of the app (as long as it keeps being signed
|
|
with the same identity).
|
|
|
|
1. Get the certificate: `sttlab-apps.cer` (ask for it, or export it yourself if you have
|
|
access to the machine it was created on: `security find-certificate -c "sttlab-apps" -p
|
|
> sttlab-apps.cer`).
|
|
2. Import it into your login keychain:
|
|
```bash
|
|
security import sttlab-apps.cer -k ~/Library/Keychains/login.keychain-db
|
|
```
|
|
3. Trust it, but **only** for code signing (not as a general root CA):
|
|
```bash
|
|
security add-trusted-cert -r trustRoot -p codeSign \
|
|
-k ~/Library/Keychains/login.keychain-db sttlab-apps.cer
|
|
```
|
|
macOS will prompt for your login password — that's it asking permission to change
|
|
keychain trust settings, not this command asking for a password directly.
|
|
4. Open `FocusFixer.app` normally (double-click, or `open /Applications/FocusFixer.app`).
|
|
|
|
### Option 2 — Bypass Gatekeeper for this app only
|
|
|
|
No trust changes, no certificate needed — just tells macOS to stop flagging this specific
|
|
app. You'll need to repeat this for each new version you download (the quarantine flag is
|
|
set per downloaded file).
|
|
|
|
Either:
|
|
|
|
- Right-click `FocusFixer.app` in Finder → **Open** → **Open** again in the confirmation
|
|
dialog. (Regular double-click won't offer this the first time; right-click → Open does.)
|
|
|
|
Or, from a terminal:
|
|
|
|
```bash
|
|
xattr -dr com.apple.quarantine /Applications/FocusFixer.app
|
|
```
|
|
|
|
(`-r` because it's a bundle — the quarantine flag can be set on files inside it too, not just
|
|
the top-level `.app`.)
|
|
|
|
Both achieve the same result: the app opens. Option 1 is the better choice if you expect to
|
|
download future versions and don't want to repeat the bypass each time; Option 2 is faster
|
|
for a one-off.
|
|
|
|
## Granting Accessibility permission
|
|
|
|
FocusFixer needs Accessibility access to watch clicks and reassert focus — it can't do
|
|
anything useful without it. On first launch it prompts for the grant automatically; if you
|
|
miss the prompt or need to re-grant it later, go to **System Settings → Privacy & Security →
|
|
Accessibility** and enable FocusFixer there.
|
|
|
|
FocusFixer has no Dock icon and no regular window — look for its icon in the menu bar. That
|
|
menu is also where you toggle it on/off and enable/disable launching at login.
|