feat: add global recording shortcut

src-tauri/src/lib.rs

@@ -4,6 +4,7 @@ pub mod error;
 pub mod injection;
 pub mod models;
 pub mod settings;
+pub mod shortcuts;
 pub mod transcription;
 pub mod tray;
 pub mod ui_commands;
@@ -14,8 +15,10 @@ use app_state::ManagedAppState;
 pub fn run() {
     tauri::Builder::default()
         .plugin(tauri_plugin_opener::init())
+        .plugin(shortcuts::plugin())
         .setup(|app| {
             tray::setup(app)?;
+            shortcuts::setup(app)?;
             Ok(())
         })
         .manage(ManagedAppState::default())

src-tauri/src/shortcuts.rs

@@ -0,0 +1,20 @@
+use tauri::{App, Emitter, Runtime};
+use tauri_plugin_global_shortcut::{Code, GlobalShortcutExt, Modifiers, Shortcut, ShortcutState};
+
+pub const TOGGLE_RECORDING_EVENT: &str = "transcript://toggle-recording";
+
+pub fn plugin<R: Runtime>() -> tauri::plugin::TauriPlugin<R> {
+    tauri_plugin_global_shortcut::Builder::new()
+        .with_handler(|app, _shortcut, event| {
+            if event.state() == ShortcutState::Pressed {
+                let _ = app.emit(TOGGLE_RECORDING_EVENT, ());
+            }
+        })
+        .build()
+}
+
+pub fn setup(app: &App) -> Result<(), Box<dyn std::error::Error>> {
+    let shortcut = Shortcut::new(Some(Modifiers::CONTROL | Modifiers::SHIFT), Code::Space);
+    app.global_shortcut().register(shortcut)?;
+    Ok(())
+}

src/app.ts

@@ -1,10 +1,11 @@
-import { invoke as tauriInvoke } from '@tauri-apps/api/core';
+import { invoke as tauriInvoke } from "@tauri-apps/api/core";
+import { listen } from "@tauri-apps/api/event";
 
-export type RecordingStatus = 'idle' | 'recording';
+export type RecordingStatus = "idle" | "recording";
 
 export interface AppSettings {
 	transcription: {
-    mode: 'localFirst' | 'apiOnly';
+		mode: "localFirst" | "apiOnly";
 		modelId: string;
 		language: string | null;
 		openaiCompatible: {
@@ -14,13 +15,13 @@ export interface AppSettings {
 		};
 	};
 	insertion: {
-    method: 'clipboardPaste' | 'keyTyping' | 'manualCopy';
+		method: "clipboardPaste" | "keyTyping" | "manualCopy";
 		restoreClipboard: boolean;
 		waylandManualFallback: boolean;
 	};
 	storage: {
 		keepAudio: boolean;
-    audioFormat: 'wav' | 'ogg' | 'mp3';
+		audioFormat: "wav" | "ogg" | "mp3";
 	};
 }
 
@@ -35,7 +36,7 @@ export interface ModelWithStatus {
 		languages: string[];
 		recommendedForSimplePc: boolean;
 	};
-  status: 'notInstalled' | 'ready' | { error: string };
+	status: "notInstalled" | "ready" | { error: string };
 }
 
 export interface TranscriptDraft {
@@ -55,52 +56,54 @@ export interface NativeClient {
 }
 
 const fallbackSnapshot: AppSnapshot = {
-  recordingStatus: 'idle',
+	recordingStatus: "idle",
 	transcript: {
-    text: '',
+		text: "",
-    lastMessage: 'Modo pré-visualização: comandos nativos disponíveis dentro do Tauri.',
+		lastMessage:
+			"Modo pré-visualização: comandos nativos disponíveis dentro do Tauri.",
 	},
 	settings: {
 		transcription: {
-      mode: 'localFirst',
+			mode: "localFirst",
-      modelId: 'parakeet-tdt-0.6b-v3-q8_0',
+			modelId: "parakeet-tdt-0.6b-v3-q8_0",
 			language: null,
 			openaiCompatible: {
-        endpoint: 'https://api.openai.com/v1/audio/transcriptions',
+				endpoint: "https://api.openai.com/v1/audio/transcriptions",
 				apiKeyConfigured: false,
-        model: 'whisper-1',
+				model: "whisper-1",
 			},
 		},
 		insertion: {
-      method: 'clipboardPaste',
+			method: "clipboardPaste",
 			restoreClipboard: true,
 			waylandManualFallback: true,
 		},
 		storage: {
 			keepAudio: false,
-      audioFormat: 'wav',
+			audioFormat: "wav",
 		},
 	},
 	models: [
 		{
 			model: {
-        id: 'parakeet-tdt-0.6b-v3-q8_0',
+				id: "parakeet-tdt-0.6b-v3-q8_0",
-        displayName: 'Parakeet TDT 0.6B v3 Q8',
+				displayName: "Parakeet TDT 0.6B v3 Q8",
-        repository: 'cstr/parakeet-tdt-0.6b-v3-GGUF',
+				repository: "cstr/parakeet-tdt-0.6b-v3-GGUF",
-        filename: 'parakeet-tdt-0.6b-v3-q8_0.gguf',
+				filename: "parakeet-tdt-0.6b-v3-q8_0.gguf",
-        quantization: 'Q8_0',
+				quantization: "Q8_0",
 				sizeBytes: 745_121_600,
-        languages: ['pt', 'en', 'es', 'fr', 'de'],
+				languages: ["pt", "en", "es", "fr", "de"],
 				recommendedForSimplePc: true,
 			},
-      status: 'notInstalled',
+			status: "notInstalled",
 		},
 	],
 };
 
 function createNativeClient(): NativeClient {
 	return {
-    invoke: <T>(command: string, args?: Record<string, unknown>) => tauriInvoke<T>(command, args),
+		invoke: <T>(command: string, args?: Record<string, unknown>) =>
+			tauriInvoke<T>(command, args),
 	};
 }
 
@@ -122,7 +125,7 @@ function formatBytes(bytes: number): string {
 
 async function safeSnapshot(client: NativeClient): Promise<AppSnapshot> {
 	try {
-    return await client.invoke<AppSnapshot>('get_app_snapshot');
+		return await client.invoke<AppSnapshot>("get_app_snapshot");
 	} catch {
 		return fallbackSnapshot;
 	}
@@ -132,46 +135,76 @@ export function createTranscriptionApp(
 	mount: HTMLElement,
 	client: NativeClient = createNativeClient(),
 ): void {
-  mount.textContent = '';
+	mount.textContent = "";
 
 	let snapshot = fallbackSnapshot;
 
-  const shell = element('section', 'modal-shell');
+	const shell = element("section", "modal-shell");
-  shell.setAttribute('aria-labelledby', 'app-title');
+	shell.setAttribute("aria-labelledby", "app-title");
 
-  const topbar = element('header', 'topbar');
+	const topbar = element("header", "topbar");
-  const titleGroup = element('div', 'title-group');
+	const titleGroup = element("div", "title-group");
-  const eyebrow = element('p', 'eyebrow', 'Transcript Desktop');
+	const eyebrow = element("p", "eyebrow", "Transcript Desktop");
-  const title = element('h1', undefined, 'Transcrição');
+	const title = element("h1", undefined, "Transcrição");
-  title.id = 'app-title';
+	title.id = "app-title";
-  const subtitle = element('p', 'subtitle');
+	const subtitle = element("p", "subtitle");
 	titleGroup.append(eyebrow, title, subtitle);
 
-  const status = element('span', 'status-pill');
+	const status = element("span", "status-pill");
 	topbar.append(titleGroup, status);
 
-  const editorLabel = element('label', 'editor-label', 'Texto transcrito');
+	const editorLabel = element("label", "editor-label", "Texto transcrito");
-  editorLabel.setAttribute('for', 'transcript-editor');
+	editorLabel.setAttribute("for", "transcript-editor");
 
-  const editor = element('textarea', 'transcript-editor') as HTMLTextAreaElement;
+	const editor = element(
-  editor.id = 'transcript-editor';
+		"textarea",
-  editor.placeholder = 'A transcrição aparecerá aqui para revisão antes da inserção.';
+		"transcript-editor",
+	) as HTMLTextAreaElement;
+	editor.id = "transcript-editor";
+	editor.placeholder =
+		"A transcrição aparecerá aqui para revisão antes da inserção.";
 	editor.rows = 10;
 
-  const message = element('p', 'message');
+	const message = element("p", "message");
-  message.setAttribute('role', 'status');
+	message.setAttribute("role", "status");
 
-  const actions = element('div', 'actions');
+	const actions = element("div", "actions");
-  const recordButton = element('button', 'primary-button', 'Iniciar gravação') as HTMLButtonElement;
+	const recordButton = element(
-  const continueButton = element('button', 'secondary-button', '+ Continuar') as HTMLButtonElement;
+		"button",
-  const copyButton = element('button', 'secondary-button', 'Copiar') as HTMLButtonElement;
+		"primary-button",
-  const insertButton = element('button', 'secondary-button', 'Inserir no app') as HTMLButtonElement;
+		"Iniciar gravação",
-  const saveButton = element('button', 'ghost-button', 'Salvar texto') as HTMLButtonElement;
+	) as HTMLButtonElement;
-  actions.append(recordButton, continueButton, copyButton, insertButton, saveButton);
+	const continueButton = element(
+		"button",
+		"secondary-button",
+		"+ Continuar",
+	) as HTMLButtonElement;
+	const copyButton = element(
+		"button",
+		"secondary-button",
+		"Copiar",
+	) as HTMLButtonElement;
+	const insertButton = element(
+		"button",
+		"secondary-button",
+		"Inserir no app",
+	) as HTMLButtonElement;
+	const saveButton = element(
+		"button",
+		"ghost-button",
+		"Salvar texto",
+	) as HTMLButtonElement;
+	actions.append(
+		recordButton,
+		continueButton,
+		copyButton,
+		insertButton,
+		saveButton,
+	);
 
-  const modelPanel = element('aside', 'model-panel');
+	const modelPanel = element("aside", "model-panel");
-  const modelTitle = element('h2', undefined, 'Modelo offline');
+	const modelTitle = element("h2", undefined, "Modelo offline");
-  const modelDetails = element('p');
+	const modelDetails = element("p");
 	modelPanel.append(modelTitle, modelDetails);
 
 	shell.append(topbar, editorLabel, editor, message, actions, modelPanel);
@@ -179,72 +212,88 @@ export function createTranscriptionApp(
 
 	const render = (next: AppSnapshot): void => {
 		snapshot = next;
-    const isRecording = snapshot.recordingStatus === 'recording';
+		const isRecording = snapshot.recordingStatus === "recording";
-    status.textContent = isRecording ? 'Gravando' : 'Pronto';
+		status.textContent = isRecording ? "Gravando" : "Pronto";
 		status.dataset.state = snapshot.recordingStatus;
-    subtitle.textContent = `${snapshot.settings.transcription.mode === 'localFirst' ? 'Offline primeiro' : 'API'} · idioma ${snapshot.settings.transcription.language ?? 'automático'}`;
+		subtitle.textContent = `${snapshot.settings.transcription.mode === "localFirst" ? "Offline primeiro" : "API"} · idioma ${snapshot.settings.transcription.language ?? "automático"}`;
 		editor.value = snapshot.transcript.text;
-    message.textContent = snapshot.transcript.lastMessage ?? 'Revise o texto antes de inserir.';
+		message.textContent =
-    recordButton.textContent = isRecording ? 'Parar e transcrever' : 'Iniciar gravação';
+			snapshot.transcript.lastMessage ?? "Revise o texto antes de inserir.";
+		recordButton.textContent = isRecording
+			? "Parar e transcrever"
+			: "Iniciar gravação";
 
 		const firstModel = snapshot.models[0]?.model;
 		modelDetails.textContent = firstModel
 			? `${firstModel.displayName} · ${firstModel.quantization} · ${formatBytes(firstModel.sizeBytes)} · ${firstModel.repository}`
-      : 'Nenhum modelo offline homologado encontrado.';
+			: "Nenhum modelo offline homologado encontrado.";
 	};
 
 	const refresh = async (): Promise<void> => {
 		render(await safeSnapshot(client));
 	};
 
-  recordButton.addEventListener('click', () => {
+	const showError = (error: unknown): void => {
-    void (async () => {
+		message.textContent = error instanceof Error ? error.message : String(error);
-      const command = snapshot.recordingStatus === 'recording'
+	};
-        ? 'stop_recording_and_transcribe'
+
-        : 'start_recording';
+	const toggleRecording = async (): Promise<void> => {
+		const command =
+			snapshot.recordingStatus === "recording"
+				? "stop_recording_and_transcribe"
+				: "start_recording";
 		render(await client.invoke<AppSnapshot>(command));
-    })().catch((error: unknown) => {
+	};
-      message.textContent = error instanceof Error ? error.message : String(error);
+
-    });
+	recordButton.addEventListener("click", () => {
+		void toggleRecording().catch(showError);
 	});
 
-  continueButton.addEventListener('click', () => {
+	continueButton.addEventListener("click", () => {
-    void client.invoke<AppSnapshot>('start_recording').then(render).catch((error: unknown) => {
+		void client
-      message.textContent = error instanceof Error ? error.message : String(error);
+			.invoke<AppSnapshot>("start_recording")
-    });
+			.then(render)
+			.catch(showError);
 	});
 
-  copyButton.addEventListener('click', () => {
+	copyButton.addEventListener("click", () => {
 		void navigator.clipboard
 			.writeText(editor.value)
 			.then(() => {
-        message.textContent = 'Texto copiado para a área de transferência.';
+				message.textContent = "Texto copiado para a área de transferência.";
 			})
 			.catch(() => {
-        message.textContent = 'Não foi possível copiar automaticamente. Selecione o texto manualmente.';
+				message.textContent =
+					"Não foi possível copiar automaticamente. Selecione o texto manualmente.";
 			});
 	});
 
-  insertButton.addEventListener('click', () => {
+	insertButton.addEventListener("click", () => {
 		void client
-      .invoke<{ message: string }>('request_insert_text', { text: editor.value })
+			.invoke<{ message: string }>("request_insert_text", {
+				text: editor.value,
+			})
 			.then((result) => {
 				message.textContent = result.message;
 			})
-      .catch((error: unknown) => {
+			.catch(showError);
-        message.textContent = error instanceof Error ? error.message : String(error);
-      });
 	});
 
-  saveButton.addEventListener('click', () => {
+	saveButton.addEventListener("click", () => {
-    const blob = new Blob([editor.value], { type: 'text/plain;charset=utf-8' });
+		const blob = new Blob([editor.value], { type: "text/plain;charset=utf-8" });
 		const url = URL.createObjectURL(blob);
-    const link = document.createElement('a');
+		const link = document.createElement("a");
 		link.href = url;
-    link.download = 'transcricao.txt';
+		link.download = "transcricao.txt";
 		link.click();
 		URL.revokeObjectURL(url);
-    message.textContent = 'Arquivo de texto preparado para download.';
+		message.textContent = "Arquivo de texto preparado para download.";
+	});
+
+	void listen("transcript://toggle-recording", () => {
+		void toggleRecording().catch(showError);
+	}).catch(() => {
+		// Browser preview and tests do not expose the Tauri event bridge.
 	});
 
 	void refresh();