# Legendei

Coloca legenda em vídeo automaticamente, com 88 estilos, corte das pausas e
limpeza do áudio. Roda no seu computador. Nenhum vídeo sobe pra internet.

---

## Começar (dois cliques)

**1.** Dê dois cliques em **`instalar.bat`**. Ele prepara tudo sozinho, inclusive
o ffmpeg. A primeira vez demora alguns minutos porque baixa cerca de 500 MB.

**2.** Dê dois cliques em **`iniciar.bat`**. O navegador abre sozinho.

Da próxima vez, só o passo 2.

> **Com o Claude Code é ainda mais simples:** abra esta pasta nele e digite
> `/comecar`. Ele instala tudo e te devolve o link pronto.

---

## Usando

1. **Enviar** — arraste o vídeo. Aceita qualquer formato e qualquer proporção:
   deitado, em pé ou quadrado. A prévia se ajusta ao seu vídeo.
2. **Estilo** — escolha um dos 88 e clique em Avançar. Enquanto você escolhe, o
   computador já está ouvindo o áudio.
3. **Gerando legenda** — ele marca o segundo exato de cada palavra.
4. **Editar e ajustes** — clique numa palavra no vídeo pra corrigir, arraste a
   legenda pra onde quiser, mude o tamanho. Aqui você liga a limpeza do áudio e a
   edição automática.
5. **Gerando vídeo** — aparecem só as etapas que você pediu.
6. **Pronto** — botão para baixar o MP4.

Sem vídeo à mão? Na primeira tela tem três exemplos prontos, inclusive um com
chiado e gaguejo pra você ver a limpeza e o corte funcionando.

---

## Limpar o áudio

Quatro níveis: **Não, Leve, Médio, Forte**. O filtro se calibra pelo trecho mais
silencioso do seu vídeo, então ele aprende qual é o ruído daquela gravação.

Medido no vídeo de exemplo, no pedaço sem fala:

| Nível | Ruído de fundo | Volume da voz |
|---|---|---|
| Não | −45 dB | −26 dB |
| Médio | −52 dB | −27 dB |
| Forte | −70 dB | −27 dB |

O ruído cai e a voz fica no mesmo volume. O Forte limpa quase tudo, mas pode
deixar a voz um pouco metálica.

---

## Edição automática

Três opções: **Não, Pausas, Esperta**.

- **Pausas** tira os silêncios acima de 0,85 segundo e as pontas do vídeo.
- **Esperta** tira também hesitações ("ééé", "ahn", "hmm") e palavra repetida por
  gaguejo: "eu eu acho" vira "eu acho".

Antes de gerar, a tela mostra o que vai sair, com as palavras riscadas.

Três coisas que ele **não** corta de propósito: "né", "tipo" e "então" mudam o
sentido da frase se sumirem, e "é" sozinho é o verbo ser. Só "ééé" alongado conta
como hesitação.

---

## Os estilos

São 88, com 67 fontes de verdade, em três abas:

- **Limpos (70)** — branco, sem contorno, sombra suave. É onde o app abre.
- **Coloridos (12)** — Hustle, Impacto, Hormozi, Neon, Pop e companhia.
- **Com fundo (6)** — texto dentro de uma faixa.

Para criar um estilo novo, use o Claude Code nesta pasta e digite `/estilo`
seguido do que você quer. Ou edite a tabela em
`app/ferramentas/gerar_estilos.py` e rode:

```
.venv\Scripts\python.exe app\ferramentas\gerar_estilos.py
```

---

## Se der problema

| O que aparece | O que fazer |
|---|---|
| "o ffmpeg nao esta instalado" | Rode o `instalar.bat` de novo; se insistir, instale pelo site do ffmpeg |
| "Primeiro abra o instalar.bat" | Faltou o passo 1 |
| "Faltam as fontes das legendas" | Rode o `instalar.bat` de novo |
| "Nao achei nenhuma porta livre" | Outra cópia do app já está aberta |
| O navegador não abriu sozinho | Abra `http://localhost:8123` na mão |

---

## Espaço em disco

A pasta `trabalhos/` guarda uma cópia de cada vídeo que você envia, e nada é
apagado sozinho. De vez em quando apague o que está lá dentro: os vídeos que você
já baixou não são afetados. No Claude Code, `/limpar` faz isso.

Não apague `models/` nem `static/fonts/`: seriam 475 MB para baixar de novo.

---

## Mais rápido, se você tem placa de vídeo NVIDIA

Antes de abrir o `iniciar.bat`, no Terminal:

```
set LEGENDEI_DEVICE=cuda
set LEGENDEI_ENCODER=h264_nvenc
```

`LEGENDEI_MODEL` aceita `tiny`, `base`, `small` (o padrão), `medium` e `large-v3`.
Quanto maior, melhor a transcrição e mais devagar.
