Open Whisper Ajuda

Bloco 11 Solução de problemas

Leitura · 9 min

Todos os problemas conhecidos, pelo que você vê: a causa e os passos que resolvem, no Mac e no Windows.

Procure o que você está vendo, entenda por que acontece e siga os passos. Os problemas estão agrupados por momento: instalação, permissões, o atalho, a gravação, a colagem, vídeo e linha de comando.

Instalação

"O Windows protegeu o computador"

O instalador ainda não é assinado, então o SmartScreen não o reconhece. O aviso é esperado.

  1. Confira o arquivo antes: na pasta onde você o baixou, rode certutil -hashfile Open.Whisper_X.Y.Z_x64-setup.exe SHA256 (com o nome do arquivo da sua versão).
  2. Compare o resultado com o hash do arquivo .sha256 do mesmo release. Eles precisam ser iguais.
  3. Abra o instalador de novo e clique em Mais informações e depois em Executar assim mesmo.

O instalador precisa de internet

Se faltar o WebView2 no Windows, o instalador o baixa durante a instalação. Conecte-se à internet e rode o instalador de novo. Depois disso, o Open Whisper em si não precisa de internet.

O seu processador é mais antigo

No Windows, o Open Whisper precisa de um processador com AVX2 (Intel a partir de 2013, AMD a partir de 2015). Processadores mais antigos não são suportados.

O app parece não abrir

O Open Whisper não tem janela nem botão no Dock ou na barra de tarefas. Ele vive num ícone.

Mac

Procure na barra de menus, perto do relógio. Clique no ícone para abrir o menu.

Windows

Procure na área de notificação, perto do relógio. Se não estiver vendo, clique em ^ (mostrar ícones ocultos) e arraste o ícone do Open Whisper para a barra de tarefas.

Abrir o app uma segunda vez não muda nada na tela: a cópia que já está aberta continua no comando.

"Abrir ao iniciar" não liga

Mac

A mensagem Mova o Open Whisper para a pasta Aplicativos para usar esta opção. quer dizer que o app está rodando de outro lugar: do .dmg, da pasta Downloads ou de uma subpasta.

  1. Saia do Open Whisper.
  2. Mova o Open Whisper.app direto para /Applications (a pasta Aplicativos, não uma subpasta como Utilitários).
  3. Abra o app de lá e ligue a opção de novo.

Se aparecer Falta aprovar o Open Whisper em Ajustes do Sistema → Itens de Início., clique em Abrir Ajustes do Sistema e ative o Open Whisper em Itens de Início.

Windows

A mensagem Instale o Open Whisper pelo instalador para usar esta opção. quer dizer que esta cópia não é a que o instalador pôs no seu PC. Instale pelo instalador e abra essa cópia.

Se aparecer Desligado em Configurações do Windows → Aplicativos → Inicialização., a opção foi desligada no Windows. Ligue de novo no Open Whisper, ou clique em Abrir as Configurações do Windows e ative em Inicialização.

Permissões

O acesso ao microfone está desligado

Mac

O ditado precisa do microfone. Se você recusou, ou a configuração diz O acesso ao microfone está desligado:

  1. Abra Ajustes do Sistema → Privacidade e Segurança → Microfone.
  2. Ative o Open Whisper.
  3. Dite de novo.

Windows

O Windows deixa os apps usarem o microfone, a não ser que isso tenha sido desligado nas configurações dele. Quando está desligado, o Open Whisper não grava e avisa: O Windows está bloqueando o microfone. Libere em Configurações → Privacidade e segurança → Microfone, inclusive para aplicativos da área de trabalho. As Configurações do Open Whisper mostram o mesmo aviso no topo de Gravação, com a tecla Abrir as Configurações do Windows.

  1. Abra Configurações → Privacidade e segurança → Microfone.
  2. Ative o acesso ao microfone no topo da página e Permitir que aplicativos da área de trabalho acessem o microfone.
  3. Dite de novo.

A colagem automática não liga (Mac)

Mac

O macOS só aplica a permissão de Acessibilidade quando o app abre de novo. Se a chave nos Ajustes do Sistema está ligada mas o texto continua indo para a área de transferência:

  1. Saia do Open Whisper pelo menu (Sair do Open Whisper) e abra de novo. Na configuração inicial, Reabrir o Open Whisper faz isso por você.
  2. Se a chave volta a desligar sozinha, confira se você está usando a cópia baixada do canal oficial.
  3. Continua sem funcionar? Limpe a permissão no Terminal e conceda de novo:
    tccutil reset Accessibility dev.entringer.openwhisper
  4. Escolha Ativar colagem automática… no menu, ative o Open Whisper e reabra o app.

Windows

No Windows não existe a permissão de Acessibilidade: a colagem automática está sempre disponível. Se o texto não foi colado, veja O texto não foi colado.

O atalho

Apertar o atalho não faz nada

  1. Abra o menu e olhe Iniciar Gravação: a tecla mostrada ao lado é o atalho que está valendo de verdade.
  2. Se outro app já usa a sua combinação, os Ajustes dizem Não foi possível registrar …. Escolha outra combinação nos Ajustes.
  3. Enquanto isso, Iniciar Gravação no menu sempre funciona.
  4. Se o atalho funciona mas nada é colado, veja Gravação e O texto não foi colado.

"… é reservado pelo macOS" ou "… é reservado pelo Windows"

O sistema guarda essa combinação para ele. Enquanto ela estiver escolhida, o Open Whisper usa ⇧⌘D no Mac ou CtrlShiftD no Windows no lugar.

  1. Nos Ajustes, clique em Alterar e aperte outra combinação.
  2. Ou clique em Manter e use a alternativa mostrada ao lado de Iniciar Gravação no menu.

A lista completa de combinações reservadas está em Atalhos e teclas.

O gravador não aceita a combinação

Um atalho precisa de um modificador. Uma tecla sozinha, mesmo uma tecla de função como F5, não serve de atalho.

Mac

Inclua ⌘, ⌃ ou ⌥. Shift sozinho não conta. Se aparecer Não foi possível salvar as preferências, a combinação está sem modificador: aperte de novo com um.

Windows

Inclua Ctrl ou Alt. Shift sozinho não conta, e a tecla Windows não pode fazer parte do atalho. Se aparecer Não foi possível salvar as preferências, a combinação está sem modificador: aperte de novo com um.

O atalho atrapalha outro app

No Windows, CtrlShiftEspaço também tem uso no Word e no VS Code. Escolha outra combinação nos Ajustes, como CtrlAltEspaço.

Esc não cancela

O Esc só cancela enquanto o Open Whisper diz Gravando. Quando ele passa a dizer Transcrevendo, a gravação já terminou e o Esc não cancela mais.

Mac

No modo Pressionar para falar, aperte Esc ainda segurando o atalho. As duas formas funcionam: Esc sozinho, ou as teclas que você segura mais Esc. Se o seu atalho usa ⌥ e ⌘ juntos, ⌥⌘Esc é do macOS (Forçar Encerrar): use o modo Alternar para cancelar com Esc.

Windows

No modo Pressionar para falar com CtrlShiftEspaço, o Esc não cancela: CtrlShiftEsc abre o Gerenciador de Tarefas. Você pode:

  1. Soltar as teclas: a gravação termina e é transcrita normalmente.
  2. Mudar para o modo Alternar, em que o Esc cancela.
  3. Ou escolher um atalho como CtrlAltEspaço, que cancela com CtrlAltEsc.

Gravação

"Microfone indisponível — verifique a permissão ou se outro app está usando."

Nenhum microfone foi encontrado, ou outro app está ocupando o microfone.

  1. Confira se há um microfone conectado e escolhido nos ajustes de som do sistema.
  2. Feche o app que está usando o microfone (uma chamada, um gravador) e tente de novo.
  3. Se não for isso, confira a permissão (veja Permissões).

"Nada foi gravado — confira a permissão do microfone ou segure o atalho um pouco mais."

O toque foi curto demais para captar áudio, ou o microfone não entregou nada.

  1. Segure o atalho, comece a falar e só solte depois da última palavra.
  2. Se continuar acontecendo, confira a permissão (veja Permissões).

Nada acontece depois que você fala

Quando nenhuma fala é ouvida, nada é colado e não há aviso, só o som de fim. Fale um pouco mais perto do microfone e tente de novo. No Windows, confira também se o microfone não está bloqueado (veja Permissões).

A gravação parou sozinha

Dois ajustes podem encerrar uma gravação:

  • Gravação máxima: no limite (120 segundos, por padrão) a gravação para e o que foi captado é transcrito. Um aviso diz Gravação interrompida no limite de tempo — transcrevendo o áudio capturado. Aumente até 1800 segundos nos Ajustes, em Avançado.
  • Encerrar após silêncio (só no modo Alternar): depois que você fala, esse tempo calado encerra a gravação. Aumente o tempo ou desligue em Avançado. Uma frase dita muito baixinho bem no final pode ficar de fora.

"Não foi possível carregar o modelo. Verifique nos Ajustes."

O modelo escolhido está faltando ou corrompido.

  1. Abra os Ajustes e expanda Avançado.
  2. Em Modelo, escolha Padrão (o que vem embutido).
  3. Se isso também falhar, reinstale o Open Whisper.

"Falha no download. O modelo atual continua em uso."

O modelo não foi baixado. O anterior continua funcionando.

  1. Confira a sua conexão com a internet.
  2. Escolha o modelo de novo em Avançado → Modelo para tentar outra vez. Um download não começa durante um ditado.

As palavras saem erradas, ou no idioma errado

Nos Ajustes, troque Idioma de Detectar automaticamente para o idioma que você fala. Modelos maiores erram menos, em troca de um download e de mais tempo: veja Modelos.

O texto não foi colado

Um aviso diz "Copiado para a área de transferência"

O texto não pôde ser colado onde você estava, então ficou na área de transferência. Nada se perdeu.

Mac

Acontece quando a colagem automática está desligada (os Ajustes mostram Colagem automática: desligada), num campo de senha, ou quando nada em que se possa digitar está em foco (a mesa, uma janela do Finder, uma página que você só está lendo).

  1. Clique onde o texto deve ir.
  2. Aperte ⌘V, ou escolha Repetir Última Transcrição no menu.
  3. Para colar sozinho daqui para a frente, clique em Ativar… nos Ajustes, ou em Ativar colagem automática… no menu.

Windows

Acontece numa janela aberta como administrador (o Windows não deixa outros apps digitarem nela), num campo de senha, ou quando nada em que se possa digitar está em foco.

  1. Clique onde o texto deve ir.
  2. Aperte CtrlV, ou escolha Repetir Última Transcrição no menu.

Rodar o próprio Open Whisper como administrador não é recomendado.

O texto não apareceu em lugar nenhum

Em navegadores e em apps feitos sobre eles (Chrome, VS Code, Slack, Discord), o Open Whisper nem sempre consegue saber se há um campo de texto em foco, então cola mesmo assim. Se nenhum campo estava em foco, a colagem cai no vazio e a área de transferência volta ao que tinha antes.

  1. Clique no campo.
  2. Escolha Copiar Última Transcrição no menu e cole. O último ditado fica guardado até você sair do app.

Os ditados não aparecem no histórico da área de transferência do Windows

É de propósito. O texto ditado nunca vai para o WinV nem para a sincronização na nuvem, mesmo quando fica na área de transferência. Veja Privacidade.

O que você tinha copiado não voltou

Depois de colar, o Open Whisper devolve o que estava na área de transferência, mas só texto. Uma imagem ou outro conteúdo que você tinha copiado pode não voltar.

Vídeo

"O Open Whisper precisa do yt-dlp para acessar vídeos"

Links de vídeo precisam do yt-dlp, uma ferramenta gratuita que você mesmo instala. O Open Whisper nunca instala nem atualiza o yt-dlp. Arquivos do seu computador não precisam dele.

Mac

 brew install yt-dlp

Se disser que o yt-dlp instalado é antigo demais (a versão mínima é 2025.01.01):

 brew upgrade yt-dlp

Windows

 winget install yt-dlp.yt-dlp

Se disser que o yt-dlp instalado é antigo demais (a versão mínima é 2025.01.01):

 winget upgrade yt-dlp.yt-dlp

Se o yt-dlp está instalado num lugar onde o Open Whisper não procura, defina a variável de ambiente OPEN_WHISPER_YT_DLP com o caminho completo dele.

"Falhou por um motivo que o Open Whisper não reconhece"

O YouTube muda com frequência, e um yt-dlp antigo para de funcionar. Atualize o yt-dlp (acima) e tente de novo.

"Isso não é o link de um vídeo do YouTube"

Só links de um único vídeo do YouTube funcionam. Playlists, canais e outros sites são recusados. Abra o próprio vídeo e copie o link dele.

"Este vídeo não tem legendas utilizáveis"

Clique em Transcrever neste dispositivo. Isso baixa o áudio e transcreve no seu computador, o que leva alguns minutos.

"O YouTube está limitando os acessos agora" ou "Sem conexão com a internet."

Espere alguns minutos, confira a sua conexão e tente de novo.

"O Open Whisper não consegue decodificar o áudio deste arquivo"

O arquivo usa um formato que o app não lê (Opus, AC-3, E-AC-3, DTS, ou um arquivo AVI, WMV ou ASF). Exporte como MP4 ou M4A com AAC, ou como MP3, FLAC ou WAV, e tente de novo.

"Este vídeo passa do limite de 3 horas"

Vídeos e arquivos com mais de 3 horas não cabem na memória com segurança. Corte a gravação em partes menores que 3 horas.

"O Open Whisper transcreve um vídeo por vez"

Espere o trabalho atual terminar ou cancele. Copiar também é recusado enquanto você dita: espere o ditado terminar e clique de novo.

O vídeo sai no idioma que você usava antes

Se você trocou o Idioma nos Ajustes e um vídeo continua saindo no idioma antigo, saia do Open Whisper e abra de novo.

Sair pergunta sobre um vídeo

Uma transcrição de vídeo está em andamento. Se você sair agora, ela será perdida. Clique em Continuar para deixar terminar, ou em Sair mesmo assim para perder o trabalho.

Linha de comando

"open-whisper" não é encontrado

Mac

Se você instalou pelo Homebrew, o comando já está no PATH. Se instalou pelo .dmg, crie o link uma vez:

 ln -s "/Applications/Open Whisper.app/Contents/MacOS/open-whisper" /opt/homebrew/bin/open-whisper

Num Mac com Intel, use /usr/local/bin/open-whisper na última parte.

Windows

  1. Abra uma janela nova do terminal: as janelas que estavam abertas durante a instalação ainda não enxergam o comando.
  2. Se continuar sem encontrar, o seu PATH era longo demais para o instalador acrescentar o comando. Rode o open-whisper.com pelo caminho completo, na pasta onde o Open Whisper está instalado.

Rodar open-whisper sem argumentos termina com erro de uso, de propósito: o app em si abre pelo menu Iniciar.

Código de saída 2

O comando foi digitado errado: uma opção ou um valor desconhecido, faltou a entrada, sobraram duas entradas, ou uma entrada veio sem transcribe. Rode open-whisper --help e confira o comando.

Código de saída 4

O modelo não está baixado, e o comando nunca baixa nada sozinho. Acrescente --model small-q5_1 para usar o embutido, ou baixe o modelo no app antes.

Código de saída 7

O vídeo não tem legendas utilizáveis. Rode de novo com --on-device para transcrever o áudio no seu computador.

Todos os códigos de saída, com o que fazer em cada um, estão na Referência do comando.

Ainda sem solução?

Se o seu problema não está aqui, ou uma solução não funcionou, conte para a gente. Relatar um problema explica onde e o que incluir.