============================================================
  COMECE AQUI
  Transcritor Offline de áudio e vídeo (português)
============================================================

Transforma áudio e vídeo em texto (.txt) no seu próprio
computador. Nada é enviado para a internet: serve para
audiência, depoimento, aula, reunião ou ligação sob sigilo.

O motor é o Whisper (modelo de voz aberto da OpenAI), na versão
otimizada faster-whisper, que roda bem em computador comum, sem
placa de vídeo.

Funciona no Windows 10 ou 11. A instalação leva uns 15 minutos
e precisa de internet só nessa hora (baixa cerca de 700 MB).
Depois, tudo roda offline.


------------------------------------------------------------
  PASSO 1. Instalar o Python (só se ainda não tiver)
------------------------------------------------------------

  Para saber se já tem, aperte a tecla Windows, digite
  PowerShell, abra e digite:

      python --version

  Se aparecer "Python 3.10" ou maior, pule para o PASSO 2.

  Se não aparecer:
    a) Entre em https://www.python.org/downloads/
    b) Clique no botão amarelo "Download Python 3.x.x".
    c) Abra o instalador baixado.
    d) MUITO IMPORTANTE: antes de clicar em "Install Now",
       marque lá embaixo a caixa "Add python.exe to PATH".
    e) Clique em "Install Now" e espere terminar.


------------------------------------------------------------
  PASSO 2. Extrair a pasta do zip
------------------------------------------------------------

  Clique com o botão direito no .zip, escolha "Extrair tudo..."
  e extraia em Documentos (ou onde preferir). Não rode nada de
  dentro do zip sem extrair antes.


------------------------------------------------------------
  PASSO 3. Rodar o instalador
------------------------------------------------------------

  a) Abra a pasta extraída "transcritor-offline".
  b) Clique com o botão direito em "instalar.ps1" e escolha
     "Executar com PowerShell".
  c) Se o Windows avisar que o arquivo veio da internet,
     clique em "Abrir" ou "Executar assim mesmo".

  Se a janela piscar e fechar, ou der erro de permissão:
    1. Abra o PowerShell (tecla Windows, digite PowerShell).
    2. Cole os comandos abaixo, um de cada vez, trocando o
       caminho pelo lugar onde você extraiu a pasta:

         Set-ExecutionPolicy Bypass -Scope Process
         cd "$HOME\Documents\transcritor-offline"
         .\instalar.ps1

  O instalador faz sozinho:
    - instala o transcritor em C:\transcritor-offline
    - baixa o motor e dois modelos de voz (base e small);
    - cria 4 atalhos na Área de Trabalho.

  No fim deve aparecer: INSTALACAO CONCLUIDA COM SUCESSO!

  Depois de instalado, a pasta extraída do zip pode ser
  apagada. O programa fica morando em C:\transcritor-offline.


------------------------------------------------------------
  PASSO 4. Usar
------------------------------------------------------------

  Arraste o áudio ou vídeo (ou uma pasta inteira) por cima de
  um dos atalhos. Ou dê dois cliques no atalho e arraste o
  arquivo para dentro da janela preta, depois aperte Enter.

    Transcrever Audio-Video              o do dia a dia (small)
    Transcrever Audio-Video (rapido)     rascunho de gravação
                                         longa (base)
    Transcrever Audio-Video (qualidade)  áudio ruim, termos
                                         difíceis (medium; no
                                         1º uso baixa 1,5 GB)
    Vigia de Transcricao                 liga a pasta vigiada
                                         (veja abaixo)

  O resultado aparece AO LADO do arquivo original:
    nome.txt              texto corrido, em parágrafos
    nome_timestamps.txt   o mesmo texto com [HH:MM:SS], para
                          citar o momento exato de uma fala

  Formatos aceitos: mp3, wav, m4a, ogg, opus, wma, aac, flac,
  mp4, mkv, avi, mov, wmv, webm e ts.

  Pasta vigiada: com o "Vigia de Transcricao" aberto, todo
  áudio ou vídeo que você soltar em
      C:\transcritor-offline\TRANSCREVER
  é transcrito sozinho, e o .txt aparece na mesma pasta.
  Feche a janela do vigia para desligar.


------------------------------------------------------------
  Quanto demora
------------------------------------------------------------

  Num computador de escritório comum, sem placa de vídeo,
  para cada hora de áudio:

    rápido (base)       15 a 25 minutos
    padrão (small)      30 a 50 minutos
    qualidade (medium)  1h30 a 2h30

  A janela mostra uma barra de progresso. Não feche antes da
  mensagem "Finalizado". Silêncios são pulados, então
  audiências com muitas pausas andam mais rápido.

  Arquivo já transcrito é pulado. Para refazer, apague o .txt
  antigo (ou use a opção --forcar pelo PowerShell).


------------------------------------------------------------
  Cuidados
------------------------------------------------------------

  - Transcrição automática erra: nomes próprios, números,
    siglas e fala sobreposta. Antes de citar um trecho, ouça
    de novo aquele momento (o _timestamps.txt diz onde está).
  - O .txt contém tudo o que foi dito, inclusive dados
    pessoais. Ele é tão sigiloso quanto a gravação.


------------------------------------------------------------
  Opcional. Usar pelo Claude
------------------------------------------------------------

  Se você usa o Claude Code, a pasta "para-o-claude" ensina o
  seu Claude a chamar este transcritor quando você pedir
  "transcreve esta audiência". Instruções em:
      para-o-claude\COMO-USAR-NO-CLAUDE.txt


------------------------------------------------------------
  Problemas comuns
------------------------------------------------------------

  "python não é reconhecido como comando"
     -> Reinstale o Python marcando "Add python.exe to PATH".

  "O instalador foi bloqueado pelo Windows"
     -> Botão direito no instalar.ps1 > Propriedades > marque
        "Desbloquear" > Aplicar. Ou use os comandos do PASSO 3.

  "Modelo não baixou" / "Falha ao instalar as bibliotecas"
     -> Falta de internet ou rede que bloqueia downloads (rede
        corporativa costuma bloquear). Rode o instalar.ps1 de
        novo em outra rede; ele aproveita o que já baixou.

  "A janela diz que o transcritor não está instalado"
     -> O atalho aponta para C:\transcritor-offline. Rode o
        instalar.ps1 de novo.

  "A transcrição saiu com muitos erros"
     -> Use o atalho (qualidade). Ajuda também gravar perto de
        quem fala e evitar som ambiente.
