# Prompt vocale — Liu Terminal

> Prompt vocale di Liu Terminal. Detta in qualsiasi pannello con Cmd+Shift+M — Whisper large-v3-turbo gira sul dispositivo in 100 lingue, oppure usa una API vocale in cloud.

URL: https://liu.software/it/docs/voice/  
Language: it  
Updated: 2026-10-17

Pronuncia un prompt e Liu lo scrive nel pannello che stai guardando. Whisper large-v3-turbo gira sulla tua macchina — niente rete, niente account — oppure puoi puntarlo a una API vocale in cloud.

## Come attivarlo

Premi Cmd+Shift+M per iniziare a registrare e di nuovo per fermarti. In basso a destra compare una scheda con la forma d'onda dal vivo di ciò che il microfono sta sentendo. La registrazione si ferma anche da sola dopo un paio di secondi di silenzio una volta che hai davvero parlato, e a un tetto massimo perché una scorciatoia dimenticata non registri all'infinito. Esc annulla.

**Dove finisce il testo:** il pannello CON IL FOCUS, non "l'agente". Stai guardando un pannello e ti aspetti le parole dove sta il cursore — il che fa funzionare tutto anche in una shell normale, in un REPL e in qualunque CLI arrivi in futuro. Gli a capo nella trascrizione diventano spazi, perché per una CLI di agente un ritorno a capo non è spazio bianco: invia il prompt. Decidi tu quando inviare, a meno che non attivi l'invio automatico.

## Backend

- **Locale (predefinito)** — Whisper large-v3-turbo, scaricato una volta da Impostazioni › Voice (547 MB) e tenuto accanto agli altri modelli sotto Application Support. Metal su Apple silicon, un percorso C portabile altrove, e un backend Vulkan sperimentale che arriva disattivato. L'audio non lascia mai la macchina.
- **API** — La registrazione viene invece inviata a un endpoint di trascrizione in cloud: OpenAI, Groq, ElevenLabs o qualsiasi server compatibile con OpenAI tramite un base URL personalizzato. La chiave sta in config.json o nella solita variabile d'ambiente del provider, e non compare mai nella riga di comando del processo. Utile su hardware senza percorso GPU, o se preferisci non tenere un modello da 547 MB.

## Microfono e lingua

Impostazioni › Voice elenca ogni dispositivo di ingresso e blocca quello scelto tramite il suo identificatore persistente, non per nome o posizione: due microfoni USB identici riportano lo stesso nome e gli indici si spostano quando i dispositivi vanno e vengono. Conta più di quanto sembri: il predefinito di sistema cambia da solo quando arrivano delle cuffie o si aggancia un monitor con webcam, e un ingresso sbagliato ma funzionante disegna comunque una forma d'onda, solo della stanza sbagliata.

Il selettore di lingua offre Auto più tutte le 100 lingue su cui il modello è stato addestrato. Auto costa un passo di decodifica in più nella prima finestra e azzecca molto più spesso di una scelta fissa sbagliata, perciò viene per prima.

## Dettare in una lingua, inviare in inglese

Attiva "To English" e la trascrizione arriva in inglese qualunque cosa tu abbia detto. C'è una sottigliezza da conoscere: large-v3-turbo è una distillazione addestrata solo sulla trascrizione e non può affatto svolgere il compito di traduzione di Whisper — se glielo chiedi restituisce dei puntini di sospensione anziché un errore. Liu lo rileva dal modello stesso e instrada la trascrizione attraverso il proprio motore Translate, così la funzione lavora anche col modello incluso. Sul backend API, o su un large-v3 completo, la traduzione avviene alla fonte in un solo passaggio.

## Configurazione

Tutto si trova nella scheda Voice delle Impostazioni e viene salvato in config.json:

- `voice_enabled`, `voice_backend` (0 = local, 1 = API)
- `voice_model_path`, `voice_lang`, `voice_translate`
- `voice_input_device`, `voice_auto_submit`
- `voice_max_seconds`, `voice_silence_stop_sec`
- `voice_api_provider`, `voice_api_model`, `voice_api_key`, `voice_api_base_url`

I valori predefiniti sono backend locale, rilevamento automatico della lingua, registrazione massima di 120 secondi, arresto dopo 2 secondi di silenzio dopo il parlato, traduzione disattivata e invio automatico disattivato. Il backend API carica la registrazione al provider scelto; quello locale mantiene l'audio sulla macchina.