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
feat: add permission UX and setup guide for Linux push-to-talk
Alcahestffd76c7ca31c
diff --git a/main.js b/main.jsindex 7ddd49200..b073cb1fe 100644--- a/main.js+++ b/main.js@@ -1062,6 +1062,13 @@ async function startApp() {}});+ linuxKeyManager.on("permission-denied", () => {+ debugLogger.warn("[Push-to-Talk] Linux key listener has no permission to access input devices");+ if (isLiveWindow(windowManager.mainWindow)) {+ windowManager.mainWindow.webContents.send("linux-ptt-permission-denied");+ }+ });+linuxKeyManager.on("error", (error) => {debugLogger.warn("[Push-to-Talk] Linux key listener error", { error: error.message });});diff --git a/preload.js b/preload.jsindex 6b2f38d4c..d048a2915 100644--- a/preload.js+++ b/preload.js@@ -557,6 +557,7 @@ contextBridge.exposeInMainWorld("electronAPI", {return () => ipcRenderer.removeListener("dictation-key-active", listener);},onWindowsPushToTalkUnavailable: registerListener("windows-ptt-unavailable"),+ onLinuxPttPermissionDenied: registerListener("linux-ptt-permission-denied", (callback) => () => callback()),// Settings shortcut (Cmd+, / Ctrl+,)onShowSettings: registerListener("show-settings", (callback) => () => callback()),diff --git a/resources/linux-key-listener.c b/resources/linux-key-listener.cindex 5011ad83e..05eaf721a 100644--- a/resources/linux-key-listener.c+++ b/resources/linux-key-listener.c@@ -41,6 +41,7 @@ static unsigned char held_keys[KEY_BITS_SIZE];static int device_fds[MAX_DEVICES];static int device_count = 0;+static int permission_denied_count = 0;static int epoll_fd = -1;static void signal_handler(int sig) {@@ -257,8 +258,10 @@ static int add_device(const char *path) {int fd = open(path, O_RDONLY | O_NONBLOCK);if (fd < 0) {- if (errno == EACCES)- fprintf(stderr, "Permission denied: %s (try running with sudo or adding user to 'input' group)\n", path);+ if (errno == EACCES) {+ permission_denied_count++;+ fprintf(stderr, "Permission denied: %s\n", path);+ }return -1;}@@ -410,8 +413,12 @@ int main(int argc, char *argv[]) {scan_devices();- if (device_count == 0)+ if (device_count == 0 && permission_denied_count > 0) {+ printf("NO_PERMISSION\n");+ fflush(stdout);+ } else if (device_count == 0) {fprintf(stderr, "Warning: no keyboard devices found, waiting for hotplug\n");+ }printf("READY\n");fflush(stdout);diff --git a/src/components/SettingsPage.tsx b/src/components/SettingsPage.tsxindex d7568578d..4c8293b0d 100644--- a/src/components/SettingsPage.tsx+++ b/src/components/SettingsPage.tsx@@ -63,6 +63,7 @@ import { validateHotkeyForSlot } from "../utils/hotkeyValidation";import { getPlatform, getCachedPlatform } from "../utils/platform";import { formatHotkeyLabel } from "../utils/hotkeys";import { ActivationModeSelector } from "./ui/ActivationModeSelector";+import LinuxPttSetupInfo from "./ui/LinuxPttSetupInfo";import { Toggle } from "./ui/toggle";import DeveloperSection from "./DeveloperSection";import AgentModeSettings from "./settings/AgentModeSettings";@@ -1009,6 +1010,7 @@ export default function SettingsPage({ activeSection = "general" }: SettingsPageconst [isUsingNativeShortcut, setIsUsingNativeShortcut] = useState(false);const [effectiveDefaultHotkey, setEffectiveDefaultHotkey] = useState<string | null>(null);+ const [linuxPttAvailable, setLinuxPttAvailable] = useState(true);const platform = getCachedPlatform();@@ -1125,6 +1127,20 @@ export default function SettingsPage({ activeSection = "general" }: SettingsPagecheckHotkeyMode();}, [setActivationMode]);+ useEffect(() => {+ const cleanup = window.electronAPI?.onLinuxPttPermissionDenied?.(() => {+ setLinuxPttAvailable(false);+ toast({+ title: t("settingsPage.general.hotkey.linuxPttPermissionTitle"),+ description: t("settingsPage.general.hotkey.linuxPttPermissionDescription"),+ variant: "destructive",+ duration: 15000,+ });+ setActivationMode("tap");+ });+ return () => cleanup?.();+ }, [toast, t, setActivationMode]);+useEffect(() => {if (updateError) {showAlertDialog({@@ -3000,6 +3016,9 @@ EOF`,{t("settingsPage.general.hotkey.activationMode")}</p><ActivationModeSelector value={activationMode} onChange={setActivationMode} />+ {getCachedPlatform() === "linux" && activationMode === "push" && (+ <LinuxPttSetupInfo isAvailable={linuxPttAvailable} />+ )}</SettingsPanelRow>)}</SettingsPanel>diff --git a/src/components/ui/CopyableCommand.tsx b/src/components/ui/CopyableCommand.tsxnew file mode 100644index 000000000..1d1a302e6--- /dev/null+++ b/src/components/ui/CopyableCommand.tsx@@ -0,0 +1,42 @@+import { useState, useCallback } from "react";+import { Copy, Check } from "lucide-react";++interface CopyableCommandProps {+ command: string;+ label?: string;+ className?: string;+}++export function CopyableCommand({ command, label, className = "" }: CopyableCommandProps) {+ const [copied, setCopied] = useState(false);++ const handleCopy = useCallback(() => {+ navigator.clipboard.writeText(command).then(() => {+ setCopied(true);+ setTimeout(() => setCopied(false), 2000);+ }).catch(() => {});+ }, [command]);++ return (+ <div className={className}>+ {label && (+ <div className="text-xs text-muted-foreground mb-1">{label}</div>+ )}+ <div className="relative bg-card border border-border p-3 rounded-md font-mono text-xs overflow-x-auto">+ <span className="text-foreground pr-8">{command}</span>+ <button+ type="button"+ onClick={handleCopy}+ aria-label={copied ? "Copied" : "Copy command"}+ className="absolute top-2 right-2 h-6 w-6 flex items-center justify-center rounded text-muted-foreground/40 hover:text-muted-foreground hover:bg-muted/50 active:scale-95 transition-all"+ >+ {copied ? (+ <Check className="w-3.5 h-3.5 text-success" />+ ) : (+ <Copy className="w-3.5 h-3.5" />+ )}+ </button>+ </div>+ </div>+ );+}diff --git a/src/components/ui/LinuxPttSetupInfo.tsx b/src/components/ui/LinuxPttSetupInfo.tsxnew file mode 100644index 000000000..6f3f038ac--- /dev/null+++ b/src/components/ui/LinuxPttSetupInfo.tsx@@ -0,0 +1,36 @@+import { useTranslation } from "react-i18next";+import { Info } from "lucide-react";+import { InfoBox } from "./InfoBox";+import { CopyableCommand } from "./CopyableCommand";++interface LinuxPttSetupInfoProps {+ isAvailable: boolean;+}++export default function LinuxPttSetupInfo({ isAvailable }: LinuxPttSetupInfoProps) {+ const { t } = useTranslation();++ if (isAvailable) {+ return null;+ }++ return (+ <InfoBox variant="warning" className="mt-3">+ <div className="flex items-start gap-3">+ <Info className="w-6 h-6 text-warning dark:text-warning flex-shrink-0 mt-0.5" />+ <div className="flex-1">+ <h3 className="font-semibold text-warning dark:text-warning">+ {t("settingsPage.general.hotkey.linuxPttSetupTitle")}+ </h3>+ <p className="text-sm text-warning dark:text-warning mt-1">+ {t("settingsPage.general.hotkey.linuxPttSetupDescription")}+ </p>+ <CopyableCommand command="sudo usermod -aG input $USER" className="mt-3" />+ <p className="text-sm text-warning dark:text-warning mt-3">+ {t("settingsPage.general.hotkey.linuxPttSetupNote")}+ </p>+ </div>+ </div>+ </InfoBox>+ );+}diff --git a/src/helpers/linuxKeyManager.js b/src/helpers/linuxKeyManager.jsindex 0133ff9c8..1ea7c0080 100644--- a/src/helpers/linuxKeyManager.js+++ b/src/helpers/linuxKeyManager.js@@ -76,8 +76,14 @@ class LinuxKeyManager extends EventEmitter {debugLogger.debug("[LinuxKeyManager] Listener ready", { key });this.isReady = true;this.emit("ready");+ } else if (line === "NO_PERMISSION") {+ debugLogger.warn("[LinuxKeyManager] No permission to access input devices");+ this.emit("permission-denied");} else if (line === "KEY_DOWN") {debugLogger.debug("[LinuxKeyManager] KEY_DOWN detected", { key });+ if (this.watchdogTimer) {+ clearTimeout(this.watchdogTimer);+ }this.watchdogTimer = setTimeout(() => {debugLogger.warn("[LinuxKeyManager] Watchdog: no KEY_UP received within 30s, forcing release");this.emit("key-up", this.currentKey);diff --git a/src/locales/de/translation.json b/src/locales/de/translation.jsonindex 9fc78391c..8a43d7a60 100644--- a/src/locales/de/translation.json+++ b/src/locales/de/translation.json@@ -1181,7 +1181,12 @@"activationMode": "Aktivierungsmodus","description": "Die Tastenkombination, die das Sprachdiktat startet und stoppt","resetToDefault": "Auf {{hotkey}} zurücksetzen",- "title": "Diktat-Hotkey"+ "title": "Diktat-Hotkey",+ "linuxPttPermissionTitle": "Gedrückt halten zum Sprechen erfordert zusätzliche Einrichtung",+ "linuxPttPermissionDescription": "Führen Sie diesen Befehl aus und melden Sie sich ab/an: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Gedrückt halten zum Sprechen erfordert Einrichtung",+ "linuxPttSetupDescription": "Ihr Benutzer benötigt Zugriff auf die Tastatureingabegeräte.",+ "linuxPttSetupNote": "Melden Sie sich nach dem Ausführen des Befehls ab und wieder an."},"meetingHotkey": {"title": "Meeting-Modus-Hotkey",diff --git a/src/locales/en/translation.json b/src/locales/en/translation.jsonindex cba882f3e..58d8b1d17 100644--- a/src/locales/en/translation.json+++ b/src/locales/en/translation.json@@ -1229,7 +1229,12 @@"activationMode": "Activation Mode","description": "The key combination that starts and stops voice dictation","resetToDefault": "Reset to {{hotkey}}",- "title": "Dictation Hotkey"+ "title": "Dictation Hotkey",+ "linuxPttPermissionTitle": "Hold to Speak needs extra setup",+ "linuxPttPermissionDescription": "Run this command and log out/in: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Hold to Speak needs setup",+ "linuxPttSetupDescription": "Your user needs access to keyboard input devices.",+ "linuxPttSetupNote": "After running the command, log out and log back in."},"meetingHotkey": {"title": "Meeting Mode Hotkey",diff --git a/src/locales/es/translation.json b/src/locales/es/translation.jsonindex 672d1ca0b..1bc3611bd 100644--- a/src/locales/es/translation.json+++ b/src/locales/es/translation.json@@ -1181,7 +1181,12 @@"activationMode": "Modo de activación","description": "La combinación de teclas que inicia y detiene el dictado por voz","resetToDefault": "Restablecer a {{hotkey}}",- "title": "Atajo de dictado"+ "title": "Atajo de dictado",+ "linuxPttPermissionTitle": "Mantener para hablar requiere configuración adicional",+ "linuxPttPermissionDescription": "Ejecuta este comando y cierra sesión: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Mantener para hablar requiere configuración",+ "linuxPttSetupDescription": "Tu usuario necesita acceso a los dispositivos de entrada del teclado.",+ "linuxPttSetupNote": "Después de ejecutar el comando, cierra sesión y vuelve a iniciarla."},"meetingHotkey": {"title": "Atajo modo reunión",diff --git a/src/locales/fr/translation.json b/src/locales/fr/translation.jsonindex b9ef9bd12..daee9a386 100644--- a/src/locales/fr/translation.json+++ b/src/locales/fr/translation.json@@ -1181,7 +1181,12 @@"activationMode": "Mode d'activation","description": "La combinaison de touches qui démarre et arrête la dictée vocale","resetToDefault": "Réinitialiser à {{hotkey}}",- "title": "Raccourci de dictée"+ "title": "Raccourci de dictée",+ "linuxPttPermissionTitle": "Maintenir pour parler nécessite une configuration",+ "linuxPttPermissionDescription": "Exécutez cette commande et déconnectez-vous : sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Maintenir pour parler nécessite une configuration",+ "linuxPttSetupDescription": "Votre utilisateur a besoin d'accéder aux périphériques de saisie clavier.",+ "linuxPttSetupNote": "Après avoir exécuté la commande, déconnectez-vous et reconnectez-vous."},"meetingHotkey": {"title": "Raccourci mode réunion",diff --git a/src/locales/it/translation.json b/src/locales/it/translation.jsonindex 11a1ea867..93077042f 100644--- a/src/locales/it/translation.json+++ b/src/locales/it/translation.json@@ -1181,7 +1181,12 @@"activationMode": "Modalità di attivazione","description": "La combinazione di tasti che avvia e ferma la dettatura vocale","resetToDefault": "Ripristina a {{hotkey}}",- "title": "Scorciatoia di dettatura"+ "title": "Scorciatoia di dettatura",+ "linuxPttPermissionTitle": "Tieni premuto per parlare richiede configurazione",+ "linuxPttPermissionDescription": "Esegui questo comando e riavvia la sessione: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Tieni premuto per parlare richiede configurazione",+ "linuxPttSetupDescription": "Il tuo utente ha bisogno di accesso ai dispositivi di input della tastiera.",+ "linuxPttSetupNote": "Dopo aver eseguito il comando, esci e riaccedi."},"meetingHotkey": {"title": "Scorciatoia modalità meeting",diff --git a/src/locales/ja/translation.json b/src/locales/ja/translation.jsonindex 7643900f0..74120f7ce 100644--- a/src/locales/ja/translation.json+++ b/src/locales/ja/translation.json@@ -1181,7 +1181,12 @@"activationMode": "起動モード","description": "音声ディクテーションの開始/停止に使用するキーの組み合わせ","resetToDefault": "{{hotkey}}にリセット",- "title": "ディクテーションホットキー"+ "title": "ディクテーションホットキー",+ "linuxPttPermissionTitle": "長押しして話すには追加の設定が必要です",+ "linuxPttPermissionDescription": "次のコマンドを実行してログアウト/ログインしてください:sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "長押しして話すには設定が必要です",+ "linuxPttSetupDescription": "キーボード入力デバイスへのアクセス権が必要です。",+ "linuxPttSetupNote": "コマンド実行後、ログアウトして再度ログインしてください。"},"meetingHotkey": {"title": "ミーティングモードホットキー",diff --git a/src/locales/pt/translation.json b/src/locales/pt/translation.jsonindex 06338605d..a5b395d72 100644--- a/src/locales/pt/translation.json+++ b/src/locales/pt/translation.json@@ -1153,7 +1153,12 @@"activationMode": "Modo de ativação","description": "A combinação de teclas que inicia e para o ditado por voz","resetToDefault": "Redefinir para {{hotkey}}",- "title": "Atalho de ditado"+ "title": "Atalho de ditado",+ "linuxPttPermissionTitle": "Manter pressionado para falar requer configuração",+ "linuxPttPermissionDescription": "Execute este comando e faça logout: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Manter pressionado para falar requer configuração",+ "linuxPttSetupDescription": "O seu utilizador precisa de acesso aos dispositivos de entrada do teclado.",+ "linuxPttSetupNote": "Depois de executar o comando, termine e reinicie a sessão."},"meetingHotkey": {"title": "Atalho modo reunião",diff --git a/src/locales/ru/translation.json b/src/locales/ru/translation.jsonindex aaff938fa..99673f564 100644--- a/src/locales/ru/translation.json+++ b/src/locales/ru/translation.json@@ -1181,7 +1181,12 @@"activationMode": "Режим активации","description": "Комбинация клавиш для запуска и остановки голосовой диктовки","resetToDefault": "Сбросить на {{hotkey}}",- "title": "Горячая клавиша диктовки"+ "title": "Горячая клавиша диктовки",+ "linuxPttPermissionTitle": "Для режима «Удерживать для речи» нужна настройка",+ "linuxPttPermissionDescription": "Выполните команду и перезайдите: sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "Для режима «Удерживать для речи» нужна настройка",+ "linuxPttSetupDescription": "Вашему пользователю нужен доступ к устройствам ввода с клавиатуры.",+ "linuxPttSetupNote": "После выполнения команды выйдите из системы и войдите снова."},"meetingHotkey": {"title": "Горячая клавиша режима встречи",diff --git a/src/locales/zh-CN/translation.json b/src/locales/zh-CN/translation.jsonindex eacf28603..80adb1462 100644--- a/src/locales/zh-CN/translation.json+++ b/src/locales/zh-CN/translation.json@@ -1176,7 +1176,12 @@"activationMode": "激活模式","description": "用于开始和停止语音听写的组合键","resetToDefault": "重置为 {{hotkey}}",- "title": "听写快捷键"+ "title": "听写快捷键",+ "linuxPttPermissionTitle": "按住说话需要额外设置",+ "linuxPttPermissionDescription": "运行此命令并重新登录:sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "按住说话需要设置",+ "linuxPttSetupDescription": "您的用户需要访问键盘输入设备的权限。",+ "linuxPttSetupNote": "运行命令后,请注销并重新登录。"},"meetingHotkey": {"title": "会议模式快捷键",diff --git a/src/locales/zh-TW/translation.json b/src/locales/zh-TW/translation.jsonindex 38d9b923a..4857a8221 100644--- a/src/locales/zh-TW/translation.json+++ b/src/locales/zh-TW/translation.json@@ -1176,7 +1176,12 @@"activationMode": "啟用模式","description": "用來開始和停止語音輸入的組合鍵","resetToDefault": "重置為 {{hotkey}}",- "title": "語音輸入快捷鍵"+ "title": "語音輸入快捷鍵",+ "linuxPttPermissionTitle": "按住說話需要額外設定",+ "linuxPttPermissionDescription": "執行此指令並重新登入:sudo usermod -aG input $USER",+ "linuxPttSetupTitle": "按住說話需要設定",+ "linuxPttSetupDescription": "您的使用者需要存取鍵盤輸入裝置的權限。",+ "linuxPttSetupNote": "執行指令後,請登出並重新登入。"},"meetingHotkey": {"title": "會議模式快捷鍵",