Skip to content

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

feat(auth): add post-login permissions gate for returning users

Gabriel Stein30955e704f56
diff --git a/preload.js b/preload.js
index e87287ade..26a2c0ca6 100644
--- a/preload.js
+++ b/preload.js
@@ -170,6 +170,8 @@ contextBridge.exposeInMainWorld("electronAPI", {
// Clipboard functions
checkAccessibilityPermission: (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.tsx
index 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 permissions
if (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 users
diff --git a/src/components/PermissionsGate.tsx b/src/components/PermissionsGate.tsx
new file mode 100644
index 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.tsx
index 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.tsx
new file mode 100644
index 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.js
index 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.ts
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.jsx
index 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 permissions
localStorage.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.ts
index 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.ts
index f2b9c7bfa..27e2a4c86 100644
--- a/src/types/electron.ts
+++ b/src/types/electron.ts
@@ -447,6 +447,7 @@ declare global {
// Clipboard operations
checkAccessibilityPermission: (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.ts
new file mode 100644
index 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;
+}