Torna alla Home
Setup Guide

Primi passi con VoxyFlow

Scopri come installare, configurare e padroneggiare VoxyFlow per la migliore esperienza di apprendimento linguistico e lettura.

1

Installazione

Installa l'estensione VoxyFlow dal Chrome Web Store con un solo clic. Lo strumento è subito pronto per la configurazione.

Lascia la tua email — ti invieremo il link di installazione e una guida di 2 minuti.

2

Scegli il motore di traduzione

VoxyFlow utilizza il modello BYOK (Bring-Your-Own-Key) per rimanere gratuito, privato e personalizzabile. Scegli il fornitore ideale:

DeepL API (Consigliato)

Recommended

Traduzione neurale fulminea. Il conto gratuito offre 500.000 caratteri al mese gratis. Ideale per la lettura quotidiana.

Get DeepL API Key
OpenRouter (IA avanzate)
Advanced

Connettiti a modelli linguistici all'avanguardia come Google Gemini 2.5 Flash, Claude 3.5 o DeepSeek per traduzioni intelligenti nel contesto.

Get OpenRouter API Key
Ollama (IA locale offline)
Offline

Esegui modelli di traduzione open-source localmente sul tuo PC. Privato al 100%, gratuito e funziona senza connessione (richiede translategemma:2b).

Per impostazione predefinita, Ollama blocca le estensioni (CORS). Devi OBBLIGATORIAMENTE abilitarlo eseguendo questi comandi per il tuo SO:

macOS

macOS: Nel Terminale, esegui `launchctl setenv OLLAMA_ORIGINS "*"` e riavvia Ollama.

launchctl setenv OLLAMA_ORIGINS "*"
Windows

Windows: Aggiungi la Variabile d'Ambiente Utente `OLLAMA_ORIGINS` con valore `*` e riavvia Ollama.

Variable: OLLAMA_ORIGINS
Value: *
Linux (systemd)

Linux: Esegui `sudo systemctl edit ollama.service`, inserisci `Environment="OLLAMA_ORIGINS=*"` sotto `[Service]` e riavvia il servizio.

[Service] Environment="OLLAMA_ORIGINS=*"
3

Configurazione e Avvio

Clicca sull'icona di VoxyFlow, apri le impostazioni, incolla la tua chiave API, seleziona il motore di traduzione e clicca su 'Salva'.

Per aprire facilmente le impostazioni, clicca sull'icona del puzzle 🧩 in Chrome, trova VoxyFlow e clicca sulla puntina 📌 per renderlo visibile.

4

Tre modalità di traduzione

Goditi una lettura fluida grazie a diverse modalità di traduzione immediata sulle pagine web:

  • Modalità Hover (Scorrimento): Tieni premuto Alt + Shift + V (Option + Shift + V su Mac) e passa il mouse su qualsiasi parola per vederne la traduzione.

  • Modalità Selezione: Evidenzia una frase e premi Alt + Shift + V per mostrare la finestra di traduzione accanto alla selezione.

  • Menu contestuale (PDF): Clicca con il tasto destro sul testo selezionato e scegli 'Translate with VoxyFlow'. Nei PDF, i risultati si aprono nel pannello laterale.

5

Controllo totale da tastiera

Tieni le mani sulla tastiera e traduci alla velocità del pensiero. VoxyFlow è progettato per interazioni a latenza zero:

Scorciatoie globali (Personalizzabili)

Alt + Shift + V (⌥⇧V) — Attiva la traduzione al passaggio del mouse / Traduci la selezioneAlt + Shift + V
Alt + Shift + D (⌥⇧D) — Apri il pannello laterale (Dashboard / Vocabolario / Flow)Alt + Shift + D
Alt + Shift + S (⌥⇧S) — Apri il menu rapido delle impostazioniAlt + Shift + S

Controlli nella finestra (Comandi a tasto singolo con finestra attiva)

FF — Salva nel dizionario (o rimuovi)
CC — Copia la traduzione negli appunti
GG — Modifica la scheda / Aggiungi note personali
SpaceSpazio / P — Riproduci / metti in pausa la pronuncia audio
EscEsc — Chiudi la finestra di traduzione
6

Dashboard, Flow & Esportazione vocabolario

VoxyFlow trasforma la tua lettura in un corso di lingua strutturato. Gestisci ed esporta la tua banca di parole:

Translator

Traduttore manuale: Blocco note sulla prima scheda. 'Send to Flow' salva le ricerche manuali automaticamente.

Flow Stream

Flusso Flow: Un registro live di tutte le tue traduzioni con timestamp e frasi di contesto.

Word Bank

Dizionario intelligente: Separa automaticamente parole e frasi in schede dedicate. Consente l'inserimento di note personalizzate.

Anki

Anki CSV: Scarica il tuo vocabolario completo di frasi di contesto, pronto per l'importazione diretta in Anki.

Quizlet

Quizlet: Esporta come testo separato da tabulazioni e incollalo direttamente nell'importatore di Quizlet.

7

Tecnologia sotto il cofano

VoxyFlow adotta soluzioni ingegneristiche avanzate per la massima velocità e il risparmio delle quote API:

Cache intelligente a 3 livelli

LRU in memoria e database persistente IndexedDB (14 giorni) caricano le parole note all'istante, salvando la quota DeepL.

Interruttore di sicurezza API (Circuit Breaker)

Sospende automaticamente le richieste in caso di errori continui per proteggere la chiave API.

Detezione lingua su parole corte

Utilizza la lingua HTML della pagina ('html lang') per parole di 1-2 caratteri per evitare errori nelle lingue romanze.

Ottimizzazione per LLM

Disattiva la modalità hover per le IA per tutelare i token. Limiti a 3000 caratteri e timeout a 120s.