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
feat(auth): add post-login permissions gate for returning users
Gabriel Stein30955e704f56
diff --git a/preload.js b/preload.jsindex e87287ade..26a2c0ca6 100644--- a/preload.js+++ b/preload.js@@ -170,6 +170,8 @@ contextBridge.exposeInMainWorld("electronAPI", {// Clipboard functionscheckAccessibilityPermission: (silent) =>ipcRenderer.invoke("check-accessibility-permission", silent),+ promptAccessibilityPermission: () =>+ ipcRenderer.invoke("prompt-accessibility-permission"),readClipboard: () => ipcRenderer.invoke("read-clipboard"),writeClipboard: (text) => ipcRenderer.invoke("write-clipboard", text),checkPasteTools: () => ipcRenderer.invoke("check-paste-tools"),diff --git a/src/components/OnboardingFlow.tsx b/src/components/OnboardingFlow.tsxindex a6a266b51..1c6523fc5 100644--- a/src/components/OnboardingFlow.tsx+++ b/src/components/OnboardingFlow.tsx@@ -8,18 +8,14 @@ import {ChevronLeft,Check,Settings,- Mic,Shield,Command,UserCircle,- Monitor,} from "lucide-react";import TitleBar from "./TitleBar";import WindowControls from "./WindowControls";-import PermissionCard from "./ui/PermissionCard";+import PermissionsSection from "./ui/PermissionsSection";import SupportDropdown from "./ui/SupportDropdown";-import MicPermissionWarning from "./ui/MicPermissionWarning";-import PasteToolsInfo from "./ui/PasteToolsInfo";import StepProgress from "./ui/StepProgress";import { AlertDialog, ConfirmDialog } from "./ui/dialog";import { useLocalStorage } from "../hooks/useLocalStorage";@@ -41,6 +37,7 @@ import { getPlatform } from "../utils/platform";import logger from "../utils/logger";import { ActivationModeSelector } from "./ui/ActivationModeSelector";import TranscriptionModelPicker from "./TranscriptionModelPicker";+import { areRequiredPermissionsMet } from "../utils/permissions";interface OnboardingFlowProps {onComplete: () => void;@@ -391,61 +388,7 @@ export default function OnboardingFlow({ onComplete }: OnboardingFlowProps) {<h3 className="text-sm font-medium text-foreground">{t("onboarding.permissions.title")}</h3>- <div className="space-y-1.5">- <PermissionCard- icon={Mic}- title={t("onboarding.permissions.microphoneTitle")}- description={t("onboarding.permissions.microphoneDescription")}- granted={permissionsHook.micPermissionGranted}- onRequest={permissionsHook.requestMicPermission}- buttonText={t("onboarding.permissions.grant")}- />-- {isMacOS && (- <>- <PermissionCard- icon={Shield}- title={t("onboarding.permissions.accessibilityTitle")}- description={t("onboarding.permissions.accessibilityDescription")}- granted={permissionsHook.accessibilityPermissionGranted}- onRequest={permissionsHook.testAccessibilityPermission}- buttonText={t("onboarding.permissions.testAndGrant")}- onOpenSettings={permissionsHook.openAccessibilitySettings}- openSettingsText={t("onboarding.permissions.openSystemSettings")}- />- <PermissionCard- icon={Monitor}- title={t("onboarding.permissions.systemAudioTitle")}- description={t("onboarding.permissions.systemAudioDescription")}- granted={systemAudio.granted}- onRequest={systemAudio.request}- buttonText={t("onboarding.permissions.grant")}- onOpenSettings={systemAudio.openSettings}- badge={t("onboarding.permissions.optional")}- />- </>- )}- </div>-- {/* Error state - only show when there's actually an issue */}- {!permissionsHook.micPermissionGranted && permissionsHook.micPermissionError && (- <MicPermissionWarning- error={permissionsHook.micPermissionError}- onOpenSoundSettings={permissionsHook.openSoundInputSettings}- onOpenPrivacySettings={permissionsHook.openMicPrivacySettings}- />- )}-- {/* Linux paste tools - only when needed */}- {platform === "linux" &&- permissionsHook.pasteToolsInfo &&- !permissionsHook.pasteToolsInfo.available && (- <PasteToolsInfo- pasteToolsInfo={permissionsHook.pasteToolsInfo}- isChecking={permissionsHook.isCheckingPasteTools}- onCheck={permissionsHook.checkPasteToolsAvailability}- />- )}+ <PermissionsSection permissions={permissionsHook} systemAudio={systemAudio} /></div></div>);@@ -551,62 +494,7 @@ export default function OnboardingFlow({ onComplete }: OnboardingFlowProps) {</p></div>- {/* Permission cards - tight stack */}- <div className="space-y-1.5">- <PermissionCard- icon={Mic}- title={t("onboarding.permissions.microphoneTitle")}- description={t("onboarding.permissions.microphoneDescription")}- granted={permissionsHook.micPermissionGranted}- onRequest={permissionsHook.requestMicPermission}- buttonText={t("onboarding.permissions.grant")}- />-- {isMacOS && (- <>- <PermissionCard- icon={Shield}- title={t("onboarding.permissions.accessibilityTitle")}- description={t("onboarding.permissions.accessibilityDescription")}- granted={permissionsHook.accessibilityPermissionGranted}- onRequest={permissionsHook.testAccessibilityPermission}- buttonText={t("onboarding.permissions.testAndGrant")}- onOpenSettings={permissionsHook.openAccessibilitySettings}- openSettingsText={t("onboarding.permissions.openSystemSettings")}- />- <PermissionCard- icon={Monitor}- title={t("onboarding.permissions.systemAudioTitle")}- description={t("onboarding.permissions.systemAudioDescription")}- granted={systemAudio.granted}- onRequest={systemAudio.request}- buttonText={t("onboarding.permissions.grant")}- onOpenSettings={systemAudio.openSettings}- badge={t("onboarding.permissions.optional")}- />- </>- )}- </div>-- {/* Error state - only show when there's actually an issue */}- {!permissionsHook.micPermissionGranted && permissionsHook.micPermissionError && (- <MicPermissionWarning- error={permissionsHook.micPermissionError}- onOpenSoundSettings={permissionsHook.openSoundInputSettings}- onOpenPrivacySettings={permissionsHook.openMicPrivacySettings}- />- )}-- {/* Linux paste tools - only when needed */}- {platform === "linux" &&- permissionsHook.pasteToolsInfo &&- !permissionsHook.pasteToolsInfo.available && (- <PasteToolsInfo- pasteToolsInfo={permissionsHook.pasteToolsInfo}- isChecking={permissionsHook.isCheckingPasteTools}- onCheck={permissionsHook.checkPasteToolsAvailability}- />- )}+ <PermissionsSection permissions={permissionsHook} systemAudio={systemAudio} /></div>);@@ -701,15 +589,11 @@ export default function OnboardingFlow({ onComplete }: OnboardingFlowProps) {case 1:// For signed-in users: Setup step includes permissionsif (isSignedIn && !skipAuth) {- // Check permissions- if (!permissionsHook.micPermissionGranted) {- return false;- }- const currentPlatform = permissionsHook.pasteToolsInfo?.platform;- if (currentPlatform === "darwin") {- return permissionsHook.accessibilityPermissionGranted;- }- return true;+ return areRequiredPermissionsMet(+ permissionsHook.micPermissionGranted,+ permissionsHook.accessibilityPermissionGranted,+ permissionsHook.pasteToolsInfo?.platform+ );}// For non-signed-in users: Setup - check if configuration is complete@@ -738,14 +622,11 @@ export default function OnboardingFlow({ onComplete }: OnboardingFlowProps) {}// For non-signed-in users, this is permissions step- if (!permissionsHook.micPermissionGranted) {- return false;- }- const currentPlatform = permissionsHook.pasteToolsInfo?.platform;- if (currentPlatform === "darwin") {- return permissionsHook.accessibilityPermissionGranted;- }- return true;+ return areRequiredPermissionsMet(+ permissionsHook.micPermissionGranted,+ permissionsHook.accessibilityPermissionGranted,+ permissionsHook.pasteToolsInfo?.platform+ );}case 3:return hotkey.trim() !== ""; // Activation step for non-signed-in usersdiff --git a/src/components/PermissionsGate.tsx b/src/components/PermissionsGate.tsxnew file mode 100644index 000000000..818488e5a--- /dev/null+++ b/src/components/PermissionsGate.tsx@@ -0,0 +1,81 @@+import { useTranslation } from "react-i18next";+import { Shield, Check } from "lucide-react";+import { Card, CardContent } from "./ui/card";+import { Button } from "./ui/button";+import WindowControls from "./WindowControls";+import PermissionsSection from "./ui/PermissionsSection";+import { AlertDialog } from "./ui/dialog";+import { useDialogs } from "../hooks/useDialogs";+import { usePermissions } from "../hooks/usePermissions";+import { useSystemAudioPermission } from "../hooks/useSystemAudioPermission";+import { areRequiredPermissionsMet } from "../utils/permissions";++interface PermissionsGateProps {+ onComplete: () => void;+}++export default function PermissionsGate({ onComplete }: PermissionsGateProps) {+ const { t } = useTranslation();+ const { alertDialog, showAlertDialog, hideAlertDialog } = useDialogs();+ const permissions = usePermissions(showAlertDialog);+ const systemAudio = useSystemAudioPermission();++ const requiredMet =+ permissions.pasteToolsInfo !== null &&+ areRequiredPermissionsMet(+ permissions.micPermissionGranted,+ permissions.accessibilityPermissionGranted,+ permissions.pasteToolsInfo?.platform+ );++ return (+ <div+ className="h-screen flex flex-col bg-background"+ style={{ paddingTop: "env(safe-area-inset-top, 0px)" }}+ >+ <AlertDialog+ open={alertDialog.open}+ onOpenChange={(open: boolean) => !open && hideAlertDialog()}+ title={alertDialog.title}+ description={alertDialog.description}+ onOk={() => {}}+ />++ <div+ className="flex items-center justify-end w-full h-10 shrink-0"+ style={{ WebkitAppRegion: "drag" } as React.CSSProperties}+ >+ {window.electronAPI?.getPlatform?.() !== "darwin" && (+ <div className="pr-1" style={{ WebkitAppRegion: "no-drag" } as React.CSSProperties}>+ <WindowControls />+ </div>+ )}+ </div>++ <div className="flex-1 px-6 overflow-y-auto flex items-center">+ <div className="w-full max-w-sm mx-auto">+ <Card className="bg-card/90 backdrop-blur-2xl border border-border/50 dark:border-white/5 shadow-lg rounded-xl overflow-hidden">+ <CardContent className="p-6 space-y-6">+ <div className="text-center">+ <div className="w-14 h-14 bg-primary/10 rounded-full flex items-center justify-center mx-auto mb-4">+ <Shield className="w-7 h-7 text-primary" />+ </div>+ <h2 className="text-2xl font-semibold text-foreground mb-2">+ {t("permissionsGate.title")}+ </h2>+ <p className="text-muted-foreground">{t("permissionsGate.description")}</p>+ </div>++ <PermissionsSection permissions={permissions} systemAudio={systemAudio} />++ <Button onClick={onComplete} disabled={!requiredMet} className="w-full">+ <Check className="w-4 h-4" />+ {t("permissionsGate.continue")}+ </Button>+ </CardContent>+ </Card>+ </div>+ </div>+ </div>+ );+}diff --git a/src/components/ui/PermissionCard.tsx b/src/components/ui/PermissionCard.tsxindex b1710768f..aead34895 100644--- a/src/components/ui/PermissionCard.tsx+++ b/src/components/ui/PermissionCard.tsx@@ -12,6 +12,7 @@ interface PermissionCardProps {onOpenSettings?: () => void;badge?: string;openSettingsText?: string;+ hint?: string;}export default function PermissionCard({@@ -24,6 +25,7 @@ export default function PermissionCard({onOpenSettings,badge,openSettingsText,+ hint,}: PermissionCardProps) {return (<div@@ -93,6 +95,13 @@ export default function PermissionCard({</div>)}</div>++ {/* Troubleshooting hint */}+ {hint && !granted && (+ <p className="text-[11px] text-warning/80 leading-snug mt-2 pl-11">+ {hint}+ </p>+ )}</div>);}diff --git a/src/components/ui/PermissionsSection.tsx b/src/components/ui/PermissionsSection.tsxnew file mode 100644index 000000000..1f7d44e2b--- /dev/null+++ b/src/components/ui/PermissionsSection.tsx@@ -0,0 +1,85 @@+import { useTranslation } from "react-i18next";+import { Mic, Shield, Monitor } from "lucide-react";+import PermissionCard from "./PermissionCard";+import MicPermissionWarning from "./MicPermissionWarning";+import PasteToolsInfo from "./PasteToolsInfo";+import type { UsePermissionsReturn } from "../../hooks/usePermissions";++interface PermissionsSectionProps {+ permissions: UsePermissionsReturn;+ systemAudio: {+ granted: boolean;+ request: () => Promise<boolean>;+ openSettings: () => Promise<void>;+ };+}++export default function PermissionsSection({ permissions, systemAudio }: PermissionsSectionProps) {+ const { t } = useTranslation();+ const platform = permissions.pasteToolsInfo?.platform;+ const isMacOS = platform === "darwin";++ return (+ <>+ <div className="space-y-1.5">+ <PermissionCard+ icon={Mic}+ title={t("onboarding.permissions.microphoneTitle")}+ description={t("onboarding.permissions.microphoneDescription")}+ granted={permissions.micPermissionGranted}+ onRequest={permissions.requestMicPermission}+ buttonText={t("onboarding.permissions.grant")}+ />++ {isMacOS && (+ <>+ <PermissionCard+ icon={Shield}+ title={t("onboarding.permissions.accessibilityTitle")}+ description={t("onboarding.permissions.accessibilityDescription")}+ granted={permissions.accessibilityPermissionGranted}+ onRequest={permissions.testAccessibilityPermission}+ buttonText={t("onboarding.permissions.testAndGrant")}+ onOpenSettings={permissions.openAccessibilitySettings}+ openSettingsText={t("onboarding.permissions.openSystemSettings")}+ badge={t("onboarding.permissions.recommended")}+ hint={+ permissions.accessibilityTroubleshooting+ ? t("onboarding.permissions.accessibilityTroubleshooting")+ : undefined+ }+ />+ <PermissionCard+ icon={Monitor}+ title={t("onboarding.permissions.systemAudioTitle")}+ description={t("onboarding.permissions.systemAudioDescription")}+ granted={systemAudio.granted}+ onRequest={systemAudio.request}+ buttonText={t("onboarding.permissions.grant")}+ onOpenSettings={systemAudio.openSettings}+ badge={t("onboarding.permissions.optional")}+ />+ </>+ )}+ </div>++ {!permissions.micPermissionGranted && permissions.micPermissionError && (+ <MicPermissionWarning+ error={permissions.micPermissionError}+ onOpenSoundSettings={permissions.openSoundInputSettings}+ onOpenPrivacySettings={permissions.openMicPrivacySettings}+ />+ )}++ {platform === "linux" &&+ permissions.pasteToolsInfo &&+ !permissions.pasteToolsInfo.available && (+ <PasteToolsInfo+ pasteToolsInfo={permissions.pasteToolsInfo}+ isChecking={permissions.isCheckingPasteTools}+ onCheck={permissions.checkPasteToolsAvailability}+ />+ )}+ </>+ );+}diff --git a/src/helpers/ipcHandlers.js b/src/helpers/ipcHandlers.jsindex 7a7fcd640..8e67af09d 100644--- a/src/helpers/ipcHandlers.js+++ b/src/helpers/ipcHandlers.js@@ -799,6 +799,13 @@ class IPCHandlers {return this.clipboardManager.checkAccessibilityPermissions(silent);});+ // Passes `true` to isTrustedAccessibilityClient to trigger the macOS system prompt+ ipcMain.handle("prompt-accessibility-permission", async () => {+ if (process.platform !== "darwin") return true;+ const { systemPreferences } = require("electron");+ return systemPreferences.isTrustedAccessibilityClient(true);+ });+ipcMain.handle("read-clipboard", async (event) => {return this.clipboardManager.readClipboard();});diff --git a/src/hooks/usePermissions.ts b/src/hooks/usePermissions.tsindex 8c3636de5..93d0c7d33 100644--- a/src/hooks/usePermissions.ts+++ b/src/hooks/usePermissions.ts@@ -1,4 +1,4 @@-import { useState, useCallback, useEffect } from "react";+import { useState, useCallback, useEffect, useRef } from "react";import type { TFunction } from "i18next";import { useTranslation } from "react-i18next";import type { PasteToolsResult } from "../types/electron";@@ -11,6 +11,7 @@ export interface UsePermissionsReturn {micPermissionError: string | null;pasteToolsInfo: PasteToolsResult | null;isCheckingPasteTools: boolean;+ accessibilityTroubleshooting: boolean;requestMicPermission: () => Promise<void>;testAccessibilityPermission: () => Promise<void>;@@ -124,6 +125,9 @@ export const usePermissions = ();const [pasteToolsInfo, setPasteToolsInfo] = useState<PasteToolsResult | null>(null);const [isCheckingPasteTools, setIsCheckingPasteTools] = useState(false);+ const [accessibilityTroubleshooting, setAccessibilityTroubleshooting] = useState(false);+ const accessibilityPollCount = useRef(0);+ const hasPromptedAccessibility = useRef(false);const openSystemSettings = useCallback(async (@@ -166,10 +170,18 @@ export const usePermissions = ([openSystemSettings]);- const openAccessibilitySettings = useCallback(- () => openSystemSettings("accessibility", window.electronAPI?.openAccessibilitySettings),- [openSystemSettings]- );+ const openAccessibilitySettings = useCallback(async () => {+ // On first click, trigger the macOS system prompt to create a TCC entry+ if (!hasPromptedAccessibility.current) {+ hasPromptedAccessibility.current = true;+ try {+ await window.electronAPI?.promptAccessibilityPermission?.();+ } catch {+ // Ignore — falls through to opening System Settings+ }+ }+ await openSystemSettings("accessibility", window.electronAPI?.openAccessibilitySettings);+ }, [openSystemSettings]);const requestMicPermission = useCallback(async () => {if (!navigator?.mediaDevices || typeof navigator.mediaDevices.getUserMedia !== "function") {@@ -258,12 +270,24 @@ export const usePermissions = (// Poll for accessibility permission changes on macOS (e.g. user grants in System Settings)useEffect(() => {if (getPlatform() !== "darwin") return;- if (accessibilityPermissionGranted) return;+ if (accessibilityPermissionGranted) {+ setAccessibilityTroubleshooting(false);+ accessibilityPollCount.current = 0;+ return;+ }const interval = setInterval(() => {window.electronAPI?.checkAccessibilityPermission?.(true).then((granted) => {if (granted) {setAccessibilityPermissionGranted(true);+ setAccessibilityTroubleshooting(false);+ accessibilityPollCount.current = 0;+ } else {+ accessibilityPollCount.current += 1;+ // After ~10s of failed polls, show troubleshooting tips+ if (accessibilityPollCount.current >= 5) {+ setAccessibilityTroubleshooting(true);+ }}});}, 2000);@@ -368,6 +392,7 @@ export const usePermissions = (micPermissionError,pasteToolsInfo,isCheckingPasteTools,+ accessibilityTroubleshooting,requestMicPermission,testAccessibilityPermission,checkPasteToolsAvailability,diff --git a/src/locales/de/translation.json b/src/locales/de/translation.jsonindex d8a3dd751..3f383c351 100644--- a/src/locales/de/translation.json+++ b/src/locales/de/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Systemeinstellungen öffnen","systemAudioTitle": "Systemaudio","systemAudioDescription": "Nimmt den Ton anderer Teilnehmer aus Anrufen und Meetings auf. Wir nehmen Ihren Bildschirm nie auf.",- "optional": "Optional"+ "optional": "Optional",+ "recommended": "Empfohlen",+ "accessibilityTroubleshooting": "Nicht erkannt? Entferne OpenWhispr aus den Bedienungshilfen in den Systemeinstellungen, füge es erneut hinzu und aktiviere es. Du kannst dies überspringen — Text wird nur in die Zwischenablage kopiert statt automatisch eingefügt."},"transcription": {"title": "Transkriptions-Einrichtung",@@ -1952,5 +1954,10 @@"title": "Update verfügbar","body": "Version {{version}} ist bereit","cta": "Jetzt aktualisieren"+ },+ "permissionsGate": {+ "title": "Berechtigungen erforderlich",+ "description": "OpenWhispr benötigt einige Berechtigungen, um auf diesem Computer zu funktionieren.",+ "continue": "Weiter"}}diff --git a/src/locales/en/translation.json b/src/locales/en/translation.jsonindex ca40fb28f..c5e0d3ce5 100644--- a/src/locales/en/translation.json+++ b/src/locales/en/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Open System Settings","systemAudioTitle": "System Audio","systemAudioDescription": "Captures other participants' audio from calls and meetings. We never record your screen.",- "optional": "Optional"+ "optional": "Optional",+ "recommended": "Recommended",+ "accessibilityTroubleshooting": "Not detected? Try removing OpenWhispr from Accessibility in System Settings, then re-add it and toggle it on. You can skip this and continue — text will copy to clipboard instead of auto-pasting."},"transcription": {"title": "Transcription Setup",@@ -1991,5 +1993,10 @@"title": "Update Available","body": "Version {{version}} is ready","cta": "Update Now"+ },+ "permissionsGate": {+ "title": "Permissions Required",+ "description": "OpenWhispr needs a few permissions to work on this computer.",+ "continue": "Continue"}}diff --git a/src/locales/es/translation.json b/src/locales/es/translation.jsonindex 836eea7d0..28815de47 100644--- a/src/locales/es/translation.json+++ b/src/locales/es/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Abrir Ajustes del Sistema","systemAudioTitle": "Audio del Sistema","systemAudioDescription": "Captura el audio de otros participantes en llamadas y reuniones. Nunca grabamos tu pantalla.",- "optional": "Opcional"+ "optional": "Opcional",+ "recommended": "Recomendado",+ "accessibilityTroubleshooting": "¿No detectado? Elimina OpenWhispr de Accesibilidad en Configuración del Sistema, vuelve a añadirlo y actívalo. Puedes omitir esto y continuar — el texto se copiará al portapapeles en lugar de pegarse automáticamente."},"transcription": {"title": "Configuración de transcripción",@@ -1952,5 +1954,10 @@"title": "Actualización disponible","body": "La versión {{version}} está lista","cta": "Actualizar ahora"+ },+ "permissionsGate": {+ "title": "Permisos necesarios",+ "description": "OpenWhispr necesita algunos permisos para funcionar en este ordenador.",+ "continue": "Continuar"}}diff --git a/src/locales/fr/translation.json b/src/locales/fr/translation.jsonindex a16ddf007..eeffb05f5 100644--- a/src/locales/fr/translation.json+++ b/src/locales/fr/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Ouvrir les Réglages Système","systemAudioTitle": "Audio Système","systemAudioDescription": "Capture l'audio des autres participants lors d'appels et de réunions. Nous n'enregistrons jamais votre écran.",- "optional": "Facultatif"+ "optional": "Facultatif",+ "recommended": "Recommandé",+ "accessibilityTroubleshooting": "Non détecté ? Supprimez OpenWhispr de l'Accessibilité dans les Réglages Système, ajoutez-le à nouveau et activez-le. Vous pouvez ignorer cette étape — le texte sera copié dans le presse-papiers au lieu d'être collé automatiquement."},"transcription": {"title": "Configuration de la transcription",@@ -1952,5 +1954,10 @@"title": "Mise à jour disponible","body": "La version {{version}} est prête","cta": "Mettre à jour"+ },+ "permissionsGate": {+ "title": "Autorisations requises",+ "description": "OpenWhispr a besoin de quelques autorisations pour fonctionner sur cet ordinateur.",+ "continue": "Continuer"}}diff --git a/src/locales/it/translation.json b/src/locales/it/translation.jsonindex a10e6f563..bd40b47f3 100644--- a/src/locales/it/translation.json+++ b/src/locales/it/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Apri Impostazioni di Sistema","systemAudioTitle": "Audio di Sistema","systemAudioDescription": "Cattura l'audio degli altri partecipanti durante chiamate e riunioni. Non registriamo mai il tuo schermo.",- "optional": "Facoltativo"+ "optional": "Facoltativo",+ "recommended": "Consigliato",+ "accessibilityTroubleshooting": "Non rilevato? Rimuovi OpenWhispr da Accessibilità nelle Impostazioni di Sistema, aggiungilo di nuovo e attivalo. Puoi saltare questo passaggio — il testo verrà solo copiato negli appunti invece di essere incollato automaticamente."},"transcription": {"title": "Configurazione trascrizione",@@ -1952,5 +1954,10 @@"title": "Aggiornamento disponibile","body": "La versione {{version}} è pronta","cta": "Aggiorna ora"+ },+ "permissionsGate": {+ "title": "Autorizzazioni necessarie",+ "description": "OpenWhispr ha bisogno di alcune autorizzazioni per funzionare su questo computer.",+ "continue": "Continua"}}diff --git a/src/locales/ja/translation.json b/src/locales/ja/translation.jsonindex dea408204..bf77daedf 100644--- a/src/locales/ja/translation.json+++ b/src/locales/ja/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "システム設定を開く","systemAudioTitle": "システムオーディオ","systemAudioDescription": "通話や会議で他の参加者の音声を録音します。画面を録画することはありません。",- "optional": "任意"+ "optional": "任意",+ "recommended": "推奨",+ "accessibilityTroubleshooting": "検出されませんか?システム設定のアクセシビリティからOpenWhisprを削除し、再度追加してオンに切り替えてください。スキップして続行することもできます — テキストは自動貼り付けではなくクリップボードにコピーされます。"},"transcription": {"title": "文字起こし設定",@@ -1952,5 +1954,10 @@"title": "アップデートあり","body": "バージョン {{version}} が利用可能です","cta": "今すぐ更新"+ },+ "permissionsGate": {+ "title": "権限が必要です",+ "description": "OpenWhispr がこのコンピュータで動作するために、いくつかの権限が必要です。",+ "continue": "続行"}}diff --git a/src/locales/pt/translation.json b/src/locales/pt/translation.jsonindex d50b7c798..f67155d5b 100644--- a/src/locales/pt/translation.json+++ b/src/locales/pt/translation.json@@ -136,7 +136,9 @@"openSystemSettings": "Abrir Configurações do Sistema","systemAudioTitle": "Áudio do Sistema","systemAudioDescription": "Captura o áudio dos outros participantes em chamadas e reuniões. Nunca gravamos a sua tela.",- "optional": "Opcional"+ "optional": "Opcional",+ "recommended": "Recomendado",+ "accessibilityTroubleshooting": "Não detectado? Remova o OpenWhispr da Acessibilidade nas Configurações do Sistema, adicione-o novamente e ative-o. Você pode pular isso e continuar — o texto será copiado para a área de transferência em vez de ser colado automaticamente."},"transcription": {"title": "Configuração de transcrição",@@ -1952,5 +1954,10 @@"title": "Atualização disponível","body": "A versão {{version}} está pronta","cta": "Atualizar agora"+ },+ "permissionsGate": {+ "title": "Permissões necessárias",+ "description": "O OpenWhispr precisa de algumas permissões para funcionar neste computador.",+ "continue": "Continuar"}}diff --git a/src/locales/ru/translation.json b/src/locales/ru/translation.jsonindex f6e0793d1..ff1533f8e 100644--- a/src/locales/ru/translation.json+++ b/src/locales/ru/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "Открыть Системные настройки","systemAudioTitle": "Системное аудио","systemAudioDescription": "Записывает аудио других участников звонков и совещаний. Мы никогда не записываем ваш экран.",- "optional": "Необязательно"+ "optional": "Необязательно",+ "recommended": "Рекомендуется",+ "accessibilityTroubleshooting": "Не обнаружено? Удалите OpenWhispr из раздела Универсальный доступ в Системных настройках, добавьте его снова и включите. Вы можете пропустить это — текст будет копироваться в буфер обмена вместо автоматической вставки."},"transcription": {"title": "Настройка транскрипции",@@ -1952,5 +1954,10 @@"title": "Доступно обновление","body": "Версия {{version}} готова","cta": "Обновить"+ },+ "permissionsGate": {+ "title": "Требуются разрешения",+ "description": "OpenWhispr нужны некоторые разрешения для работы на этом компьютере.",+ "continue": "Продолжить"}}diff --git a/src/locales/zh-CN/translation.json b/src/locales/zh-CN/translation.jsonindex 45631dc22..75fa182f5 100644--- a/src/locales/zh-CN/translation.json+++ b/src/locales/zh-CN/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "打开系统设置","systemAudioTitle": "系统音频","systemAudioDescription": "录制通话和会议中其他参与者的音频。我们绝不会录制您的屏幕。",- "optional": "可选"+ "optional": "可选",+ "recommended": "推荐",+ "accessibilityTroubleshooting": "未检测到?请在系统设置的辅助功能中移除 OpenWhispr,然后重新添加并开启。您可以跳过此步继续 — 文本将复制到剪贴板而非自动粘贴。"},"transcription": {"title": "转录设置",@@ -1952,5 +1954,10 @@"title": "有可用更新","body": "版本 {{version}} 已就绪","cta": "立即更新"+ },+ "permissionsGate": {+ "title": "需要权限",+ "description": "OpenWhispr 需要一些权限才能在此电脑上正常运行。",+ "continue": "继续"}}diff --git a/src/locales/zh-TW/translation.json b/src/locales/zh-TW/translation.jsonindex d8f65848f..1ef261f91 100644--- a/src/locales/zh-TW/translation.json+++ b/src/locales/zh-TW/translation.json@@ -164,7 +164,9 @@"openSystemSettings": "打開系統設定","systemAudioTitle": "系統音訊","systemAudioDescription": "錄製通話和會議中其他參與者的音訊。我們絕不會錄製您的螢幕。",- "optional": "可選"+ "optional": "可選",+ "recommended": "建議",+ "accessibilityTroubleshooting": "未偵測到?請在系統設定的輔助使用中移除 OpenWhispr,然後重新加入並開啟。您可以跳過此步驟繼續 — 文字將複製到剪貼簿而非自動貼上。"},"transcription": {"title": "轉錄設定",@@ -1952,5 +1954,10 @@"title": "有可用更新","body": "版本 {{version}} 已就緒","cta": "立即更新"+ },+ "permissionsGate": {+ "title": "需要權限",+ "description": "OpenWhispr 需要一些權限才能在此電腦上正常運作。",+ "continue": "繼續"}}diff --git a/src/main.jsx b/src/main.jsxindex 37631474a..bbb900f9d 100644--- a/src/main.jsx+++ b/src/main.jsx@@ -10,15 +10,18 @@ import { ToastProvider } from "./components/ui/Toast.tsx";import { SettingsProvider } from "./hooks/useSettings";import { useTheme } from "./hooks/useTheme";import { useAuth } from "./hooks/useAuth";+import { areRequiredPermissionsMet } from "./utils/permissions";import i18n from "./i18n";import "./index.css";const controlPanelImport = () => import("./components/ControlPanel.tsx");const onboardingFlowImport = () => import("./components/OnboardingFlow.tsx");const agentOverlayImport = () => import("./components/AgentOverlay.tsx");+const permissionsGateImport = () => import("./components/PermissionsGate.tsx");const ControlPanel = React.lazy(controlPanelImport);const OnboardingFlow = React.lazy(onboardingFlowImport);const AgentOverlay = React.lazy(agentOverlayImport);+const PermissionsGate = React.lazy(permissionsGateImport);import MeetingNotificationOverlay from "./components/MeetingNotificationOverlay.tsx";import UpdateNotificationOverlay from "./components/UpdateNotificationOverlay.tsx";@@ -292,6 +295,7 @@ function MainApp() {const [showOnboarding, setShowOnboarding] = useState(false);const [needsReauth, setNeedsReauth] = useState(false);+ const [needsPermissions, setNeedsPermissions] = useState(false);const [isLoading, setIsLoading] = useState(true);const isAgentPanel = window.location.search.includes("agent=true");@@ -306,6 +310,7 @@ function MainApp() {agentOverlayImport().catch(() => {});} else if (isControlPanel) {controlPanelImport().catch(() => {});+ permissionsGateImport().catch(() => {});if (!localStorage.getItem("onboardingCompleted")) {onboardingFlowImport().catch(() => {});}@@ -320,8 +325,11 @@ function MainApp() {localStorage.getItem("authenticationSkipped") === "true" ||localStorage.getItem("skipAuth") === "true";- // Actual session (not OAuth grace period) proves prior onboarding — restore flag if localStorage was wiped- const isReturningUser = !onboardingCompleted && isSignedIn && !isGracePeriodOnly;+ // Actual session (not OAuth grace period) proves prior onboarding — restore flag if localStorage was wiped.+ // Guard with onboardingInProgress so first-time users mid-onboarding don't get auto-completed.+ const onboardingInProgress = localStorage.getItem("onboardingCurrentStep") !== null;+ const isReturningUser =+ !onboardingCompleted && isSignedIn && !isGracePeriodOnly && !onboardingInProgress;if (isReturningUser) {localStorage.setItem("onboardingCompleted", "true");}@@ -333,12 +341,14 @@ function MainApp() {setShowOnboarding(true);} 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?.();+ } else {+ // Check permissions from localStorage — PermissionsGate does the real async checks+ const platform = window.electronAPI?.getPlatform?.() ?? "darwin";+ const micOk = localStorage.getItem("micPermissionGranted") === "true";+ const accessibilityOk = localStorage.getItem("accessibilityPermissionGranted") === "true";+ if (!areRequiredPermissionsMet(micOk, accessibilityOk, platform)) {+ setNeedsPermissions(true);+ }}}@@ -355,9 +365,14 @@ function MainApp() {const handleOnboardingComplete = () => {setShowOnboarding(false);+ setNeedsPermissions(false); // onboarding already handled permissionslocalStorage.setItem("onboardingCompleted", "true");};+ const handlePermissionsComplete = () => {+ setNeedsPermissions(false);+ };+if (isAgentPanel) {return (<Suspense fallback={<LoadingFallback />}>@@ -417,6 +432,15 @@ function MainApp() {);}+ // Returning user missing permissions (new machine, re-auth, etc.)+ if (isControlPanel && needsPermissions) {+ return (+ <Suspense fallback={<LoadingFallback />}>+ <PermissionsGate onComplete={handlePermissionsComplete} />+ </Suspense>+ );+ }+return isControlPanel ? (<Suspense fallback={<LoadingFallback />}><ControlPanel />diff --git a/src/stores/settingsStore.ts b/src/stores/settingsStore.tsindex 9b6f57e7b..0972f36e6 100644--- a/src/stores/settingsStore.ts+++ b/src/stores/settingsStore.ts@@ -307,7 +307,7 @@ export const useSettingsStore = create<SettingsState>()((set, get) => ({if (v === "bottom-right" || v === "center" || v === "bottom-left") return v;return "bottom-right" as const;})(),- keepTranscriptionInClipboard: readBoolean("keepTranscriptionInClipboard", true),+ keepTranscriptionInClipboard: readBoolean("keepTranscriptionInClipboard", false),isSignedIn: readBoolean("isSignedIn", false),agentModel: readString("agentModel", "openai/gpt-oss-120b"),diff --git a/src/types/electron.ts b/src/types/electron.tsindex f2b9c7bfa..27e2a4c86 100644--- a/src/types/electron.ts+++ b/src/types/electron.ts@@ -447,6 +447,7 @@ declare global {// Clipboard operationscheckAccessibilityPermission: (silent?: boolean) => Promise<boolean>;+ promptAccessibilityPermission: () => Promise<boolean>;readClipboard: () => Promise<string>;writeClipboard: (text: string) => Promise<{ success: boolean }>;checkPasteTools: () => Promise<PasteToolsResult>;diff --git a/src/utils/permissions.ts b/src/utils/permissions.tsnew file mode 100644index 000000000..e58b680d5--- /dev/null+++ b/src/utils/permissions.ts@@ -0,0 +1,12 @@+/** Returns true when all required OS permissions are granted. */+export function areRequiredPermissionsMet(+ micGranted: boolean,+ _accessibilityGranted: boolean,+ _platform: string | undefined+): boolean {+ if (!micGranted) return false;++ // Accessibility is no longer required — falls back to clipboard-only mode.+ // Previously hard-blocked onboarding with stale TCC entries (#394).+ return true;+}