Voltar ao Início
Setup Guide

Primeiros Passos com o VoxyFlow

Aprenda a instalar, configurar e dominar o VoxyFlow para a melhor experiência de aprendizagem de idiomas e leitura fluida.

1

Instalação

Instale a extensão VoxyFlow a partir da Chrome Web Store com um único clique. A ferramenta está imediatamente pronta a configurar.

Deixa o teu e-mail — enviaremos o link de instalação e um guia de 2 minutos.

2

Escolher o motor de tradução

O VoxyFlow funciona no modelo BYOK (Traga A Sua Própria Chave) para se manter gratuito, privado e personalizável. Escolha a sua opção ideal:

DeepL API (Recomendado)

Recommended

Tradução neuronal ultrarrápida. A conta gratuita oferece 500.000 caracteres por mês gratuitamente. A melhor escolha para leitura habitual.

Get DeepL API Key
OpenRouter (IAs avançadas)
Advanced

Ligue-se a modelos de IA topo de gama como Google Gemini 2.5 Flash, Claude 3.5 ou DeepSeek para traduções inteligentes e com contexto.

Get OpenRouter API Key
Ollama (IA local offline)
Offline

Execute modelos de tradução de código aberto localmente no seu computador. 100% privado, gratuito e funciona sem ligação à Internet (requer translategemma:2b).

Por padrão, o Ollama bloqueia extensões do navegador (CORS). Você DEVE obrigatoriamente ativá-lo executando estes comandos para seu SO:

macOS

macOS: No Terminal, execute `launchctl setenv OLLAMA_ORIGINS "*"` e reinicie o Ollama.

launchctl setenv OLLAMA_ORIGINS "*"
Windows

Windows: Adicione a Variable de Ambiente de Usuário `OLLAMA_ORIGINS` com valor `*` e reinicie o Ollama.

Variable: OLLAMA_ORIGINS
Value: *
Linux (systemd)

Linux: Execute `sudo systemctl edit ollama.service`, insira `Environment="OLLAMA_ORIGINS=*"` abaixo de `[Service]` e reinicie o serviço.

[Service] Environment="OLLAMA_ORIGINS=*"
3

Configuração e Inicialização

Clique no ícone do VoxyFlow na barra de ferramentas, abra as definições, cole a sua chave API, escolha o motor de tradução e clique em 'Salvar'.

Para abrir as definições facilmente, clique no ícone do quebra-cabeça 🧩 no Chrome, encontre o VoxyFlow e clique no pionés 📌 para o manter visível.

4

Três modos de tradução

Desfrute de uma leitura fluida graças aos diversos modos de tradução instantânea em páginas web:

  • Modo Hover (Flutuante): Mantenha pressionado Alt + Shift + V (Option + Shift + V no Mac) e passe o rato sobre qualquer palavra para ver a tradução.

  • Modo Seleção: Destaque qualquer frase e pressione Alt + Shift + V para exibir a janela de tradução junto da seleção.

  • Menu Contextual (PDF): Clique com o botão direito no texto selecionado e escolha 'Translate with VoxyFlow'. Nos PDFs, os resultados abrem no painel lateral.

5

Controle total pelo teclado

Mantenha as mãos no teclado e traduza à velocidade do pensamento. O VoxyFlow foi desenhado para interações sem latência:

Atalhos globais (Personalizáveis)

Alt + Shift + V (⌥⇧V) — Ativar tradução flutuante / Traduzir seleçãoAlt + Shift + V
Alt + Shift + D (⌥⇧D) — Abrir painel lateral (Dashboard / Vocabulário / Flow)Alt + Shift + D
Alt + Shift + S (⌥⇧S) — Abrir menu rápido de definiçõesAlt + Shift + S

Controle dentro da janela (Comandos de tecla única com a janela ativa)

FF — Salvar no dicionário (ou remover)
CC — Copiar tradução para a área de transferência
GG — Editar ficha / Adicionar notas e traduções personalizadas
SpaceEspaço / P — Reproduzir / pausar áudio de pronúncia
EscEsc — Fechar janela de tradução
6

Dashboard, Flow & Exportação de vocabulário

O VoxyFlow converte a sua leitura num curso estruturado de idiomas. Gira e exporte o seu banco de palavras:

Translator

Tradutor manual: Bloco de notas no primeiro separador. 'Send to Flow' salva as pesquisas manuais automaticamente.

Flow Stream

Fluxo Flow: Um registo em tempo real de todas as suas traduções com marcas de tempo e contexto.

Word Bank

Dicionário inteligente: Separa automaticamente palavras e frases em separadores diferentes. Permite notas personalizadas.

Anki

Anki CSV: Faça o download do seu vocabulário completo de frases contextuais pronto a importar para o Anki.

Quizlet

Quizlet: Exporte em formato de texto separado por tabulações e cole diretamente no importador do Quizlet.

7

Tecnologia sob o capô

O VoxyFlow adota soluções de engenharia avançadas para máxima rapidez e preservação de limites de API:

Cachê inteligente de 3 níveis

LRU em memória e base de dados persistente IndexedDB (14 dias) carregam palavras conhecidas na hora, poupando a cota do DeepL.

Fusível de segurança API (Circuit Breaker)

Suspende automaticamente os pedidos diante de falhas contínuas para proteger a chave API.

Deteção de idioma em palavras curtas

Usa o idioma HTML da página ('html lang') em palavras de 1-2 caracteres para evitar confusão em românicas.

Otimização para LLMs

Desativa o modo hover para IAs para proteger o consumo de tokens. Limites de 3000 caracteres e timeouts de 120s.