Guia do Usuário
Como usar o koedesk — voz para texto no seu desktop.
1. Primeiros Passos
Instalação
- Baixe na página de download
- macOS Abra o DMG e arraste o koedesk para Aplicativos
- Windows Execute o instalador (.exe). O SmartScreen pode exibir um aviso — clique em "Mais informações" → "Executar mesmo assim"
Configuração Inicial (macOS)
- Conceda a permissão de Acessibilidade quando solicitado (Ajustes do Sistema → Privacidade e Segurança → Acessibilidade → ative o koedesk)
- Configure a tecla Fn para "Não fazer nada" (Ajustes do Sistema → Teclado → "Pressionar a tecla Fn para" → "Não fazer nada")
Login
- Na primeira execução, uma tela de login aparece automaticamente. Clique em Entrar para abrir o navegador
- Entre com Google, GitHub, Microsoft ou e-mail
2. Modos de Gravação
Push-to-Talk (segure para gravar)
- macOS Segure a tecla Fn esquerda enquanto fala. Solte para parar e transcrever.
- Windows Segure a tecla Alt direita enquanto fala. Solte para parar e transcrever.
Cancelar Gravação
- Pressione Esc durante a gravação para descartar sem transcrever
A barra na parte inferior da tela mostra o estado atual: inativo (ponto pequeno), gravando (barra expandida com forma de onda) ou processando (animação de brilho).
3. Saída de Texto
- Após a transcrição, o texto é automaticamente copiado para a área de transferência
- O koedesk também cola automaticamente o texto no aplicativo em foco (Cmd+V no macOS / Ctrl+V no Windows)
- Se a colagem automática não funcionar em alguns aplicativos, basta colar manualmente — o texto já está na área de transferência
4. Modelo de IA
O koedesk utiliza o ElevenLabs Scribe v2 — o modelo de reconhecimento de fala mais preciso do mundo (2.3% WER). Palavras de preenchimento são removidas automaticamente ao nível do STT. Suporta 36 idiomas com precisão de nível Excelente.
Idiomas suportados
Bahasa Indonesia, Bahasa Melayu, Bosanski, Català, Čeština, Dansk, Deutsch, Eesti, English, Español, Français, Galego, Hrvatski, Íslenska, Italiano, Latviešu, Magyar, Nederlands, Norsk, Polski, Português, Română, Slovenčina, Suomi, Svenska, Tiếng Việt, Türkçe, Ελληνικά, Беларуская, Български, Македонски, Русский, Українська, ಕನ್ನಡ, മലയാളം, 日本語
5. Painel
- Settings — Idioma, dispositivo de entrada e preferências
- Account — Login/logout, visualizar seu plano
- Logs — Histórico de transcrições com detalhamento de latência (codificação / API / injeção)
- Dictionary — Adicione vocabulário personalizado para melhorar a precisão da transcrição
- Developer — Substituir modelo STT, habilitar pós-processamento LLM, informações de depuração
6. Solução de Problemas
macOS Tecla Fn não responde
- Verifique Ajustes do Sistema → Teclado → "Pressionar a tecla Fn para" está definido como "Não fazer nada"
- Verifique Ajustes do Sistema → Privacidade e Segurança → Acessibilidade → koedesk está ATIVADO
Windows SmartScreen bloqueia a instalação
- O aplicativo é assinado digitalmente, mas o SmartScreen pode ainda avisar na primeira instalação. Clique em "Mais informações" → "Executar mesmo assim".
Colagem automática não funciona
- Alguns aplicativos bloqueiam a colagem simulada. O texto já está na área de transferência — pressione Cmd+V / Ctrl+V manualmente.
A transcrição parece imprecisa
- Experimente um modelo de IA diferente (aba Settings)
- Adicione termos específicos ao Dicionário
- Fale com clareza e minimize o ruído de fundo