════════════════════════════════════════════════════════════════════
  VoxFlow — Sua voz. Seu fluxo.
  Guia completo do usuário
  Versão 0.1.0
  Site: https://sistemas.store/voxflow
════════════════════════════════════════════════════════════════════

  Este guia foi feito para quem nunca usou um programa de voz
  para texto. Nada de termos complicados — só o que você precisa
  para começar a usar hoje.

────────────────────────────────────────────────────────────────────
ÍNDICE
────────────────────────────────────────────────────────────────────
  1. O que é o VoxFlow (e para que serve)
  2. Instalação
  3. Ativação da licença (chave de compra)
  4. Primeira vez que você abre o programa
  5. Como usar no dia a dia
  6. O atalho de gravação (muito importante)
  7. Seu microfone
  8. Modelos de transcrição (o "cérebro" do VoxFlow)
  9. Transcrição pela internet (opcional)
  10. Idioma da transcrição
  11. Detecção automática de silêncio
  12. Dicionário e correções automáticas
  13. Histórico e favoritos
  14. Configurações
  15. O ícone do VoxFlow na bandeja (perto do relógio)
  16. Privacidade (seus dados são seus)
  17. Problemas comuns — e como resolver
  18. Perguntas frequentes
  19. Requisitos do computador
  20. Suporte

────────────────────────────────────────────────────────────────────
1. O QUE É O VOXFLOW (E PARA QUE SERVE)
────────────────────────────────────────────────────────────────────
O VoxFlow transforma a SUA VOZ em texto digitado, dentro de
qualquer outro programa do seu computador.

Funciona assim: você fala, o VoxFlow ouve e escreve por você.

Exemplos de uso:
  • Responder um e-mail longo sem digitar;
  • Escrever documentos enquanto pensa em voz alta;
  • Mandar mensagens no WhatsApp Web sem teclado;
  • Fazer anotações, listas, textos em geral;
  • Quem tem dificuldade de digitar ou dor nas mãos.

Você pode usar o VoxFlow em QUALQUER programa: Bloco de Notas,
Word, navegador de internet, WhatsApp Web, e-mail... se dá para
digitar, o VoxFlow escreve.

────────────────────────────────────────────────────────────────────
2. INSTALAÇÃO
────────────────────────────────────────────────────────────────────
1. Dê dois cliques no arquivo chamado VoxFlow_0.1.0_x64-setup.exe.
2. O Windows pode perguntar "Deseja permitir?" — clique em SIM.
3. Siga as telas do instalador. Você pode deixar tudo no padrão
   e clicar em AVANÇAR até terminar.
4. Pronto! O VoxFlow aparece no Menu Iniciar e na área de
   trabalho do seu computador.

Para REMOVER o programa depois:
  Iniciar → Configurações → Aplicativos → Instalados →
  procure por VoxFlow → Desinstalar.

Dica: se o Windows mostrar um aviso azul ou amarelo sobre o
arquivo de instalação ("Editor desconhecido"), clique em
"Mais informações" e depois em "Executar mesmo assim".

────────────────────────────────────────────────────────────────────
3. ATIVAÇÃO DA LICENÇA (CHAVE DE COMPRA)
────────────────────────────────────────────────────────────────────
O VoxFlow é pago. Ao comprar no site, você recebe uma CHAVE DE
LICENÇA — um código que parece com isto:

  VXF-XXXX-XXXX-XXXX-XXXX

COMO ATIVAR (primeira vez):
  1. Abra o VoxFlow.
  2. Na tela de ativação, digite ou cole a chave que você recebeu
     por e-mail/WhatsApp após a compra.
  3. Clique em "Ativar licença".
  4. Pronto! O programa libera e você já pode usar.

IMPORTANTE:
  • A chave funciona em uma máquina por vez.
  • Guarde a chave em um lugar seguro (e-mail, bloco de notas).
  • Cada chave tem uma data de validade (ex: 1 ano). O dia
    exato aparece dentro do programa.

QUANDO A LICENÇA VENCE:
  • O VoxFlow avisa antes, mostrando quantos dias faltam.
  • Quando vence, aparece a tela de ativação novamente.
  • Você renova no site e cola a NOVA chave na mesma tela.

O que NÃO fazer:
  • Não apague o arquivo de configurações do programa para
    tentar "ganhar tempo" — o programa percebe e pede a chave
    de novo.
  • Não mude a data do relógio do computador — isso não
    funciona e pode bagunçar outros programas.

────────────────────────────────────────────────────────────────────
4. PRIMEIRA VEZ QUE VOCÊ ABRE O PROGRAMA
────────────────────────────────────────────────────────────────────
Na primeira vez, o VoxFlow mostra um "passeio" de 4 telinhas
rápidas para deixar tudo pronto:

  Passo 1 — Boas-vindas.
  Passo 2 — Escolha do microfone (com teste para ver se está
            pegando a sua voz).
  Passo 3 — Configuração do atalho (veja a seção 6).
  Passo 4 — Primeira transcrição de teste.

DICA IMPORTANTE: se no passo 4 aparecer um aviso amarelo
"nenhum motor de transcrição configurado", clique em
"Baixar modelo Base" ali mesmo e espere terminar. Só depois o
teste funciona. (Você também pode pular e fazer isso depois.)

────────────────────────────────────────────────────────────────────
5. COMO USAR NO DIA A DIA
────────────────────────────────────────────────────────────────────
É só seguir estes 5 passos:

  1. Abra o programa onde você quer escrever (ex: Bloco de
     Notas, Word, WhatsApp Web).
  2. Pressione e SEGURE o atalho de gravação (padrão:
     Ctrl+Alt+Espaço — veja a seção 6).
  3. Fale normalmente, como se estivesse conversando.
  4. Solte o atalho.
  5. Espere alguns segundos: o texto aparece digitado sozinho
     no programa que estava aberto.

Você também pode gravar pela janela do VoxFlow:
  Aba "Transcrever" → clique no botão grande de microfone para
  começar → clique de novo para parar.

Durante a gravação, uma pequena janelinha transparente aparece
na parte de baixo da tela mostrando que ele está ouvindo. Ela
não atrapalha o que você está fazendo.

────────────────────────────────────────────────────────────────────
6. O ATALHO DE GRAVAÇÃO (MUITO IMPORTANTE)
────────────────────────────────────────────────────────────────────
O atalho é uma combinação de teclas que liga e desliga a
gravação, mesmo quando o VoxFlow está escondido.

Padrão: Ctrl + Alt + Espaço
  (pressione e segure para falar; solte para finalizar)

COMO TROCAR O ATALHO:
  1. Abra o VoxFlow → aba Configurações → Atalho.
  2. Clique em "Alterar atalho".
  3. Pressione a combinação que você quiser (ex: Ctrl+Alt+K).
  4. Pronto, já está salvo.

SE O ATALHO NÃO FUNCIONAR:
  • Algumas combinações já são usadas pelo Windows ou por
    outros programas. Escolha outra, como Ctrl+Alt+K.
  • Se você usa teclado em outro idioma, evite combinações
    com teclas que mudam de lugar.

────────────────────────────────────────────────────────────────────
7. SEU MICROFONE
────────────────────────────────────────────────────────────────────
O VoxFlow precisa de um microfone funcionando. Pode ser o do
próprio notebook, um fone de ouvido com microfone (headset) ou
um microfone USB.

COMO CONFERIR SE ESTÁ TUDO CERTO:
  Aba Configurações → Microfone:
  • Escolha o dispositivo certo na lista;
  • Clique em "Testar microfone" e fale: a barrinha deve se
    mover com a sua voz.

SE A CAPTAÇÃO ESTIVER FRACA (texto errado ou "nenhuma fala
detectada"):
  1. Aumente o volume do microfone no Windows:
     Configurações → Sistema → Som → Entrada → seu microfone.
  2. Aumente o "Ganho do microfone" dentro do VoxFlow
     (Configurações → Microfone). Valores entre 1 e 4.
  3. Teste de novo.

────────────────────────────────────────────────────────────────────
8. MODELOS DE TRANSCRIÇÃO (O "CÉREBRO" DO VOXFLOW)
────────────────────────────────────────────────────────────────────
Para entender a sua voz, o VoxFlow usa um "modelo" — pense nele
como um cérebro que precisa ser instalado no seu computador.
Sem ele, nada é transcrito.

COMO BAIXAR:
  1. Aba "Modelos" → clique em "Baixar" no modelo que quiser.
  2. Espere a barrinha de progresso chegar a 100% (uma vez só,
     o download é rápido).
  3. Depois de baixado, o modelo já fica pronto para usar.

QUAIS MODELOS EXISTEM:
  • Whisper Base Q5 (~57 MB) — o mais rápido. Ótimo para a
    maioria das pessoas e computadores mais simples.
    RECOMENDADO.
  • Whisper Small Q5 (~181 MB) — entende melhor vozes com
    sotaque ou barulho de fundo, mas é mais lento em
    computadores fracos.

DICA: se o texto sair com erros, experimente o modelo Small.
Se estiver lento, volte para o Base.

IMPORTANTE: a aba "Transcrever" mostra um aviso se você ainda
não tiver modelo baixado nem internet configurada — nesse caso,
basta baixar um modelo (veja acima).

────────────────────────────────────────────────────────────────────
9. TRANSCRIÇÃO PELA INTERNET (OPCIONAL)
────────────────────────────────────────────────────────────────────
Além do modelo local, o VoxFlow permite transcrever usando
serviços de internet (OpenAI, Groq, etc.). Isso é opcional e
fica DESLIGADO por padrão.

QUANDO VALE A PENA:
  • Quando o texto sai mais preciso que o modelo local;
  • Em computadores fracos (a transcrição acontece na
    internet, não no seu computador).

COMO FUNCIONA:
  1. Você precisa ter uma chave (API key) de um desses
     serviços — normalmente você cria uma conta no site do
     serviço e gera a chave lá.
  2. No VoxFlow: aba Configurações → "Transcrição via API" →
     ative e cole a chave.
  3. O VoxFlow envia o áudio para esse serviço e recebe o texto
     de volta.

ATENÇÃO (leia com calma):
  • Ao ativar, o seu áudio sai do computador e vai para o
    serviço escolhido. Se você se importa com privacidade,
    deixe desligado e use o modelo local.
  • Esses serviços podem cobrar por uso — a cobrança é feita
    pelo serviço, não pelo VoxFlow.
  • Você pode cadastrar mais de uma chave: uma principal e uma
    de reserva (se a principal falhar, o VoxFlow tenta a de
    reserva automaticamente).

────────────────────────────────────────────────────────────────────
10. IDIOMA DA TRANSCRIÇÃO
────────────────────────────────────────────────────────────────────
O VoxFlow entende vários idiomas: Português (Brasil), English,
Español, Français, Deutsch, Italiano, Japonês, Coreano, Chinês
e também o modo "Automático" (ele tenta descobrir).

DICA: se você sempre fala português, escolha "Português" fixo —
fica mais rápido e mais preciso do que o modo automático.

Onde mudar: Configurações → Idioma.

────────────────────────────────────────────────────────────────────
11. DETECÇÃO AUTOMÁTICA DE SILÊNCIO
────────────────────────────────────────────────────────────────────
O VoxFlow tem uma "inteligência" que ignora silêncio:

  • Se você demorar para começar a falar, ele não conta o
    silêncio no início e no fim;
  • Se você ficar ~2 segundos sem falar, ele PARALISA a
    gravação sozinho (mesmo que você continue segurando o
    atalho);
  • Se a gravação não tiver fala nenhuma, ele descarta e não
    escreve nada.

SENSIBILIDADE: em Configurações → Gravação → Sensibilidade.
  • Maior = pega voz baixa e até ruídos;
  • Menor = só voz forte, ignora barulho de fundo.

Se ele estiver "cortando" sua fala no meio, diminua a
sensibilidade. Se ele não percebe sua voz, aumente.

────────────────────────────────────────────────────────────────────
12. DICIONÁRIO E CORREÇÕES AUTOMÁTICAS
────────────────────────────────────────────────────────────────────
Para melhorar o texto que sai, você pode ensinar o VoxFlow:

  • PALAVRAS (Dicionário): nomes próprios e termos que ele
    erra. Ex: "VoxFlow", "WhatsApp", "TikTok". Ele passa a
    escrever essas palavras corretamente.

  • SUBSTITUIÇÕES: transforma um trecho falado em outro texto
    depois da transcrição. Ex: quando você falar "vox flow",
    ele escreve "VoxFlow". Funciona ignorando maiúsculas/
    minúsculas.

Onde: abas "Dicionário" e "Configurações" (seção Substituições)
ou o menu lateral.

────────────────────────────────────────────────────────────────────
13. HISTÓRICO E FAVORITOS
────────────────────────────────────────────────────────────────────
Toda transcrição fica salva no histórico (no próprio
computador, em um arquivo de banco de dados local).

Na aba "Histórico" você pode:
  • Pesquisar por texto (barra de busca);
  • Copiar o texto de novo;
  • Editar e excluir;
  • Marcar como favorito (os favoritos aparecem na aba
    "Favoritos").

EXPORTAR: na aba Histórico, o botão "Exportar" salva uma cópia
em arquivo (JSON) e abre a pasta onde ele foi salvo. Útil para
fazer backup.

────────────────────────────────────────────────────────────────────
14. CONFIGURAÇÕES
────────────────────────────────────────────────────────────────────
Resumo do que dá para ajustar na aba Configurações:

  • Atalho global ........... trocar a combinação de teclas
  • Modo de gravação ........ Segurar (Push-to-Talk) ou Toque
                              (Toggle, liga/desliga com 1 toque)
  • Sensibilidade ........... como explicado na seção 11
  • Feedback sonoro ......... um "bip" ao iniciar/parar gravação
  • Ganho do microfone ...... volume da captação (1 a 4)
  • Tema .................... Escuro / Claro / Seguir o sistema
  • Idioma .................. seção 10
  • Licença ................. sua chave e validade (seção 3)
  • Transcrição via API ..... internet opcional (seção 9)

────────────────────────────────────────────────────────────────────
15. O ÍCONE DO VOXFLOW NA BANDEJA (PERTO DO RELÓGIO)
────────────────────────────────────────────────────────────────────
O VoxFlow continua funcionando mesmo com a janela fechada.
Ele fica escondido na BANDEJA — a região perto do relógio do
Windows (aquela setinha que esconde ícones).

  • Clicar no X da janela = o programa se esconde para a
    bandeja (ele NÃO fecha de verdade).
  • Clicar no ícone = reabre o VoxFlow.
  • Clicar com o botão direito = menu:
      - Abrir VoxFlow
      - Iniciar gravação
      - Sair

PARA FECHAR DE VERDADE: clique com o botão direito no ícone →
"Sair".

────────────────────────────────────────────────────────────────────
16. PRIVACIDADE (SEUS DADOS SÃO SEUS)
────────────────────────────────────────────────────────────────────
  • 100% do funcionamento normal acontece no SEU computador:
    sua voz NUNCA sai da sua máquina (usando o modelo local).
  • Sem propagandas, sem contas obrigatórias, sem rastreamento.
  • O histórico fica só na sua máquina.
  • A única conexão com a internet é quando VOCÊ baixa um
    modelo (uma vez) ou quando ativa a transcrição por
    serviços (seção 9, opcional).

────────────────────────────────────────────────────────────────────
17. PROBLEMAS COMUNS — E COMO RESOLVER
────────────────────────────────────────────────────────────────────

"GRAVEI, MAS NÃO APARECEU NENHUM TEXTO"
  • Você já baixou um modelo? (Seção 8 — aba Modelos)
  • Apareceu um aviso na tela? Leia o que ele diz e siga.
  • Se o aviso for "nenhuma fala detectada", veja o item de
    microfone abaixo.

"APARECE 'NENHUMA FALA DETECTADA'"
  • Sua voz está baixa para o programa. Aumente o ganho
    (Configurações → Microfone) e o volume do microfone no
    Windows.
  • Fale mais perto do microfone e de forma contínua.

"O TEXTO SAI ERRADO / ESTRANHO"
  • Use o modelo Small (mais preciso).
  • Fixe o idioma em Português (Configurações → Idioma).
  • Adicione palavras que ele erra no Dicionário.

"O TEXTO DEMORA MUITO PARA SAIR"
  • Use o modelo Base (mais rápido).
  • Fixe o idioma em vez de "Automático".
  • Computadores mais simples demoram mais — normal.

"O ATALHO NÃO FAZ NADA"
  • O atalho já é usado por outro programa? Troque para outro
    (ex: Ctrl+Alt+K).
  • Confira se o VoxFlow está rodando (ícone na bandeja).

"O TEXTO NÃO ENTRA NO PROGRAMA QUE EU QUERIA"
  • Clique no programa alvo ANTES de gravar (ele precisa estar
    aberto e em primeiro plano).
  • Alguns programas abertos "como administrador" bloqueiam a
    escrita automática. Feche e abra sem administrador.

"NA ABA TRANSCREVER O BOTÃO ESTÁ DESABILITADO"
  • Isso acontece quando não há modelo baixado nem internet
    configurada. Baixe um modelo (seção 8) ou ative uma chave
    de API (seção 9).

"APARECE 'LICENÇA EXPIRADA'"
  • Sua chave venceu. Renove no site (sistemas.store/voxflow) e
    cole a nova chave na tela de ativação.

"NÃO CONSIGO INSTALAR / O WINDOWS BLOQUEIA"
  • Clique em "Mais informações" → "Executar mesmo assim".
  • Verifique se o Windows está atualizado (Windows 10 ou 11).

AINDA COM PROBLEMAS? Veja a seção 20 (Suporte) — informe o que
aparece na tela, que fica mais fácil ajudar.

────────────────────────────────────────────────────────────────────
18. PERGUNTAS FREQUENTES
────────────────────────────────────────────────────────────────────

"PRECISA DE INTERNET PARA FUNCIONAR?"
  Não, usando o modelo local (padrão). Internet só para
  baixar o modelo uma vez, ou se você ativar a transcrição
  por serviços (opcional).

"QUAIS PROGRAMAS SÃO COMPATÍVEIS?"
  Qualquer um onde dá para digitar: Word, Bloco de Notas,
  navegadores, WhatsApp Web, e-mail, etc.

"FUNCIONA NO MEU COMPUTADOR?"
  Se ele roda Windows 10/11 de 64 bits com pelo menos 4 GB de
  memória (RAM), sim. Computadores mais fracos devem usar o
  modelo Base.

"O VOXFLOW OUVE MINHAS CONVERSAS O TEMPO TODO?"
  Não. Ele só escuta enquanto você está gravando (segurando o
  atalho ou com a gravação ativa).

"POSSO USAR EM MAIS DE UM COMPUTADOR?"
  A licença é por máquina. Para outro computador, você precisa
  de outra chave.

"E SE EU PERDER A CHAVE?"
  Entre em contato pelo site (seção 20) com o e-mail da
  compra.

"POSSO DESINSTALAR E INSTALAR DE NOVO?"
  Sim, sem problemas. A chave continua válida (desde que não
  tenha vencido).

"O TEXTO VAI PARA ALGUÉM?"
  Não. Com o modelo local, tudo fica no seu computador.

────────────────────────────────────────────────────────────────────
19. REQUISITOS DO COMPUTADOR
────────────────────────────────────────────────────────────────────
  • Windows 10 ou 11 (64 bits)
  • 4 GB de memória (RAM) — 8 GB recomendado
  • Cerca de 150 MB de espaço em disco (mais o modelo: 57 MB
    ou 181 MB)
  • Microfone (embutido ou externo)
  • Internet: só para baixar modelos ou usar serviços
    opcionais

────────────────────────────────────────────────────────────────────
20. SUPORTE
────────────────────────────────────────────────────────────────────
Site oficial: https://sistemas.store/voxflow

Lá você encontra:
  • Como comprar e renovar a licença;
  • Meios de contato (e-mail/WhatsApp) para tirar dúvidas;
  • Ajuda e atualizações do programa.

Para nos ajudar a resolver um problema, informe:
  • Qual versão do Windows você usa;
  • O que aconteceu, passo a passo;
  • O texto exato de qualquer mensagem/aviso que apareceu.

────────────────────────────────────────────────────────────────────
Obrigado por usar o VoxFlow!
Sua voz. Seu fluxo.
════════════════════════════════════════════════════════════════════