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
import { useEffect } from "react";
import type { TFunction } from "i18next";
import { ToastActionButton } from "../components/ui/Toast";
import type { ToastContextType } from "../components/ui/useToast";
/**
* Surfaces main-process notifications (hotkey fallback/failure, GPU fallback,
* learned dictionary corrections) as toasts in the dictation window.
*/
export function useMainProcessNotifications({
toast,
dismiss,
t,
}: {
toast: ToastContextType["toast"];
dismiss: ToastContextType["dismiss"];
t: TFunction;
}): void {
useEffect(() => {
const unsubscribeFallback = window.electronAPI?.onHotkeyFallbackUsed?.((data) => {
toast({
title: t("app.toasts.hotkeyChanged.title"),
description: t("app.toasts.hotkeyChanged.description", {
original: data.original,
fallback: data.fallback,
}),
duration: 8000,
});
});
// Main's translated reason names the hotkey, which matters when several slots
// restore at startup.
const unsubscribeFailed = window.electronAPI?.onHotkeyRegistrationFailed?.((data) => {
toast({
title: t("app.toasts.hotkeyUnavailable.title"),
description: data?.error || t("app.toasts.hotkeyUnavailable.description"),
duration: 10000,
});
});
const showGpuFallbackToast = () => {
let toastId: string;
toastId = toast({
title: t("app.toasts.gpuFallback.title"),
description: t("app.toasts.gpuFallback.description"),
duration: 10000,
action: (
<ToastActionButton
onClick={async () => {
try {
const result = await window.electronAPI?.whisperGpuRetry?.();
if (result?.success) dismiss(toastId);
} catch {
// silently fail — toast stays up for another attempt
}
}}
>
{t("app.toasts.gpuFallback.retry")}
</ToastActionButton>
),
});
};
const unsubscribeCudaFallback =
window.electronAPI?.onCudaFallbackNotification?.(showGpuFallbackToast);
const unsubscribeGpuFallback =
window.electronAPI?.onGpuFallbackNotification?.(showGpuFallbackToast);
const unsubscribeCorrections = window.electronAPI?.onCorrectionsLearned?.((words) => {
if (words && words.length > 0) {
const wordList = words.map((w) => `“${w}”`).join(", ");
let toastId: string;
toastId = toast({
title: t("app.toasts.addedToDict", { words: wordList }),
variant: "success",
duration: 6000,
action: (
<button
onClick={async () => {
try {
const result = await window.electronAPI?.undoLearnedCorrections?.(words);
if (result?.success) {
dismiss(toastId);
}
} catch {
// silently fail — word stays in dictionary
}
}}
className="text-[10px] font-medium px-2.5 py-1 rounded-sm whitespace-nowrap
text-emerald-100/90 hover:text-white
bg-emerald-500/15 hover:bg-emerald-500/25
border border-emerald-400/20 hover:border-emerald-400/35
transition-all duration-150"
>
{t("app.toasts.undo")}
</button>
),
});
}
});
return () => {
unsubscribeFallback?.();
unsubscribeFailed?.();
unsubscribeCudaFallback?.();
unsubscribeGpuFallback?.();
unsubscribeCorrections?.();
};
}, [toast, dismiss, t]);
}