Skip to content

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

fix: surface TLS/certificate errors in model download UI

Gabriel Stein1f4e7c4d34d6
diff --git a/src/helpers/downloadUtils.js b/src/helpers/downloadUtils.js
index e249100da..971c57b54 100644
--- a/src/helpers/downloadUtils.js
+++ b/src/helpers/downloadUtils.js
@@ -27,8 +27,25 @@ const RETRYABLE_CODES = new Set([
"ERR_DOWNLOAD_INCOMPLETE",
]);
+const TLS_ERROR_CODES = new Set([
+ "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+ "DEPTH_ZERO_SELF_SIGNED_CERT",
+ "SELF_SIGNED_CERT_IN_CHAIN",
+ "CERT_HAS_EXPIRED",
+ "ERR_TLS_CERT_ALTNAME_INVALID",
+ "CERT_UNTRUSTED",
+]);
+
+function isTlsError(error) {
+ return (
+ TLS_ERROR_CODES.has(error.code) ||
+ (error.message &&
+ error.message.includes("unable to get local issuer certificate"))
+ );
+}
+
function isRetryable(error) {
- if (error.isAbort || error.isHttpError) return false;
+ if (error.isAbort || error.isHttpError || isTlsError(error)) return false;
return RETRYABLE_CODES.has(error.code);
}
@@ -219,6 +236,13 @@ function downloadAttempt(url, tempPath, options) {
cleanup();
if (signal?.aborted) {
reject(Object.assign(new Error("Download cancelled"), { isAbort: true }));
+ } else if (isTlsError(err)) {
+ reject(
+ Object.assign(
+ new Error(`Certificate error: ${err.message}`),
+ { code: "TLS_ERROR", isTlsError: true },
+ ),
+ );
} else {
reject(err);
}
@@ -321,6 +345,11 @@ async function downloadFile(url, destPath, options = {}) {
}
if (!isRetryable(error) || attempt >= maxRetries) {
+ debugLogger.error("Download failed", {
+ url,
+ error: error.message,
+ code: error.code,
+ });
await fsPromises.unlink(tempPath).catch(() => {});
throw error;
}
diff --git a/src/hooks/useModelDownload.ts b/src/hooks/useModelDownload.ts
index c644765cc..9e4650eea 100644
--- a/src/hooks/useModelDownload.ts
+++ b/src/hooks/useModelDownload.ts
@@ -41,6 +41,8 @@ export function formatETA(seconds: number): string {
function getDownloadErrorMessage(t: TFunction, error: string, code?: string): string {
if (code === "EXTRACTION_FAILED" || error.includes("installation failed"))
return t("hooks.modelDownload.errors.extractionFailed");
+ if (code === "TLS_ERROR" || error.includes("certificate") || error.includes("issuer"))
+ return t("hooks.modelDownload.errors.tlsError");
if (code === "ETIMEDOUT" || error.includes("timeout") || error.includes("stalled"))
return t("hooks.modelDownload.errors.timeout");
if (code === "ENOTFOUND" || error.includes("ENOTFOUND"))
diff --git a/src/locales/de/translation.json b/src/locales/de/translation.json
index c4ad4f48b..4cf503a93 100644
--- a/src/locales/de/translation.json
+++ b/src/locales/de/translation.json
@@ -391,8 +391,9 @@
"rateLimited": "Download-Server begrenzt Anfragen. Bitte warten Sie einige Minuten und versuchen Sie es erneut.",
"server": "Serverfehler ({{error}}). Bitte versuchen Sie es später erneut.",
"generic": "Download fehlgeschlagen: {{error}}",
- "extractionFailed": "Modell heruntergeladen, aber Installation fehlgeschlagen. Klicken Sie auf „Herunterladen“, um die Installation ohne erneuten Download zu wiederholen.",
- "unknown": "Unbekannter Fehler"
+ “extractionFailed”: “Modell heruntergeladen, aber Installation fehlgeschlagen. Klicken Sie auf „Herunterladen”, um die Installation ohne erneuten Download zu wiederholen.”,
+ “tlsError”: “Zertifikatsfehler — Ihr Netzwerk verwendet möglicherweise SSL-Inspektion, die Downloads blockiert. Versuchen Sie es über ein anderes Netzwerk.”,
+ “unknown”: “Unbekannter Fehler”
},
"downloadFailed": {
"title": "Download fehlgeschlagen"
diff --git a/src/locales/en/translation.json b/src/locales/en/translation.json
index 054748775..5013ff68e 100644
--- a/src/locales/en/translation.json
+++ b/src/locales/en/translation.json
@@ -392,6 +392,7 @@
"server": "Server error ({{error}}). Please try again later.",
"generic": "Download failed: {{error}}",
"extractionFailed": "Model downloaded but installation failed. Click download to retry installation without re-downloading.",
+ "tlsError": "Certificate error — your network may use SSL inspection that blocks downloads. Try downloading from a different network.",
"unknown": "Unknown error"
},
"downloadFailed": {
diff --git a/src/locales/es/translation.json b/src/locales/es/translation.json
index 1497a285a..1f3e79c7e 100644
--- a/src/locales/es/translation.json
+++ b/src/locales/es/translation.json
@@ -392,6 +392,7 @@
"server": "Error del servidor ({{error}}). Inténtalo más tarde.",
"generic": "Falló la descarga: {{error}}",
"extractionFailed": "Modelo descargado, pero la instalación falló. Haz clic en descargar para reintentar la instalación sin volver a descargar.",
+ "tlsError": "Error de certificado — tu red puede usar inspección SSL que bloquea las descargas. Intenta descargar desde otra red.",
"unknown": "Error desconocido"
},
"downloadFailed": {
diff --git a/src/locales/fr/translation.json b/src/locales/fr/translation.json
index 3e3360c0a..50675c405 100644
--- a/src/locales/fr/translation.json
+++ b/src/locales/fr/translation.json
@@ -392,6 +392,7 @@
"server": "Erreur serveur ({{error}}). Réessayez plus tard.",
"generic": "Échec du téléchargement : {{error}}",
"extractionFailed": "Modèle téléchargé, mais l'installation a échoué. Cliquez sur télécharger pour relancer l'installation sans retélécharger.",
+ "tlsError": "Erreur de certificat — votre réseau utilise peut-être une inspection SSL qui bloque les téléchargements. Essayez depuis un autre réseau.",
"unknown": "Erreur inconnue"
},
"downloadFailed": {
diff --git a/src/locales/it/translation.json b/src/locales/it/translation.json
index a2f55088f..40c0020db 100644
--- a/src/locales/it/translation.json
+++ b/src/locales/it/translation.json
@@ -392,6 +392,7 @@
"server": "Errore server ({{error}}). Riprova più tardi.",
"generic": "Download non riuscito: {{error}}",
"extractionFailed": "Modello scaricato, ma l'installazione non è riuscita. Clicca su scarica per ritentare l'installazione senza riscaricare.",
+ "tlsError": "Errore di certificato — la tua rete potrebbe usare l'ispezione SSL che blocca i download. Prova a scaricare da un'altra rete.",
"unknown": "Errore sconosciuto"
},
"downloadFailed": {
diff --git a/src/locales/ja/translation.json b/src/locales/ja/translation.json
index 1cc1119a9..03fa611a2 100644
--- a/src/locales/ja/translation.json
+++ b/src/locales/ja/translation.json
@@ -392,6 +392,7 @@
"server": "サーバーエラー({{error}})。後でもう一度お試しください。",
"generic": "ダウンロードに失敗しました: {{error}}",
"extractionFailed": "モデルのダウンロードは完了しましたが、インストールに失敗しました。ダウンロードをクリックして再ダウンロードなしでインストールを再試行してください。",
+ "tlsError": "証明書エラー — ネットワークのSSL検査がダウンロードをブロックしている可能性があります。別のネットワークからお試しください。",
"unknown": "不明なエラー"
},
"downloadFailed": {
diff --git a/src/locales/pt/translation.json b/src/locales/pt/translation.json
index fe7032a91..51baf97c0 100644
--- a/src/locales/pt/translation.json
+++ b/src/locales/pt/translation.json
@@ -364,6 +364,7 @@
"server": "Erro do servidor ({{error}}). Tente mais tarde.",
"generic": "Falha no download: {{error}}",
"extractionFailed": "Modelo baixado, mas a instalação falhou. Clique em baixar para tentar a instalação novamente sem precisar baixar de novo.",
+ "tlsError": "Erro de certificado — sua rede pode usar inspeção SSL que bloqueia downloads. Tente baixar de outra rede.",
"unknown": "Erro desconhecido"
},
"downloadFailed": {
diff --git a/src/locales/ru/translation.json b/src/locales/ru/translation.json
index 059c4b2eb..54cf43dd4 100644
--- a/src/locales/ru/translation.json
+++ b/src/locales/ru/translation.json
@@ -392,6 +392,7 @@
"server": "Ошибка сервера ({{error}}). Попробуйте позже.",
"generic": "Ошибка загрузки: {{error}}",
"extractionFailed": "Модель скачана, но установка не удалась. Нажмите «Скачать» для повторной установки без повторной загрузки.",
+ "tlsError": "Ошибка сертификата — ваша сеть может использовать SSL-инспекцию, блокирующую загрузки. Попробуйте скачать из другой сети.",
"unknown": "Неизвестная ошибка"
},
"downloadFailed": {
diff --git a/src/locales/zh-CN/translation.json b/src/locales/zh-CN/translation.json
index 3e01289c7..dec64125c 100644
--- a/src/locales/zh-CN/translation.json
+++ b/src/locales/zh-CN/translation.json
@@ -392,6 +392,7 @@
"server": "服务器错误({{error}}),请稍后重试。",
"generic": "下载失败:{{error}}",
"extractionFailed": "模型已下载但安装失败。点击下载以重新安装,无需重新下载。",
+ "tlsError": "证书错误 — 您的网络可能使用了阻止下载的SSL检查。请尝试从其他网络下载。",
"unknown": "未知错误"
},
"downloadFailed": {
diff --git a/src/locales/zh-TW/translation.json b/src/locales/zh-TW/translation.json
index 514887d65..c7d12bd78 100644
--- a/src/locales/zh-TW/translation.json
+++ b/src/locales/zh-TW/translation.json
@@ -392,6 +392,7 @@
"server": "伺服器錯誤({{error}})。請稍後再試。",
"generic": "下載失敗:{{error}}",
"extractionFailed": "模型已下載,但安裝失敗。點擊下載可重試安裝,無需重新下載。",
+ "tlsError": "憑證錯誤 — 您的網路可能使用了阻擋下載的SSL檢查。請嘗試從其他網路下載。",
"unknown": "未知錯誤"
},
"downloadFailed": {