Skip to content

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

fix: portal-based tooltips and replace download with reveal in folder

Gabriel Stein402fbf910ff8
diff --git a/preload.js b/preload.js
index 797e43066..09527971f 100644
--- a/preload.js
+++ b/preload.js
@@ -40,6 +40,7 @@ contextBridge.exposeInMainWorld("electronAPI", {
saveTranscriptionAudio: (id, audioBuffer, metadata) =>
ipcRenderer.invoke("save-transcription-audio", id, audioBuffer, metadata),
getAudioPath: (id) => ipcRenderer.invoke("get-audio-path", id),
+ showAudioInFolder: (id) => ipcRenderer.invoke("show-audio-in-folder", id),
getAudioBuffer: (id) => ipcRenderer.invoke("get-audio-buffer", id),
deleteTranscriptionAudio: (id) => ipcRenderer.invoke("delete-transcription-audio", id),
getAudioStorageUsage: () => ipcRenderer.invoke("get-audio-storage-usage"),
diff --git a/src/components/ControlPanel.tsx b/src/components/ControlPanel.tsx
index 089951ecc..8c7964d9f 100644
--- a/src/components/ControlPanel.tsx
+++ b/src/components/ControlPanel.tsx
@@ -244,25 +244,16 @@ export default function ControlPanel() {
[showConfirmDialog, showAlertDialog, t]
);
- const downloadAudio = useCallback(
+ const showAudioInFolder = useCallback(
async (id: number) => {
try {
- const buffer = await window.electronAPI.getAudioBuffer(id);
- if (!buffer) {
+ const result = await window.electronAPI.showAudioInFolder(id);
+ if (!result?.success) {
toast({
title: t("controlPanel.history.audioNotFound"),
variant: "destructive",
});
- return;
}
- const blob = new Blob([buffer], { type: "audio/webm" });
- const url = URL.createObjectURL(blob);
- const a = document.createElement("a");
- a.href = url;
- a.download = `openwhispr-${id}.webm`;
- a.click();
- URL.revokeObjectURL(url);
- toast({ title: t("controlPanel.history.audioSaved") });
} catch {
toast({
title: t("controlPanel.history.audioNotFound"),
@@ -549,7 +540,7 @@ export default function ControlPanel() {
useReasoningModel={useReasoningModel}
copyToClipboard={copyToClipboard}
deleteTranscription={deleteTranscription}
- onDownloadAudio={downloadAudio}
+ onShowAudioInFolder={showAudioInFolder}
onRetryTranscription={retryTranscription}
onOpenSettings={(section) => {
setSettingsSection(section);
diff --git a/src/components/HistoryView.tsx b/src/components/HistoryView.tsx
index 2442d38a7..d99257041 100644
--- a/src/components/HistoryView.tsx
+++ b/src/components/HistoryView.tsx
@@ -19,7 +19,7 @@ interface HistoryViewProps {
copyToClipboard: (text: string) => void;
deleteTranscription: (id: number) => void;
onOpenSettings: (section?: string) => void;
- onDownloadAudio: (id: number) => void;
+ onShowAudioInFolder: (id: number) => void;
onRetryTranscription: (id: number) => Promise<void>;
}
@@ -35,7 +35,7 @@ export default function HistoryView({
copyToClipboard,
deleteTranscription,
onOpenSettings,
- onDownloadAudio,
+ onShowAudioInFolder,
onRetryTranscription,
}: HistoryViewProps) {
const { t } = useTranslation();
@@ -261,7 +261,7 @@ export default function HistoryView({
item={item}
onCopy={copyToClipboard}
onDelete={deleteTranscription}
- onDownloadAudio={onDownloadAudio}
+ onShowAudioInFolder={onShowAudioInFolder}
onRetryTranscription={onRetryTranscription}
/>
))}
diff --git a/src/components/ui/TranscriptionItem.tsx b/src/components/ui/TranscriptionItem.tsx
index 60edb53d1..e4e72a484 100644
--- a/src/components/ui/TranscriptionItem.tsx
+++ b/src/components/ui/TranscriptionItem.tsx
@@ -2,15 +2,24 @@ import { useState } from "react";
import { useTranslation } from "react-i18next";
import { Button } from "./button";
import { Tooltip } from "./tooltip";
-import { Copy, Trash2, FileText, Download, RotateCcw, Loader2 } from "lucide-react";
+import { Copy, Trash2, FileText, FolderOpen, RotateCcw, Loader2 } from "lucide-react";
import type { TranscriptionItem as TranscriptionItemType } from "../../types/electron";
import { cn } from "../lib/utils";
+import { getCachedPlatform } from "../../utils/platform";
+
+const platform = getCachedPlatform();
+
+function getShowInFolderKey(): string {
+ if (platform === "win32") return "controlPanel.history.showInFolderWindows";
+ if (platform === "linux") return "controlPanel.history.showInFolderLinux";
+ return "controlPanel.history.showInFolder";
+}
interface TranscriptionItemProps {
item: TranscriptionItemType;
onCopy: (text: string) => void;
onDelete: (id: number) => void;
- onDownloadAudio?: (id: number) => void;
+ onShowAudioInFolder?: (id: number) => void;
onRetryTranscription?: (id: number) => Promise<void>;
}
@@ -18,7 +27,7 @@ export default function TranscriptionItem({
item,
onCopy,
onDelete,
- onDownloadAudio,
+ onShowAudioInFolder,
onRetryTranscription,
}: TranscriptionItemProps) {
const { t, i18n } = useTranslation();
@@ -88,14 +97,14 @@ export default function TranscriptionItem({
</Tooltip>
)}
{hasAudio && (
- <Tooltip content={t("controlPanel.history.downloadAudio")}>
+ <Tooltip content={t(getShowInFolderKey())}>
<Button
size="icon"
variant="ghost"
- onClick={() => onDownloadAudio?.(item.id)}
+ onClick={() => onShowAudioInFolder?.(item.id)}
className="h-6 w-6 rounded-sm text-muted-foreground hover:text-primary hover:bg-primary/10"
>
- <Download size={12} />
+ <FolderOpen size={12} />
</Button>
</Tooltip>
)}
diff --git a/src/components/ui/tooltip.tsx b/src/components/ui/tooltip.tsx
index cd839843f..ce20b2a17 100644
--- a/src/components/ui/tooltip.tsx
+++ b/src/components/ui/tooltip.tsx
@@ -1,4 +1,5 @@
-import React, { useState } from "react";
+import React, { useState, useRef, useEffect, useCallback } from "react";
+import { createPortal } from "react-dom";
interface TooltipProps {
children: React.ReactNode;
@@ -7,18 +8,69 @@ interface TooltipProps {
export const Tooltip = ({ children, content }: TooltipProps) => {
const [isVisible, setIsVisible] = useState(false);
+ const [position, setPosition] = useState<{ top: number; left: number } | null>(null);
+ const triggerRef = useRef<HTMLDivElement>(null);
+ const tooltipRef = useRef<HTMLDivElement>(null);
+
+ const updatePosition = useCallback(() => {
+ if (!triggerRef.current) return;
+ const rect = triggerRef.current.getBoundingClientRect();
+ setPosition({
+ top: rect.top,
+ left: rect.left + rect.width / 2,
+ });
+ }, []);
+
+ useEffect(() => {
+ if (!isVisible) return;
+ updatePosition();
+ }, [isVisible, updatePosition]);
+
+ // Adjust if tooltip overflows viewport edges
+ useEffect(() => {
+ if (!isVisible || !position || !tooltipRef.current) return;
+ const tooltip = tooltipRef.current;
+ const tooltipRect = tooltip.getBoundingClientRect();
+
+ let adjustedLeft = position.left;
+ if (tooltipRect.left < 4) {
+ adjustedLeft = tooltipRect.width / 2 + 4;
+ } else if (tooltipRect.right > window.innerWidth - 4) {
+ adjustedLeft = window.innerWidth - tooltipRect.width / 2 - 4;
+ }
+
+ if (adjustedLeft !== position.left) {
+ setPosition((prev) => (prev ? { ...prev, left: adjustedLeft } : prev));
+ }
+ }, [isVisible, position]);
return (
- <div className="relative inline-block">
- <div onMouseEnter={() => setIsVisible(true)} onMouseLeave={() => setIsVisible(false)}>
+ <>
+ <div
+ ref={triggerRef}
+ className="relative inline-flex"
+ onMouseEnter={() => setIsVisible(true)}
+ onMouseLeave={() => setIsVisible(false)}
+ >
{children}
</div>
- {isVisible && (
- <div className="absolute bottom-full left-1/2 transform -translate-x-1/2 mb-2 px-2.5 py-1.5 text-xs font-medium text-popover-foreground bg-popover border border-border rounded-md whitespace-nowrap z-50 shadow-lg animate-in fade-in-0 zoom-in-95 duration-150">
- {content}
- <div className="absolute top-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-l-4 border-r-4 border-t-4 border-transparent border-t-popover"></div>
- </div>
- )}
- </div>
+ {isVisible &&
+ position &&
+ createPortal(
+ <div
+ ref={tooltipRef}
+ className="fixed px-2.5 py-1.5 text-xs font-medium text-popover-foreground bg-popover border border-border rounded-md whitespace-nowrap z-[9999] shadow-lg animate-in fade-in-0 zoom-in-95 duration-150 pointer-events-none"
+ style={{
+ top: position.top,
+ left: position.left,
+ transform: "translate(-50%, calc(-100% - 8px))",
+ }}
+ >
+ {content}
+ <div className="absolute top-full left-1/2 -translate-x-1/2 w-0 h-0 border-l-4 border-r-4 border-t-4 border-transparent border-t-popover" />
+ </div>,
+ document.body
+ )}
+ </>
);
};
diff --git a/src/helpers/audioStorage.js b/src/helpers/audioStorage.js
index 84638ba1a..452b743ba 100644
--- a/src/helpers/audioStorage.js
+++ b/src/helpers/audioStorage.js
@@ -21,13 +21,27 @@ class AudioStorageManager {
}
}
- saveAudio(transcriptionId, audioBuffer) {
+ _buildFilename(transcriptionId, timestamp) {
+ if (timestamp) {
+ const d = new Date(timestamp);
+ if (!isNaN(d.getTime())) {
+ const pad = (n) => String(n).padStart(2, "0");
+ const date = `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+ const time = `${pad(d.getHours())}-${pad(d.getMinutes())}-${pad(d.getSeconds())}`;
+ return `OpenWhispr-${date}-${time}-${transcriptionId}.webm`;
+ }
+ }
+ return `OpenWhispr-${transcriptionId}.webm`;
+ }
+
+ saveAudio(transcriptionId, audioBuffer, timestamp) {
try {
- const filePath = path.join(this.audioDir, `${transcriptionId}.webm`);
+ const filename = this._buildFilename(transcriptionId, timestamp);
+ const filePath = path.join(this.audioDir, filename);
fs.writeFileSync(filePath, audioBuffer);
debugLogger.debug(
"Audio saved",
- { transcriptionId, size: audioBuffer.length },
+ { transcriptionId, filename, size: audioBuffer.length },
"audio-storage"
);
return { success: true, path: filePath };
@@ -42,8 +56,17 @@ class AudioStorageManager {
}
getAudioPath(transcriptionId) {
- const filePath = path.join(this.audioDir, `${transcriptionId}.webm`);
- return fs.existsSync(filePath) ? filePath : null;
+ // Match any file containing the transcription ID
+ try {
+ const files = fs.readdirSync(this.audioDir);
+ const match = files.find(
+ (f) => f.endsWith(`-${transcriptionId}.webm`) || f === `${transcriptionId}.webm`
+ );
+ if (match) return path.join(this.audioDir, match);
+ } catch {
+ // Fall through
+ }
+ return null;
}
getAudioBuffer(transcriptionId) {
@@ -63,8 +86,8 @@ class AudioStorageManager {
deleteAudio(transcriptionId) {
try {
- const filePath = path.join(this.audioDir, `${transcriptionId}.webm`);
- if (fs.existsSync(filePath)) {
+ const filePath = this.getAudioPath(transcriptionId);
+ if (filePath) {
fs.unlinkSync(filePath);
debugLogger.debug("Audio deleted", { transcriptionId }, "audio-storage");
}
@@ -92,7 +115,10 @@ class AudioStorageManager {
const stats = fs.statSync(filePath);
if (stats.mtimeMs < cutoffMs) {
fs.unlinkSync(filePath);
- const id = path.basename(file, ".webm");
+ // Extract ID from "OpenWhispr-...-{id}.webm" or legacy "{id}.webm"
+ const basename = path.basename(file, ".webm");
+ const lastDash = basename.lastIndexOf("-");
+ const id = lastDash !== -1 ? basename.slice(lastDash + 1) : basename;
expiredIds.push(id);
} else {
kept++;
diff --git a/src/helpers/ipcHandlers.js b/src/helpers/ipcHandlers.js
index 67f37be62..1616726b4 100644
--- a/src/helpers/ipcHandlers.js
+++ b/src/helpers/ipcHandlers.js
@@ -386,7 +386,9 @@ class IPCHandlers {
// Audio storage handlers
ipcMain.handle("save-transcription-audio", async (event, id, audioBuffer, metadata) => {
- const result = this.audioStorageManager.saveAudio(id, Buffer.from(audioBuffer));
+ const transcription = this.databaseManager.getTranscriptionById(id);
+ const timestamp = transcription?.timestamp || null;
+ const result = this.audioStorageManager.saveAudio(id, Buffer.from(audioBuffer), timestamp);
if (result.success) {
this.databaseManager.updateTranscriptionAudio(id, {
hasAudio: 1,
@@ -402,6 +404,13 @@ class IPCHandlers {
return this.audioStorageManager.getAudioPath(id);
});
+ ipcMain.handle("show-audio-in-folder", async (event, id) => {
+ const filePath = this.audioStorageManager.getAudioPath(id);
+ if (!filePath) return { success: false };
+ shell.showItemInFolder(filePath);
+ return { success: true };
+ });
+
ipcMain.handle("get-audio-buffer", async (event, id) => {
const buffer = this.audioStorageManager.getAudioBuffer(id);
return buffer ? buffer.buffer : null;
diff --git a/src/locales/en/translation.json b/src/locales/en/translation.json
index 4bc7d1a04..559eb2ae7 100644
--- a/src/locales/en/translation.json
+++ b/src/locales/en/translation.json
@@ -226,12 +226,13 @@
"copyText": "Copy text",
"deleteItem": "Delete",
"viewRawTranscript": "View raw transcript",
- "downloadAudio": "Download audio",
+ "showInFolder": "Reveal in Finder",
+ "showInFolderWindows": "Show in Explorer",
+ "showInFolderLinux": "Show in File Manager",
"retryTranscription": "Re-transcribe",
"retrying": "Re-transcribing...",
"retrySuccess": "Transcription updated",
"retryError": "Failed to re-transcribe",
- "audioSaved": "Audio saved",
"audioNotFound": "Audio file not found or expired",
"noAiProcessing": "No AI processing was applied to this transcription",
"rawTranscript": "Raw Transcript"
diff --git a/src/types/electron.ts b/src/types/electron.ts
index ef666f735..1b8721116 100644
--- a/src/types/electron.ts
+++ b/src/types/electron.ts
@@ -300,6 +300,7 @@ declare global {
metadata?: { durationMs?: number; provider?: string; model?: string }
) => Promise<{ success: boolean; path?: string }>;
getAudioPath: (id: number) => Promise<string | null>;
+ showAudioInFolder: (id: number) => Promise<{ success: boolean }>;
getAudioBuffer: (id: number) => Promise<ArrayBuffer | null>;
deleteTranscriptionAudio: (id: number) => Promise<{ success: boolean }>;
getAudioStorageUsage: () => Promise<{ fileCount: number; totalBytes: number }>;