Skip to content

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

feat: add permission UX and setup guide for Linux push-to-talk

Alcahestffd76c7ca31c
diff --git a/main.js b/main.js
index 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.js
index 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.c
index 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.tsx
index 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" }: SettingsPage
const [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" }: SettingsPage
checkHotkeyMode();
}, [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.tsx
new file mode 100644
index 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.tsx
new file mode 100644
index 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.js
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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": "會議模式快捷鍵",