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
chore(build): stop publishing the Windows portable build (#2301)
Joshua1ab40c187dcd
diff --git a/CLAUDE.md b/CLAUDE.mdindex 3701623df..7823a3441 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -109,7 +109,7 @@ OpenWhispr is an Electron-based desktop dictation application that uses whisper.- `HIDDEN_LAUNCH_FLAG` (`--hidden`) is how a login launch tells the app to start in the tray. Windows has no native equivalent (`openAsHidden` is macOS-only and a no-op on macOS 13+), so the flag rides on the login item's `args`; Linux puts it on the autostart entry's `Exec`; macOS uses `wasOpenedAtLogin` instead- On Windows, read the state from `executableWillLaunchAtLogin`, never from `openAtLogin`: `openAtLogin` only compares the `Run` value against the current executable and args and ignores the `StartupApproved` key that Task Manager and Settings write when a user disables a startup app- Reads and writes must pass identical `args`, or `openAtLogin` always reports false- - `getRelaunchOptions()` and `getRelaunchWaiter()` shape the `relaunch-app` IPC that follows `cleanup-app` (Reset app data; Delete account with device erase): the relaunch drops `--hidden` and any cold-start deep link, and an AppImage or Windows portable build is started again from its on-disk file (`$APPIMAGE`, `$PORTABLE_EXECUTABLE_FILE`) by a detached waiter, since both run from a directory that disappears when the app exits. The handler in `ipcHandlers.js` only quits under `npm run dev` and, on macOS with an update Squirrel already holds, hands the restart to the updater+ - `getRelaunchOptions()` and `getRelaunchWaiter()` shape the `relaunch-app` IPC that follows `cleanup-app` (Reset app data; Delete account with device erase): the relaunch drops `--hidden` and any cold-start deep link, and an AppImage is started again from its on-disk file (`$APPIMAGE`) by a detached waiter, since it runs from a FUSE mount that disappears when the app exits. The handler in `ipcHandlers.js` only quits under `npm run dev` and, on macOS with an update Squirrel already holds, hands the restart to the updater- **linuxAutostart.js**: Launch-at-login on Linux via an XDG autostart entry- `app.setLoginItemSettings()` is a no-op on Linux, so the entry is written directly to `$XDG_CONFIG_HOME/autostart/open-whispr.desktop`, matching the executable name electron-builder packages under- `Exec` resolves from `$APPIMAGE` first: `process.execPath` is the ephemeral AppImage FUSE mountdiff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.mdindex 6318cdd18..6dba65e89 100644--- a/TROUBLESHOOTING.md+++ b/TROUBLESHOOTING.md@@ -201,7 +201,7 @@ Allow OpenWhispr through Windows Firewall when using cloud transcription provide**Firewall prompt for sherpa-onnx (local Parakeet transcription):**-Windows may ask whether to allow `sherpa-onnx-ws-win32-x64` on public and private networks the first time local Parakeet transcription starts. The bundled sherpa-onnx server only serves OpenWhispr itself over `127.0.0.1`, but it has no loopback-only bind option, so Windows sees it listening on all interfaces. Either choice is safe — Windows never filters loopback traffic, so transcription works even if you click Cancel. All-users installs register a firewall rule that blocks outside access and suppresses the prompt entirely; per-user and portable builds may still see it once.+Windows may ask whether to allow `sherpa-onnx-ws-win32-x64` on public and private networks the first time local Parakeet transcription starts. The bundled sherpa-onnx server only serves OpenWhispr itself over `127.0.0.1`, but it has no loopback-only bind option, so Windows sees it listening on all interfaces. Either choice is safe — Windows never filters loopback traffic, so transcription works even if you click Cancel. All-users installs register a firewall rule that blocks outside access and suppresses the prompt entirely; per-user installs may still see it once.**Complete reset (after uninstalling):**diff --git a/docs/superpowers/specs/2026-09-21-windows-tray-identity-design.md b/docs/superpowers/specs/2026-09-21-windows-tray-identity-design.mdindex 898a5babf..30ee43d41 100644--- a/docs/superpowers/specs/2026-09-21-windows-tray-identity-design.md+++ b/docs/superpowers/specs/2026-09-21-windows-tray-identity-design.md@@ -21,7 +21,7 @@ Use the permanent Windows production GUID **`9afd9bd5-53da-42ef-8334-6e2b494c66f`main.js` resolves and sets the channel before loading `TrayManager`, so the tray reuses that value instead of inferring a second one. Development and staging have their own profile and single-instance lock, so they can run beside production. They receive no GUID, even when packaged and signed, so they cannot claim the production identifier.-Installed and portable production builds share this identity. Both use the production profile and the same single-instance lock, so they never run at the same time. Native acceptance must exercise the extracted portable executable, whose temporary path can change between builds.+Installed production builds carry this identity. Portable production builds shared it until the portable target was removed in PR #2301.## Signing contract@@ -67,7 +67,7 @@ Native evidence, for each Windows version:2. Manually promote/reorder the icon, quit normally, relaunch twice, reboot, then upgrade to a second candidate signed on a different day. Azure Trusted Signing issues short-lived certificates that rotate daily, so this pair checks that Windows keys the GUID to the publisher rather than to one certificate. Record visibility and order after each step.3. End the app from Task Manager, then relaunch. A failed icon add is only logged, so confirm the icon returns after a process that never removed it, not only after a normal quit.4. Put the icon back in overflow and repeat relaunch/update checks to prove the user's hidden choice is respected.-5. Repeat at another installation path and with two signed portable versions. Record each running inner executable's path, signature status, subject, version, and SHA; moving only the outer portable launcher is insufficient.+5. Repeat at another installation path. Record the running executable's path, signature status, subject, version, and SHA.6. Run unsigned production packages and development/staging variants from two paths. Their tray must remain usable, and a separately runnable channel must not take over production's identity.7. Check left-click toggle, right-click menu, quick actions, quit, and no extra icons. Record actual ordering without claiming guaranteed adjacency to Windows controls.diff --git a/electron-builder.json b/electron-builder.jsonindex 9a5dd6663..1c742b198 100644--- a/electron-builder.json+++ b/electron-builder.json@@ -177,7 +177,7 @@}},"win": {- "target": ["nsis", "portable"],+ "target": ["nsis"],"icon": "src/assets/icon.ico","forceCodeSigning": true,"azureSignOptions": {diff --git a/src/helpers/autoStartPolicy.js b/src/helpers/autoStartPolicy.jsindex a3fa79e5d..7fca52605 100644--- a/src/helpers/autoStartPolicy.js+++ b/src/helpers/autoStartPolicy.js@@ -47,41 +47,19 @@ function wasLaunchedHidden({ platform, argv, loginItemSettings }) {// A relaunch must not replay how this process was launched: --hidden would put the// restarted app in the tray, and startup would handle a cold-start deep link again-// (a sign-in link would restore the session a reset just cleared). An AppImage and-// the Windows portable build run from a directory that is gone once this process-// exits (the FUSE mount; the stub's %TEMP% unpack dir), so app.relaunch() cannot-// bring them back: getRelaunchWaiter() starts the on-disk file from outside instead.-function getRelaunchOptions({ argv, protocol, appImagePath, portableExecutablePath }) {+// (a sign-in link would restore the session a reset just cleared). An AppImage runs+// from a FUSE mount that is gone once this process exits, so app.relaunch() cannot+// bring it back: getRelaunchWaiter() starts the on-disk file from outside instead.+function getRelaunchOptions({ argv, protocol, appImagePath }) {const args = argv.slice(1).filter((arg) => arg !== HIDDEN_LAUNCH_FLAG && !arg.startsWith(`${protocol}://`));- const launcherPath = appImagePath || portableExecutablePath;- return launcherPath ? { launcherPath, args } : { args };+ return appImagePath ? { launcherPath: appImagePath, args } : { args };}-// The portable stub deletes its unpack dir only after the app exits, so on Windows the-// waiter must outlive the stub (this process's parent), not just this process.-function getRelaunchWaiter({- platform,- launcherPath,- args,- pid,- ppid,- systemRoot = "C:\\Windows",-}) {- if (platform === "win32") {- const quote = (value) => `'${String(value).replace(/'/g, "''")}'`;- const argumentList = args.length ? ` -ArgumentList ${args.map(quote).join(",")}` : "";- return {- file: `${systemRoot}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`,- args: [- "-NoProfile",- "-NonInteractive",- "-Command",- `Wait-Process -Id ${ppid}; Start-Process -FilePath ${quote(launcherPath)}${argumentList}`,- ],- };- }+// Polls until the pid exits (and the FUSE mount with it), then execs the AppImage+// with the surviving args.+function getRelaunchWaiter({ launcherPath, args, pid }) {return {file: "/bin/sh",args: [diff --git a/src/helpers/ipcHandlers.js b/src/helpers/ipcHandlers.jsindex 365b3eb58..b42cb179f 100644--- a/src/helpers/ipcHandlers.js+++ b/src/helpers/ipcHandlers.js@@ -3891,17 +3891,9 @@ class IPCHandlers {argv: process.argv,protocol: this.oauthProtocol,appImagePath: process.env.APPIMAGE,- portableExecutablePath: process.env.PORTABLE_EXECUTABLE_FILE,});if (launcherPath) {- const waiter = getRelaunchWaiter({- platform: process.platform,- launcherPath,- args,- pid: process.pid,- ppid: process.ppid,- systemRoot: process.env.SystemRoot,- });+ const waiter = getRelaunchWaiter({ launcherPath, args, pid: process.pid });require("child_process").spawn(waiter.file, waiter.args, {detached: true,diff --git a/test/helpers/autoStartPolicy.test.js b/test/helpers/autoStartPolicy.test.jsindex 568810236..2a3e4b454 100644--- a/test/helpers/autoStartPolicy.test.js+++ b/test/helpers/autoStartPolicy.test.js@@ -186,25 +186,12 @@ test("an AppImage relaunches from the AppImage file, not its FUSE mount", () =>);});-test("the Windows portable build relaunches from the portable exe, not its unpack dir", () => {- assert.deepEqual(- getRelaunchOptions({- argv: ["C:\\Users\\me\\AppData\\Local\\Temp\\2abc\\OpenWhispr.exe", HIDDEN_LAUNCH_FLAG],- protocol: "openwhispr",- portableExecutablePath: "D:\\Tools\\OpenWhispr-1.10.0.exe",- }),- { launcherPath: "D:\\Tools\\OpenWhispr-1.10.0.exe", args: [] }- );-});-test("the AppImage waiter outlives this process, then execs the file with its args", () => {assert.deepEqual(getRelaunchWaiter({- platform: "linux",launcherPath: "/home/user/OpenWhispr.AppImage",args: ["--no-sandbox"],pid: 4242,- ppid: 4200,}),{file: "/bin/sh",@@ -218,46 +205,3 @@ test("the AppImage waiter outlives this process, then execs the file with its ar});});--test("the portable waiter waits for the stub and quotes the path for PowerShell", () => {- assert.deepEqual(- getRelaunchWaiter({- platform: "win32",- launcherPath: "D:\\Tom's Tools\\OpenWhispr.exe",- args: ["--log-level=debug"],- pid: 4242,- ppid: 4200,- systemRoot: "D:\\Win",- }),- {- file: "D:\\Win\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",- args: [- "-NoProfile",- "-NonInteractive",- "-Command",- "Wait-Process -Id 4200; Start-Process -FilePath 'D:\\Tom''s Tools\\OpenWhispr.exe' -ArgumentList '--log-level=debug'",- ],- }- );-});--test("the portable waiter runs the system PowerShell and omits -ArgumentList without args", () => {- assert.deepEqual(- getRelaunchWaiter({- platform: "win32",- launcherPath: "D:\\Tools\\OpenWhispr.exe",- args: [],- pid: 4242,- ppid: 4200,- }),- {- file: "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",- args: [- "-NoProfile",- "-NonInteractive",- "-Command",- "Wait-Process -Id 4200; Start-Process -FilePath 'D:\\Tools\\OpenWhispr.exe'",- ],- }- );-});