VoxyFlow
Home
Guida VoxyFlow

Come configurare traduzione, sintesi vocale e chat IA

Installa l’estensione, collega il servizio che ti serve e prova la prima traduzione. Poi scegli le voci, il modello di chat e le scorciatoie che preferisci. Qui trovi i passaggi dettagliati e le schermate delle impostazioni di VoxyFlow.

Installazione e primo avvio

VoxyFlow è disponibile per Chrome, Microsoft Edge e Firefox. Installa l’estensione dallo store del tuo browser.

  1. Premi il pulsante di installazione nello store e conferma l’aggiunta dell’estensione.
  2. Apri il menu delle estensioni del browser e fissa VoxyFlow nella barra degli strumenti.
  3. Fai clic sull’icona di VoxyFlow e apri le impostazioni complete. Qui puoi impostare chiavi API, servizio di traduzione, chat, sintesi vocale e scorciatoie da tastiera.
  4. Collega DeepL, OpenRouter o Ollama. Ricarica la pagina aperta e traduci una breve frase.

Per iniziare basta un servizio di traduzione. Puoi collegare chat e sintesi vocale in seguito; i rispettivi fornitori e modelli si scelgono separatamente.

Traduzione del testo selezionato e delle parole al passaggio del mouse

Traduci un passaggio mentre leggi, cambia la direzione di traduzione e salva le espressioni nel dizionario.

Come tradurre il testo selezionato

Collega un servizio di traduzione e verifica il risultato con una breve frase.

  1. Apri le impostazioni complete di VoxyFlow, collega DeepL, OpenRouter o Ollama e salva le impostazioni.
  2. Ricarica la pagina, seleziona una frase e premi Alt + Shift + V; su Mac, Option + Shift + V.
  3. Scegli la lingua di traduzione nella finestra che si apre. In un campo modificabile usa il tasto destro → «Translate with VoxyFlow».
Finestra di VoxyFlow con frase originale, traduzione, selezione delle lingue e pulsanti di sintesi vocale.
Esempio della finestra di traduzione: scelta delle lingue, ascolto del testo e salvataggio di un’espressione. Fai clic sulla schermata per ingrandirla.

Traduzione al passaggio del mouse

Senza selezionare il testo, tieni premuta la combinazione di traduzione e passa il mouse su una parola che non conosci. Per questa modalità scegli DeepL API. In «Comportamento al passaggio del mouse» puoi impostare il ritardo prima della comparsa della traduzione.

E-mail, moduli e campi di immissione

Seleziona il testo in un campo modificabile, fai clic con il tasto destro e scegli «Translate with VoxyFlow». Il risultato si apre nella finestra di traduzione o nella barra laterale del browser.

Per precisare la direzione, scegli la lingua originale e quella di destinazione nella finestra di VoxyFlow. Puoi fissare la finestra con il pulsante a forma di puntina e spostarla trascinando la barra superiore.

Collegare DeepL API

Usa DeepL per tradurre selezioni e parole al passaggio del mouse. Ti servono un account con accesso a DeepL API e una chiave di autenticazione.

Come collegare DeepL

Per la connessione serve una tua chiave API DeepL.

  1. Apri il tuo account DeepL API e copia la chiave di autenticazione.
  2. Nelle impostazioni di VoxyFlow incolla la chiave nel campo DeepL API della sezione «Credenziali API e servizi».
  3. In «Servizio di traduzione» scegli DeepL API, fai clic su «Salva» e poi su «Verifica DeepL».
Sezione «Credenziali API e servizi» di VoxyFlow: campo della chiave API DeepL e pulsante per verificare la connessione.
Limiti e costi delle richieste dipendono dal tuo piano API DeepL. Fai clic sulla schermata per ingrandirla.

Nel tuo account DeepL apri la sezione delle chiavi API e copia la chiave per intero. L’accesso all’API si attiva separatamente dal traduttore sul sito e dalle app DeepL.

Chiavi API nell’account DeepL · Piani API DeepL

Dopo aver salvato, fai clic su «Verifica DeepL». Poi seleziona una breve frase sulla pagina e avvia la traduzione. La chiave DeepL serve per la traduzione; sintesi vocale e chat IA si collegano separatamente.

Traduzione IA tramite OpenRouter

Collega modelli di IA nel cloud e scegli quello adatto ai tuoi testi. Per tradurre viene usato il modello indicato in «Servizio di traduzione».

Come collegare la traduzione IA tramite OpenRouter

Una sola chiave API collega l’account OpenRouter; i modelli di traduzione, chat e sintesi vocale si scelgono separatamente.

  1. Crea una chiave API nel tuo account OpenRouter e incollala in «Credenziali API e servizi».
  2. In «Servizio di traduzione» scegli OpenRouter AI e un modello di traduzione. Puoi aggiungere il modello che desideri tramite il suo identificativo nel catalogo OpenRouter.
  3. Fai clic su «Salva», verifica OpenRouter e traduci una breve frase sulla pagina.
Impostazioni di VoxyFlow: servizio OpenRouter AI, scelta del modello di traduzione e aggiunta di un modello tramite identificativo.
Il costo della traduzione dipende dal modello OpenRouter scelto. Fai clic sulla schermata per ingrandirla.
  1. Accedi al tuo account OpenRouter e crea una chiave API. Se necessario, configura i pagamenti oppure scegli un modello gratuito.
  2. Trova un modello nel catalogo OpenRouter e copia il suo identificativo.
  3. Se il modello non è nell’elenco di VoxyFlow, incolla l’identificativo nel campo per aggiungere modelli, fai clic su «Aggiungi», poi sceglilo come modello di traduzione attivo e salva le impostazioni.

Per la chat IA indica un modello nelle impostazioni della chat; per la sintesi vocale naturale scegli un modello vocale nelle impostazioni vocali. Queste impostazioni sono indipendenti.

Traduzione locale e connessione a Ollama

Esegui un modello sul tuo computer. Dopo aver installato Ollama e scaricato un modello locale, la traduzione può funzionare senza Internet.

Come collegare un modello locale Ollama

Installa Ollama, scarica un modello e imposta la connessione in VoxyFlow.

  1. Installa Ollama e scarica un modello di traduzione, ad esempio translategemma:4b.
  2. Autorizza la connessione della tua estensione in OLLAMA_ORIGINS e riavvia Ollama. I comandi per il tuo sistema operativo sono nella guida.
  3. In VoxyFlow indica http://localhost:11434, scegli Ollama per la traduzione, inserisci il nome del modello e fai clic su «Salva», poi su «Verifica Ollama».
Impostazioni di VoxyFlow: scelta di Ollama e nome del modello di traduzione installato.
Con un modello locale, le richieste vengono elaborate sul tuo computer, senza costi per richieste a un’API cloud. Fai clic sulla schermata per ingrandirla.

1. Installa Ollama e scarica un modello

Scarica Ollama per il tuo sistema operativo, avvia l’app e scarica un modello. Ad esempio, per la traduzione puoi usare TranslateGemma 4B:

ollama pull translategemma:4b
ollama list

Il comando ollama list mostra i modelli installati. In VoxyFlow devi indicare il nome presente in questo elenco, incluso il tag.

2. Autorizza la connessione dell’estensione

Imposta OLLAMA_ORIGINS con l’origine della tua installazione di VoxyFlow. In Chrome ed Edge apri la pagina delle estensioni, attiva la modalità sviluppatore e copia l’ID di VoxyFlow. Il valore avrà la forma chrome-extension://YOUR_EXTENSION_ID. Sostituisci YOUR_EXTENSION_ID con il tuo ID.

In Firefox apri about:debugging#/runtime/this-firefox e trova l’UUID interno di VoxyFlow. Usa moz-extension://YOUR_EXTENSION_UUID per questa installazione.

macOS — app Ollama

Nel Terminale imposta l’origine della tua installazione, poi chiudi completamente l’app Ollama e riaprila.

launchctl setenv OLLAMA_ORIGINS "chrome-extension://YOUR_EXTENSION_ID"
Windows — app Ollama

Chiudi Ollama dall’icona nell’area di notifica. Apri «Modifica le variabili di ambiente relative all’account» e crea la variabile OLLAMA_ORIGINS con l’origine di VoxyFlow come valore. Salva le modifiche e riavvia Ollama.

Linux — servizio systemd

Apri la configurazione del servizio con il comando sudo systemctl edit ollama.service e aggiungi l’origine della tua installazione:

[Service]
Environment="OLLAMA_ORIGINS=chrome-extension://YOUR_EXTENSION_ID"

Salva il file, ricarica la configurazione e riavvia il servizio:

sudo systemctl daemon-reload
sudo systemctl restart ollama

Configurazione delle variabili di ambiente e delle origini consentite: guida ufficiale di Ollama. Per una connessione locale, mantieni l’indirizzo predefinito del server; non serve consentire l’accesso da Internet.

3. Collega il server in VoxyFlow

In «Credenziali API e servizi» indica http://localhost:11434. In «Servizio di traduzione» scegli Ollama e imposta translategemma:4b o un altro modello installato. Fai clic su «Salva», poi su «Verifica Ollama». Per conversare con il modello, configura separatamente la chat Ollama.

Sintesi vocale naturale per originale e traduzione

Ascolta la pronuncia della frase originale e della sua traduzione. VoxyFlow offre la sintesi vocale IA tramite OpenRouter e la riproduzione con le voci del browser o del sistema operativo.

Come attivare la sintesi vocale naturale

Usa un modello vocale OpenRouter oppure le voci del browser e del sistema operativo.

  1. Per la sintesi vocale IA, aggiungi la chiave OpenRouter in «Credenziali API e servizi» e fai clic su «Salva».
  2. In «Impostazioni vocali» scegli OpenRouter AI, un modello vocale e una voce. Per le voci di sistema, scegli «Locale (Web Speech API)».
  3. Regola la velocità di riproduzione e premi il pulsante di sintesi vocale accanto all’originale o alla traduzione.
Impostazioni vocali di VoxyFlow: fornitore, modello vocale, voce e velocità di riproduzione.
Traduzione, chat e sintesi vocale hanno impostazioni separate. La sintesi vocale IA viene addebitata secondo la tariffa del modello vocale. Fai clic sulla schermata per ingrandirla.

Voce IA tramite OpenRouter

In «Impostazioni vocali» scegli OpenRouter AI, poi un modello e una voce dall’elenco. La chiave dell’account OpenRouter proviene da «Credenziali API e servizi». Le modifiche a modello, voce e velocità vengono salvate automaticamente.

Voci del browser e del sistema operativo

Scegli «Locale (Web Speech API)» e la voce desiderata oppure mantieni la selezione automatica in base alla lingua. Se necessario, aggiorna l’elenco delle voci e imposta preferenze distinte per le lingue.

I pulsanti accanto al testo originale e al risultato avviano il rispettivo audio. Regola la velocità da 0,5 a 2: il ritmo normale corrisponde a 1,0. La traduzione ha una regolazione della velocità separata.

La sintesi vocale IA usa il modello vocale OpenRouter e viene addebitata secondo la tariffa del modello. Per le voci del browser e del sistema operativo non serve una chiave OpenRouter.

Chat IA con OpenRouter o Ollama

Approfondisci espressioni sconosciute, chiarisci dubbi grammaticali e discuti le possibili traduzioni nella barra laterale accanto alla pagina.

Come iniziare una conversazione con l’IA

Scegli un modello separato per la chat e aggiungi alla conversazione il testo che vuoi approfondire.

  1. In «Impostazioni chat IA» scegli OpenRouter o Ollama, indica il modello di chat e fai clic su «Salva». La chiave o l’indirizzo del server si imposta in «Credenziali API e servizi».
  2. Apri la barra laterale di VoxyFlow con Alt + Shift + D, su Mac Option + Shift + D, e passa alla chat.
  3. Incolla il testo oppure fai clic su «Inserisci selezione», aggiungi una domanda e premi «Invia».
Barra laterale di VoxyFlow con chat IA, conversazioni, campo del messaggio e pulsante per inserire la selezione.
Esempio di conversazione. La selezione viene prima aggiunta alla bozza: puoi completare la domanda prima di inviarla. Fai clic sulla schermata per ingrandirla.

Chat nel cloud

Salva la chiave OpenRouter in «Credenziali API e servizi». In «Impostazioni chat IA» scegli OpenRouter e indica l’identificativo del modello di chat dal catalogo. Fai clic su «Salva» in questa sezione.

Chat Ollama

Collega il server Ollama, scegli Ollama in «Impostazioni chat IA» e indica un modello di conversazione installato. Il pulsante «Aggiorna modelli» carica l’elenco dal server. Salva le impostazioni della chat.

Crea una nuova conversazione. Seleziona una frase sulla pagina e fai clic su «Inserisci selezione» oppure incollala manualmente. Ad esempio, aggiungi la domanda: «Spiega perché qui si usa questa costruzione grammaticale e fornisci due esempi».

Controlla la bozza e fai clic su «Invia». Puoi interrompere la risposta, tornare a una conversazione salvata o crearne una nuova per un altro argomento.

Cronologia Flow e dizionario personale

Ritrova le traduzioni precedenti e salva le espressioni che vuoi ricordare. Cronologia e dizionario si aprono nella barra laterale di VoxyFlow.

Come salvare traduzioni ed espressioni

La cronologia raccoglie le traduzioni, mentre il dizionario conserva le parole e le frasi che scegli.

  1. Nelle impostazioni attiva «Registra Flow traduzioni» per salvare nella cronologia le traduzioni riuscite.
  2. Fai clic sulla stella nella finestra di traduzione per aggiungere una parola o una frase al dizionario.
  3. Apri la barra laterale e trova la voce in Flow, «Parole» o «Frasi». Per salvare un’intera frase, selezionala per intero.
Pannello VoxyFlow con cronologia Flow, traduzioni salvate e schede del dizionario.
Esempio della cronologia Flow: una voce contiene il testo selezionato e la sua traduzione. Il dizionario è disponibile nello stesso pannello. Fai clic sulla schermata per ingrandirla.

La cronologia Flow aggiunge automaticamente le traduzioni riuscite quando la registrazione è attiva. Il dizionario lo arricchisci tu, con il pulsante a stella o il tasto F nella finestra di traduzione. Trovi le espressioni salvate nelle schede «Parole» e «Frasi».

Per salvare un’intera frase insieme alla traduzione, selezionala per intero. Per una tua traduzione, premi G nella finestra di VoxyFlow e inserisci il testo desiderato.

Esportare il dizionario e creare un backup delle raccolte

Nel pannello apri «Esporta». Per Anki scarica il file CSV e, durante l’importazione, indica il separatore «;» e due campi: testo originale e traduzione. Per Quizlet copia il testo e incollalo nello strumento di importazione delle schede.

L’esportazione JSON salva le raccolte della cronologia e del dizionario. Per riportarle in VoxyFlow, fai clic su «Importa» e scegli il file JSON. Salva separatamente chiavi dei servizi, impostazioni e conversazioni della chat.

Scorciatoie da tastiera di VoxyFlow

Avvia la traduzione e apri la barra laterale dalla tastiera. Su Mac si usa Option al posto di Alt.

Scorciatoie da tastiera predefinite di VoxyFlow
AzioneWindows e LinuxmacOS
Traduci la selezioneAlt + Shift + VOption + Shift + V
Apri la barra lateraleAlt + Shift + DOption + Shift + D
Apri le impostazioni sulla paginaAlt + Shift + SOption + Shift + S

Le combinazioni per traduzione e impostazioni si modificano nella sezione «Scorciatoie da tastiera» di VoxyFlow. Fai clic su «Imposta scorciatoia» e inserisci la combinazione desiderata.

Imposta il comando per aprire la barra laterale nelle impostazioni delle estensioni del browser: chrome://extensions/shortcuts per Chrome, edge://extensions/shortcuts per Edge. In Firefox apri about:addons, fai clic sull’ingranaggio e scegli la gestione delle scorciatoie delle estensioni.

Nella finestra di traduzione attiva: F per salvare nel dizionario, G per impostare una tua traduzione, C per copiare il risultato, Space o P per controllare la lettura della traduzione, Esc per chiudere la finestra. Nei campi di immissione usa la traduzione dal menu contestuale.

Cosa è gratuito, cosa è a pagamento e dove sono conservati i dati

VoxyFlow è gratuito per uso personale non commerciale. Per i servizi cloud vengono usati i tuoi account e le tue chiavi API.

  • DeepL API: le richieste vengono conteggiate secondo il tuo piano API DeepL.
  • OpenRouter: traduzione e chat vengono addebitate secondo la tariffa del modello scelto; nel catalogo sono disponibili anche modelli gratuiti. Per la sintesi vocale IA si applica la tariffa del modello vocale. Modelli e fatturazione OpenRouter.
  • Ollama locale: il modello viene eseguito sul tuo computer, senza costi per richieste a un’API cloud.
  • Voci del browser e del sistema operativo: non serve collegare un modello di IA a pagamento.

Cronologia, dizionario e chat salvate si trovano nel profilo dell’estensione nel browser. Con i servizi cloud, il testo da tradurre, leggere ad alta voce o usare per la risposta viene inviato al fornitore scelto. Con una connessione locale a Ollama, viene elaborato dal tuo computer.

Scopri di più su dati e privacy

Se qualcosa non funziona

Inizia con un testo breve e verifica la connessione al servizio desiderato. Traduzione, chat e sintesi vocale hanno impostazioni proprie.

La traduzione non appare o i tasti non funzionano

Ricarica la scheda dopo l’installazione, controlla che VoxyFlow abbia accesso al sito e seleziona di nuovo il testo. Se la combinazione è già in uso, modificala nelle impostazioni. In un campo modificabile fai clic con il tasto destro e scegli «Translate with VoxyFlow».

Nelle pagine interne del browser o dello store delle estensioni, apri la barra laterale e incolla il testo nel traduttore manuale.

DeepL o OpenRouter restituisce un errore

Controlla la chiave API e fai clic su «Salva», poi sul pulsante di verifica del servizio. Per OpenRouter confronta l’identificativo del modello scelto con il catalogo e controlla il saldo disponibile e i limiti nell’account del fornitore.

Ollama non è disponibile o restituisce 403 Forbidden

Verifica che Ollama sia in esecuzione, che l’indirizzo del server sia corretto e che il modello desiderato compaia nell’output di ollama list. Un errore 403 richiede di solito di controllare OLLAMA_ORIGINS: indica l’origine dell’installazione attuale di VoxyFlow e riavvia Ollama. Se cambia l’ID dell’estensione, aggiorna questo valore. Vai alla configurazione di Ollama.

La sintesi vocale non viene riprodotta

Controlla il volume e il fornitore vocale scelto. Per la sintesi vocale di sistema, aggiorna l’elenco delle voci e scegli una voce per la lingua del testo. Per OpenRouter verifica chiave, modello vocale e voce in «Impostazioni vocali».

La traduzione funziona, ma la chat non risponde

Apri «Impostazioni chat IA»: scegli l’integrazione e imposta il modello di chat. Salva questa sezione separatamente. Per Ollama usa un modello di conversazione installato; per OpenRouter, un identificativo disponibile nel catalogo.

Ottenere una nuova traduzione invece del risultato salvato

Apri «Controllo cache» nelle impostazioni di VoxyFlow e svuota la cache. Cronologia Flow, dizionario e chat verranno conservati.

Contatta l’assistenza