Skip to content

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

fix(windows): suppress firewall prompt for bundled sherpa-onnx server (#1090)

Gabriel Stein2e4558065a02
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e9057564a..667e67f92 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [Unreleased]
+
+### Fixes
+
+- **No more Windows Firewall prompt for local Parakeet transcription.** The bundled sherpa-onnx server only serves OpenWhispr itself over `127.0.0.1`, but the upstream binary has no loopback-only bind option, so Windows raised an "allow public and private networks" prompt when it started. All-users installs now register a scoped inbound block rule for the server binary: the prompt is gone, the port is closed to the network, and transcription is unaffected because Windows never filters loopback traffic. The rule is removed on uninstall. (#1090)
+
## [1.7.4] - 2026-07-07
A feature-and-hardening release on top of 1.7.3: Tinfoil confidential inference for both transcription and AI reasoning, Azure AI Foundry / Azure OpenAI speech-to-text, native Windows system-audio capture for meeting notes, enterprise SSO in onboarding, cross-device Snippets sync, ambient sync that now runs even in tray-only sessions, and a broad stack of fixes across cleanup routing, clipboard, media playback, hotkeys, local GPU transcription, macOS paste, updates, and Linux packaging — plus SOC 2 dependency remediation.
diff --git a/TROUBLESHOOTING.md b/TROUBLESHOOTING.md
index 581c11658..6d900ecea 100644
--- a/TROUBLESHOOTING.md
+++ b/TROUBLESHOOTING.md
@@ -189,6 +189,10 @@ Right-click OpenWhispr → Run as administrator (or set permanently in Propertie
Allow OpenWhispr through Windows Firewall when using cloud transcription providers.
+**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.
+
**Complete reset (after uninstalling):**
```batch
diff --git a/electron-builder.json b/electron-builder.json
index 96d988d39..7bc7ac314 100644
--- a/electron-builder.json
+++ b/electron-builder.json
@@ -240,7 +240,7 @@
"allowToChangeInstallationDirectory": true,
"createDesktopShortcut": true,
"createStartMenuShortcut": true,
- "include": "resources/nsis/cleanup-models.nsh"
+ "include": "resources/nsis/installer.nsh"
},
"dmg": {
"title": "OpenWhispr",
diff --git a/resources/nsis/cleanup-models.nsh b/resources/nsis/cleanup-models.nsh
deleted file mode 100644
index d2622d4dd..000000000
--- a/resources/nsis/cleanup-models.nsh
+++ /dev/null
@@ -1,14 +0,0 @@
-!macro customHeader
- ManifestDPIAware true
-!macroend
-
-!macro customUnInstall
- ${ifNot} ${isUpdated}
- StrCpy $0 "$PROFILE\.cache\openwhispr\models"
- IfFileExists "$0\*.*" 0 +3
- RMDir /r "$0"
- DetailPrint "Removed OpenWhispr cached models"
- StrCpy $1 "$PROFILE\.cache\openwhispr"
- RMDir "$1"
- ${endIf}
-!macroend
diff --git a/resources/nsis/installer.nsh b/resources/nsis/installer.nsh
new file mode 100644
index 000000000..4dd142001
--- /dev/null
+++ b/resources/nsis/installer.nsh
@@ -0,0 +1,28 @@
+!macro customHeader
+ ManifestDPIAware true
+!macroend
+
+; The bundled sherpa-onnx server (local Parakeet transcription) only serves
+; this app over 127.0.0.1, but the upstream binary has no loopback-only bind
+; option, so its wildcard listener triggers a Windows Firewall prompt. A
+; scoped inbound BLOCK rule suppresses the prompt and closes the port to the
+; network; loopback is never filtered, so transcription is unaffected.
+; netsh needs elevation — per-user installs skip this silently.
+!define SHERPA_FIREWALL_RULE "OpenWhispr Local Transcription Server (sherpa-onnx)"
+
+!macro customInstall
+ nsExec::ExecToLog 'netsh advfirewall firewall delete rule name="${SHERPA_FIREWALL_RULE}"'
+ nsExec::ExecToLog 'netsh advfirewall firewall add rule name="${SHERPA_FIREWALL_RULE}" dir=in action=block program="$INSTDIR\resources\bin\sherpa-onnx-ws-win32-x64.exe" enable=yes profile=any'
+!macroend
+
+!macro customUnInstall
+ ${ifNot} ${isUpdated}
+ nsExec::ExecToLog 'netsh advfirewall firewall delete rule name="${SHERPA_FIREWALL_RULE}"'
+ StrCpy $0 "$PROFILE\.cache\openwhispr\models"
+ IfFileExists "$0\*.*" 0 +3
+ RMDir /r "$0"
+ DetailPrint "Removed OpenWhispr cached models"
+ StrCpy $1 "$PROFILE\.cache\openwhispr"
+ RMDir "$1"
+ ${endIf}
+!macroend