Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
fix(macos): notify users when accessibility permissions are missing
Gabriel Stein547cf22b5f3e
diff --git a/main.js b/main.jsindex 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 changesipcMain.on("hotkey-changed", (_event, _newHotkey) => {globeKeyDownTime = 0;diff --git a/preload.js b/preload.jsindex 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.jsxindex 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.tsxindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsxindex 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.tsindex 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 managementgetGeminiKey: () => Promise<string | null>;saveGeminiKey: (key: string) => Promise<void>;