Retour à l'Accueil
Setup Guide

Premiers pas avec VoxyFlow

Apprenez à installer, configurer et maîtriser VoxyFlow pour une expérience d'apprentissage et de lecture linguistique optimale.

1

Installation

Installez l'extension VoxyFlow depuis le Chrome Web Store en un clic. L'outil est immédiatement prêt à être configuré.

Laissez votre email — nous vous envoyons le lien d'installation et un guide de 2 minutes.

2

Choisir le moteur de traduction

VoxyFlow utilise le modèle BYOK (Bring-Your-Own-Key) pour rester gratuit, privé et personnalisable. Choisissez le fournisseur idéal :

DeepL API (Recommandé)

Recommended

Traduction neuronale ultra-rapide. Un compte gratuit permet de traduire 500 000 caractères par mois gratuitement. Idéal pour la lecture courante.

Get DeepL API Key
OpenRouter (IAs avancées)
Advanced

Connectez-vous à des modèles d'IA de pointe comme Google Gemini 2.5 Flash, Claude 3.5 ou DeepSeek pour des traductions intelligentes contextualisées.

Get OpenRouter API Key
Ollama (IA locale hors ligne)
Offline

Exécutez des modèles de traduction open-source localement sur votre PC. 100% privé, gratuit et fonctionne sans connexion (requiert translategemma:2b).

Par défaut, Ollama bloque les extensions (CORS). Vous DEVEZ l'activer en lançant ces commandes pour votre OS :

macOS

macOS : Dans le Terminal, lancez `launchctl setenv OLLAMA_ORIGINS "*"` et redémarrez Ollama.

launchctl setenv OLLAMA_ORIGINS "*"
Windows

Windows : Ajoutez la Variable d'Environnement Utilisateur `OLLAMA_ORIGINS` avec la valeur `*` et redémarrez Ollama.

Variable: OLLAMA_ORIGINS
Value: *
Linux (systemd)

Linux : Lancez `sudo systemctl edit ollama.service`, insérez `Environment="OLLAMA_ORIGINS=*"` sous `[Service]` et redémarrez le service.

[Service] Environment="OLLAMA_ORIGINS=*"
3

Configuration & Lancement

Cliquez sur l'icône de VoxyFlow, ouvrez les paramètres, collez votre clé API, sélectionnez votre moteur de traduction et cliquez sur 'Enregistrer'.

Pour accéder facilement aux réglages, cliquez sur le puzzle 🧩 dans Chrome, cherchez VoxyFlow et cliquez sur l'épingle 📌 pour le garder visible.

4

Trois modes de traduction

Profitez d'une lecture fluide grâce aux différents modes de traduction à la volée sur les pages web :

  • Mode Hover (Survol) : Maintenez Alt + Shift + V (Option + Shift + V sur Mac) et survolez n'importe quel mot pour voir sa traduction instantanément.

  • Mode Sélection : Surlignez une phrase et appuyez sur Alt + Shift + V pour afficher la fenêtre de traduction à côté de la sélection.

  • Menu contextuel (PDF) : Faites un clic droit sur le texte sélectionné et choisissez 'Translate with VoxyFlow'. Dans les PDF, les résultats s'ouvrent dans le panneau latéral.

5

Contrôle total au clavier

Gardez les mains sur le clavier et traduisez à la vitesse de la pensée. VoxyFlow est conçu pour des interactions sans latence :

Raccourcis globaux (Personnalisables)

Alt + Shift + V (⌥⇧V) — Activer la traduction au survol / Traduire la sélectionAlt + Shift + V
Alt + Shift + D (⌥⇧D) — Ouvrir le panneau latéral (Dashboard / Vocabulaire / Flow)Alt + Shift + D
Alt + Shift + S (⌥⇧S) — Ouvrir le menu rapide des réglagesAlt + Shift + S

Contrôles dans la fenêtre (Commandes à touche unique avec fenêtre active)

FF — Enregistrer dans le dictionnaire (ou supprimer)
CC — Copier la traduction dans le presse-papiers
GG — Modifier la fiche / Ajouter des notes personnalisées
SpaceEspace / P — Lire / mettre en pause la prononciation audio
EscEsc — Fermer la fenêtre de traduction
6

Dashboard, Flow & Export de vocabulaire

VoxyFlow transforme votre lecture en cours de langue structuré. Gérez et exportez votre banque de mots :

Translator

Traducteur manuel : Zone de texte sur le premier onglet. 'Send to Flow' enregistre automatiquement vos recherches manuelles.

Flow Stream

Flux Flow : Un journal en direct de toutes vos traductions avec horodatage et contexte.

Word Bank

Dictionnaire intelligent : Sépare automatiquement les mots et les phrases dans des onglets dédiés. Permet d'éditer ses propres notes.

Anki

Anki CSV : Téléchargez votre vocabulaire avec les phrases de contexte, prêt à être importé directement dans vos paquets Anki.

Quizlet

Quizlet : Exportez en texte séparé par des tabulations et collez-le directement dans l'outil d'importation de Quizlet.

7

Technologie sous le capot

VoxyFlow utilise des solutions d'ingénierie avancées pour une vitesse maximale et la préservation de vos quotas d'API :

Cache intelligent à 3 niveaux

Le LRU en mémoire et la base persistante IndexedDB (14 jours) chargent les mots connus à la volée, économisant votre quota DeepL.

Coupe-circuit d'API (Circuit Breaker)

Suspend automatiquement les requêtes en cas d'erreurs répétées afin de protéger votre clé API.

Détection de langue sur mots courts

Utilise la langue HTML de la page ('html lang') pour les mots de 1 à 2 caractères afin d'éviter les erreurs en langues romanes.

Optimisation pour les LLMs

Désactive le mode survol pour les IAs afin d'économiser les jetons. Limites de 3000 caractères et délais de 120s.