Skip to content

Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.

fix(macos): notify users when accessibility permissions are missing

Gabriel Stein547cf22b5f3e
diff --git a/main.js b/main.js
index ed83ef086..03aa9d3e2 100644
--- a/main.js
+++ b/main.js
@@ -1,4 +1,12 @@
-const { app, globalShortcut, BrowserWindow, dialog, ipcMain, session } = require("electron");
+const {
+ app,
+ globalShortcut,
+ BrowserWindow,
+ dialog,
+ ipcMain,
+ session,
+ systemPreferences,
+} = require("electron");
const path = require("path");
const http = require("http");
require("dotenv").config({ path: path.join(__dirname, ".env") });
@@ -802,6 +810,33 @@ async function startApp() {
globeKeyManager.start();
+ // After starting globe-listener, check if accessibility is granted.
+ // If not, notify both windows so they can prompt the user.
+ const checkAndNotifyAccessibility = () => {
+ if (!systemPreferences.isTrustedAccessibilityClient(false)) {
+ debugLogger.info("[Accessibility] macOS accessibility not trusted — notifying renderers");
+ if (isLiveWindow(windowManager.controlPanelWindow)) {
+ windowManager.controlPanelWindow.webContents.send("accessibility-missing");
+ }
+ if (isLiveWindow(windowManager.mainWindow)) {
+ windowManager.mainWindow.webContents.send("accessibility-missing");
+ }
+ }
+ };
+
+ // Check shortly after startup (give windows time to load)
+ setTimeout(checkAndNotifyAccessibility, 3000);
+
+ // Allow renderer to request an accessibility check (e.g. on sign-in).
+ // Also sends accessibility-missing events if untrusted.
+ ipcMain.handle("check-accessibility-trusted", () => {
+ const trusted = systemPreferences.isTrustedAccessibilityClient(false);
+ if (!trusted) {
+ checkAndNotifyAccessibility();
+ }
+ return trusted;
+ });
+
// Reset native key state when hotkey changes
ipcMain.on("hotkey-changed", (_event, _newHotkey) => {
globeKeyDownTime = 0;
diff --git a/preload.js b/preload.js
index 9e12ea101..b9328a141 100644
--- a/preload.js
+++ b/preload.js
@@ -520,6 +520,14 @@ contextBridge.exposeInMainWorld("electronAPI", {
},
onWindowsPushToTalkUnavailable: registerListener("windows-ptt-unavailable"),
+ // Accessibility permission events (macOS)
+ onAccessibilityMissing: (callback) => {
+ const listener = () => callback?.();
+ ipcRenderer.on("accessibility-missing", listener);
+ return () => ipcRenderer.removeListener("accessibility-missing", listener);
+ },
+ checkAccessibilityTrusted: () => ipcRenderer.invoke("check-accessibility-trusted"),
+
// Notify main process of activation mode changes (for Windows Push-to-Talk)
notifyActivationModeChanged: (mode) => ipcRenderer.send("activation-mode-changed", mode),
notifyHotkeyChanged: (hotkey) => ipcRenderer.send("hotkey-changed", hotkey),
diff --git a/src/App.jsx b/src/App.jsx
index f8bf7db04..7bc72af4f 100644
--- a/src/App.jsx
+++ b/src/App.jsx
@@ -113,6 +113,14 @@ export default function App() {
});
});
+ const unsubscribeAccessibility = window.electronAPI?.onAccessibilityMissing?.(() => {
+ toast({
+ title: t("app.toasts.accessibilityMissing.title"),
+ description: t("app.toasts.accessibilityMissing.description"),
+ duration: 12000,
+ });
+ });
+
const unsubscribeCorrections = window.electronAPI?.onCorrectionsLearned?.((words) => {
if (words && words.length > 0) {
const wordList = words.map((w) => `\u201c${w}\u201d`).join(", ");
@@ -149,6 +157,7 @@ export default function App() {
return () => {
unsubscribeFallback?.();
unsubscribeFailed?.();
+ unsubscribeAccessibility?.();
unsubscribeCorrections?.();
};
}, [toast, dismiss, t]);
diff --git a/src/components/ControlPanel.tsx b/src/components/ControlPanel.tsx
index fa17eac03..7825b70c5 100644
--- a/src/components/ControlPanel.tsx
+++ b/src/components/ControlPanel.tsx
@@ -214,6 +214,20 @@ export default function ControlPanel() {
return () => cleanup?.();
}, []);
+ // When accessibility is missing on macOS, open the permissions settings page
+ useEffect(() => {
+ const cleanup = window.electronAPI?.onAccessibilityMissing?.(() => {
+ setSettingsSection("privacyData");
+ setShowSettings(true);
+ toast({
+ title: t("controlPanel.accessibilityMissing.title"),
+ description: t("controlPanel.accessibilityMissing.description"),
+ duration: 10000,
+ });
+ });
+ return () => cleanup?.();
+ }, [toast, t]);
+
const handleMeetingRecordingRequestHandled = useCallback(
() => setMeetingRecordingRequest(null),
[]
diff --git a/src/locales/de/translation.json b/src/locales/de/translation.json
index e2d3270e3..673d617dc 100644
--- a/src/locales/de/translation.json
+++ b/src/locales/de/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "Wochenlimit erreicht",
"weeklyDescription": "Ihr Limit setzt sich rollierend zurück. Upgraden Sie auf Pro oder nutzen Sie Ihren eigenen API-Schlüssel für unbegrenzte Nutzung."
},
+ "accessibilityMissing": {
+ "title": "Bedienungshilfen-Berechtigungen benötigt",
+ "description": "Wir haben festgestellt, dass OpenWhispr Bedienungshilfen-Berechtigungen benötigt, um korrekt zu funktionieren. Bitte aktivieren Sie diese unten."
+ },
"billing": {
"pastDueTitle": "Ihre Zahlung konnte nicht verarbeitet werden",
"pastDueDescription": "Keine Sorge – Sie sind vorerst im kostenlosen Tarif. Aktualisieren Sie Ihre Zahlungsdaten in den Einstellungen, um wieder Pro zu erhalten.",
@@ -1667,7 +1671,11 @@
"description": "Die ausgewählte Tastenkombination konnte nicht registriert werden. Bitte wähle eine andere in den Einstellungen."
},
"addedToDict": "{{words}} zu deinem Wörterbuch hinzugefügt",
- "undo": "Rückgängig"
+ "undo": "Rückgängig",
+ "accessibilityMissing": {
+ "title": "Bedienungshilfen-Berechtigungen erforderlich",
+ "description": "OpenWhispr benötigt Bedienungshilfen-Berechtigungen, um Ihren Hotkey zu erkennen und Text einzufügen. Bitte aktivieren Sie diese in der Systemsteuerung."
+ }
},
"mic": {
"hotkeyToSpeak": "{{hotkey}} drücken zum Sprechen",
diff --git a/src/locales/en/translation.json b/src/locales/en/translation.json
index 0f640b265..7c871e165 100644
--- a/src/locales/en/translation.json
+++ b/src/locales/en/translation.json
@@ -202,6 +202,10 @@
"weeklyTitle": "Weekly limit reached",
"weeklyDescription": "Your limit resets on a rolling basis. Upgrade to Pro or use your own API key for unlimited use."
},
+ "accessibilityMissing": {
+ "title": "Accessibility permissions needed",
+ "description": "We've detected that OpenWhispr needs accessibility permissions to work properly. Please enable them below."
+ },
"billing": {
"pastDueTitle": "We couldn't process your payment",
"pastDueDescription": "Don't worry - you're on the free plan for now. Update your payment in Settings to get back to Pro.",
@@ -1743,7 +1747,11 @@
"description": "The selected hotkey could not be registered. Please choose a different one in settings."
},
"addedToDict": "Added {{words}} to your dictionary",
- "undo": "Undo"
+ "undo": "Undo",
+ "accessibilityMissing": {
+ "title": "Accessibility permissions required",
+ "description": "OpenWhispr needs accessibility permissions to detect your hotkey and paste text. Please enable them in the Control Panel."
+ }
},
"mic": {
"hotkeyToSpeak": "Press {{hotkey}} to speak",
diff --git a/src/locales/es/translation.json b/src/locales/es/translation.json
index dbfb33b8b..3dfa3e410 100644
--- a/src/locales/es/translation.json
+++ b/src/locales/es/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "Límite semanal alcanzado",
"weeklyDescription": "Tu límite se restablece de forma continua. Mejora a Pro o usa tu propia clave API para uso ilimitado."
},
+ "accessibilityMissing": {
+ "title": "Se necesitan permisos de accesibilidad",
+ "description": "Hemos detectado que OpenWhispr necesita permisos de accesibilidad para funcionar correctamente. Actívalos a continuación."
+ },
"billing": {
"pastDueTitle": "No pudimos procesar tu pago",
"pastDueDescription": "No te preocupes: estás en el plan gratuito por ahora. Actualiza tu pago en Ajustes para volver a Pro.",
@@ -1671,7 +1675,11 @@
"description": "No se pudo registrar el atajo seleccionado. Elige otro en la configuración."
},
"addedToDict": "{{words}} añadido a tu diccionario",
- "undo": "Deshacer"
+ "undo": "Deshacer",
+ "accessibilityMissing": {
+ "title": "Se requieren permisos de accesibilidad",
+ "description": "OpenWhispr necesita permisos de accesibilidad para detectar tu atajo y pegar texto. Actívalos en el Panel de Control."
+ }
},
"mic": {
"hotkeyToSpeak": "Pulsa {{hotkey}} para hablar",
diff --git a/src/locales/fr/translation.json b/src/locales/fr/translation.json
index 47de879ff..b8558829f 100644
--- a/src/locales/fr/translation.json
+++ b/src/locales/fr/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "Limite hebdomadaire atteinte",
"weeklyDescription": "Votre limite se renouvelle de manière glissante. Passez à Pro ou utilisez votre propre clé API pour un usage illimité."
},
+ "accessibilityMissing": {
+ "title": "Autorisations d'accessibilité nécessaires",
+ "description": "Nous avons détecté qu'OpenWhispr a besoin des autorisations d'accessibilité pour fonctionner correctement. Veuillez les activer ci-dessous."
+ },
"billing": {
"pastDueTitle": "Nous n'avons pas pu traiter votre paiement",
"pastDueDescription": "Pas de souci : vous êtes temporairement sur le plan gratuit. Mettez à jour votre paiement dans Paramètres pour revenir à Pro.",
@@ -1671,7 +1675,11 @@
"description": "Le raccourci sélectionné n’a pas pu être enregistré. Veuillez en choisir un autre dans les paramètres."
},
"addedToDict": "{{words}} ajouté à votre dictionnaire",
- "undo": "Annuler"
+ "undo": "Annuler",
+ "accessibilityMissing": {
+ "title": "Autorisations d'accessibilité requises",
+ "description": "OpenWhispr a besoin des autorisations d'accessibilité pour détecter votre raccourci et coller du texte. Veuillez les activer dans le Panneau de configuration."
+ }
},
"mic": {
"hotkeyToSpeak": "Appuyez sur {{hotkey}} pour parler",
diff --git a/src/locales/it/translation.json b/src/locales/it/translation.json
index 3db1b8685..4cdec2234 100644
--- a/src/locales/it/translation.json
+++ b/src/locales/it/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "Limite settimanale raggiunto",
"weeklyDescription": "Il limite si rinnova in modo progressivo. Passa a Pro o usa la tua chiave API per un uso illimitato."
},
+ "accessibilityMissing": {
+ "title": "Autorizzazioni di accessibilità necessarie",
+ "description": "Abbiamo rilevato che OpenWhispr ha bisogno delle autorizzazioni di accessibilità per funzionare correttamente. Abilitale qui sotto."
+ },
"billing": {
"pastDueTitle": "Non siamo riusciti a elaborare il pagamento",
"pastDueDescription": "Nessun problema: sei nel piano gratuito per ora. Aggiorna il pagamento nelle Impostazioni per tornare a Pro.",
@@ -1671,7 +1675,11 @@
"description": "Non è stato possibile registrare la scorciatoia selezionata. Scegline un’altra nelle impostazioni."
},
"addedToDict": "{{words}} aggiunto al tuo dizionario",
- "undo": "Annulla"
+ "undo": "Annulla",
+ "accessibilityMissing": {
+ "title": "Autorizzazioni di accessibilità richieste",
+ "description": "OpenWhispr necessita delle autorizzazioni di accessibilità per rilevare il tasto di scelta rapida e incollare il testo. Abilitale nel Pannello di controllo."
+ }
},
"mic": {
"hotkeyToSpeak": "Premi {{hotkey}} per parlare",
diff --git a/src/locales/ja/translation.json b/src/locales/ja/translation.json
index 4d476ecd1..948a52cdb 100644
--- a/src/locales/ja/translation.json
+++ b/src/locales/ja/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "週間の利用上限に達しました",
"weeklyDescription": "利用上限はローリング方式でリセットされます。Pro にアップグレードするか、自分の API キーを使用して無制限にご利用ください。"
},
+ "accessibilityMissing": {
+ "title": "アクセシビリティの許可が必要です",
+ "description": "OpenWhispr が正しく動作するにはアクセシビリティの許可が必要です。以下で有効にしてください。"
+ },
"billing": {
"pastDueTitle": "お支払いを処理できませんでした",
"pastDueDescription": "ご安心ください。現在は無料プランをご利用中です。設定からお支払い方法を更新して Pro に戻しましょう。",
@@ -1667,7 +1671,11 @@
"description": "選択したホットキーを登録できませんでした。設定から別のホットキーを選択してください。"
},
"addedToDict": "{{words}} を辞書に追加しました",
- "undo": "元に戻す"
+ "undo": "元に戻す",
+ "accessibilityMissing": {
+ "title": "アクセシビリティの許可が必要です",
+ "description": "OpenWhispr がホットキーの検出とテキストの貼り付けを行うには、アクセシビリティの許可が必要です。コントロールパネルで有効にしてください。"
+ }
},
"mic": {
"hotkeyToSpeak": "{{hotkey}} を押して話す",
diff --git a/src/locales/pt/translation.json b/src/locales/pt/translation.json
index a9d6d3e83..04f3e3133 100644
--- a/src/locales/pt/translation.json
+++ b/src/locales/pt/translation.json
@@ -171,6 +171,10 @@
"weeklyTitle": "Limite semanal atingido",
"weeklyDescription": "Seu limite é redefinido continuamente. Faça upgrade para Pro ou use sua própria chave API para uso ilimitado."
},
+ "accessibilityMissing": {
+ "title": "Permissões de acessibilidade necessárias",
+ "description": "Detectamos que o OpenWhispr precisa de permissões de acessibilidade para funcionar corretamente. Ative-as abaixo."
+ },
"billing": {
"pastDueTitle": "Não foi possível processar seu pagamento",
"pastDueDescription": "Sem problemas — você está no plano gratuito por enquanto. Atualize o pagamento em Configurações para voltar ao Pro.",
@@ -1671,7 +1675,11 @@
"description": "Não foi possível registrar o atalho selecionado. Escolha outro nas configurações."
},
"addedToDict": "{{words}} adicionado ao seu dicionário",
- "undo": "Desfazer"
+ "undo": "Desfazer",
+ "accessibilityMissing": {
+ "title": "Permissões de acessibilidade necessárias",
+ "description": "O OpenWhispr precisa de permissões de acessibilidade para detectar seu atalho e colar texto. Ative-as no Painel de Controle."
+ }
},
"mic": {
"hotkeyToSpeak": "Pressione {{hotkey}} para falar",
diff --git a/src/locales/ru/translation.json b/src/locales/ru/translation.json
index 0f89ded15..932ffd483 100644
--- a/src/locales/ru/translation.json
+++ b/src/locales/ru/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "Недельный лимит достигнут",
"weeklyDescription": "Ваш лимит обновляется на скользящей основе. Перейдите на Pro или используйте свой API-ключ для безлимитного использования."
},
+ "accessibilityMissing": {
+ "title": "Необходимы разрешения универсального доступа",
+ "description": "Мы обнаружили, что OpenWhispr нуждается в разрешениях универсального доступа для корректной работы. Включите их ниже."
+ },
"billing": {
"pastDueTitle": "Не удалось обработать платёж",
"pastDueDescription": "Не волнуйтесь — сейчас вы на бесплатном плане. Обновите способ оплаты в настройках, чтобы вернуться к Pro.",
@@ -1671,7 +1675,11 @@
"description": "Не удалось зарегистрировать выбранную комбинацию. Выберите другую в настройках."
},
"addedToDict": "{{words}} добавлено в ваш словарь",
- "undo": "Отменить"
+ "undo": "Отменить",
+ "accessibilityMissing": {
+ "title": "Требуются разрешения универсального доступа",
+ "description": "OpenWhispr нужны разрешения универсального доступа для распознавания горячей клавиши и вставки текста. Включите их в Панели управления."
+ }
},
"mic": {
"hotkeyToSpeak": "Нажмите {{hotkey}} для записи",
diff --git a/src/locales/zh-CN/translation.json b/src/locales/zh-CN/translation.json
index d199f7513..a7fee90f4 100644
--- a/src/locales/zh-CN/translation.json
+++ b/src/locales/zh-CN/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "已达到周限额",
"weeklyDescription": "你的额度按滚动方式重置。升级到 Pro 或使用自己的 API Key 可不受限制。"
},
+ "accessibilityMissing": {
+ "title": "需要辅助功能权限",
+ "description": "我们检测到 OpenWhispr 需要辅助功能权限才能正常工作。请在下方启用。"
+ },
"billing": {
"pastDueTitle": "我们无法处理你的付款",
"pastDueDescription": "别担心——你目前使用的是免费版。在设置中更新支付方式即可恢复 Pro 版。",
@@ -1667,7 +1671,11 @@
"description": "无法注册所选快捷键。请在设置中选择其他快捷键。"
},
"addedToDict": "已将 {{words}} 添加到你的词典",
- "undo": "撤消"
+ "undo": "撤消",
+ "accessibilityMissing": {
+ "title": "需要辅助功能权限",
+ "description": "OpenWhispr 需要辅助功能权限来检测快捷键和粘贴文本。请在控制面板中启用。"
+ }
},
"mic": {
"hotkeyToSpeak": "按 {{hotkey}} 开始说话",
diff --git a/src/locales/zh-TW/translation.json b/src/locales/zh-TW/translation.json
index e85ee9a1e..d9893a2ba 100644
--- a/src/locales/zh-TW/translation.json
+++ b/src/locales/zh-TW/translation.json
@@ -199,6 +199,10 @@
"weeklyTitle": "已達每週使用上限",
"weeklyDescription": "你的額度為滾動式重置。升級至 Pro 或使用自己的 API Key 即可無限使用。"
},
+ "accessibilityMissing": {
+ "title": "需要輔助使用權限",
+ "description": "我們偵測到 OpenWhispr 需要輔助使用權限才能正常運作。請在下方啟用。"
+ },
"billing": {
"pastDueTitle": "我們無法處理你的付款",
"pastDueDescription": "別擔心,你目前使用的是免費方案。在設定中更新付款方式即可恢復 Pro。",
@@ -1667,7 +1671,11 @@
"description": "無法註冊所選快捷鍵。請在設定中選擇其他快捷鍵。"
},
"addedToDict": "已將 {{words}} 加入到你的詞典",
- "undo": "復原"
+ "undo": "復原",
+ "accessibilityMissing": {
+ "title": "需要輔助使用權限",
+ "description": "OpenWhispr 需要輔助使用權限來偵測快捷鍵和貼上文字。請在控制面板中啟用。"
+ }
},
"mic": {
"hotkeyToSpeak": "按 {{hotkey}} 開始說話",
diff --git a/src/main.jsx b/src/main.jsx
index 71680a76a..3350dbfd2 100644
--- a/src/main.jsx
+++ b/src/main.jsx
@@ -322,7 +322,8 @@ function MainApp() {
localStorage.getItem("skipAuth") === "true";
// Valid session proves prior onboarding — restore flag if localStorage was wiped
- if (!onboardingCompleted && isSignedIn) {
+ const isReturningUser = !onboardingCompleted && isSignedIn;
+ if (isReturningUser) {
localStorage.setItem("onboardingCompleted", "true");
}
@@ -334,6 +335,12 @@ function MainApp() {
} else if (!isSignedIn && !authSkipped) {
setNeedsReauth(true);
}
+
+ // Returning users who skipped onboarding may lack accessibility permissions.
+ // Trigger an immediate check so the main process sends accessibility-missing.
+ if (isReturningUser) {
+ window.electronAPI?.checkAccessibilityTrusted?.();
+ }
}
if (isDictationPanel && !resolved) {
diff --git a/src/types/electron.ts b/src/types/electron.ts
index c7815b2b3..4a6bc71f1 100644
--- a/src/types/electron.ts
+++ b/src/types/electron.ts
@@ -662,6 +662,10 @@ declare global {
callback: (data: { hotkey: string; error: string; suggestions: string[] }) => void
) => () => void;
+ // Accessibility permission events (macOS)
+ onAccessibilityMissing?: (callback: () => void) => () => void;
+ checkAccessibilityTrusted?: () => Promise<boolean>;
+
// Gemini API key management
getGeminiKey: () => Promise<string | null>;
saveGeminiKey: (key: string) => Promise<void>;