---
name: motionz
description: Edita um vídeo vertical (a pessoa falando pra câmera) na pegada MOTIONZ - corte com silêncio quase zero, 1.2x, legenda grande palavra por palavra em Anton com palavra-chave laranja, peças animadas acima da cabeça que entram na palavra falada (ícones, riscados, janelas, notificação, chat do Claude, desenho à mão, código, cartão), telas pretas só com letras nas frases fortes, zoom seco, trilha baixa e poucos efeitos com a voz sempre na frente. Mostra storyboard antes de renderizar. Use quando pedirem "/motionz", "edita na pegada motionz", "edita com motion", "edição tipo vitrine" ou mandarem um vídeo pra editar desse jeito.
---

# /motionz

**Kit:** pasta `motionz` dentro da pasta do usuário (Windows `C:\Users\<nome>\motionz`, Mac `~/motionz`). Rode tudo a
partir dela. Python do kit: Windows `.venv\Scripts\python.exe`, Mac `.venv/bin/python` (chamado de `$PY` abaixo).
Biblioteca de sons e músicas: `motor/baixar_biblioteca.py` (o instalador já baixou o essencial).

**A regra:** o vídeo real da pessoa por baixo, sem recortar ela do fundo. Por cima, pouca coisa e sempre na palavra
falada. A voz é o centro: trilha e efeitos ficam bem abaixo dela. Minimalista, mas com ritmo.

Antes de cada passo lento, avise em uma linha ("Transcrevendo, leva uns 2 minutos").

## 1. Projeto e transcrição
1. Crie `projetos/<nome-curto>/` e copie o vídeo pra lá como `bruto.mp4` (ou `.mov`).
2. `$PY motor/transcrever.py projetos/<nome>/bruto.mp4 projetos/<nome>/bruto.json`
3. Leia o texto. Repetição, começo falso ou frase refeita? Escreva `projetos/<nome>/tirar.json` com
   `[[inicio_s, fim_s, "motivo"], ...]` (do começo da palavra ruim até o começo da boa). Sem nada pra tirar: `[]`.

## 2. Corte (silêncio quase zero)
1. `$PY motor/planejar.py projetos/<nome>/bruto.mp4 projetos/<nome> --pausa 0.10 --folga 0.035`
2. `$PY motor/cortar.py projetos/<nome>/bruto.mp4 projetos/<nome>/cortes.json projetos/<nome>`
3. `$PY motion/aperta.py projetos/<nome> --medir`. Se aparecer "silêncios de 0,15 s ou mais" (acontece com microfone
   que tem portão de ruído), rode `$PY motion/aperta.py projetos/<nome>`, depois o `cortar.py` de novo e o `--medir`
   de novo. A meta é zero silêncio de 0,15 s pra cima.
4. Se o `--medir` avisar "saiu som alto", confira se era fala (normalmente é o toque pra parar a gravação no fim).
5. `$PY motor/transcrever.py projetos/<nome>/limpo.mkv projetos/<nome>/limpo.json` e
   `$PY motor/conferir.py projetos/<nome> bruto.json`: nenhuma palavra pode sumir.

## 3. Preparar e legendar
1. `$PY motion/prepara.py projetos/<nome> --vel 1.2` (quadros já em 1.2x, voz separada, cria o `edicao.html`).
   Gravação de 60 qps (iPhone em 4K/60, por exemplo) sai em 60 sozinha: os quadros vêm direto do bruto com o mesmo corte
   e o render sai em 60. Em 30 o movimento fica picado (o 1.2x joga fora 1 de cada 6 quadros). O render em 60 leva o dobro.
2. `$PY motion/legenda.py projetos/<nome> --vel 1.2 --chave "claude,chatgpt,..." --corrige "cloud=Claude;chat apt=ChatGPT"`
   - `--chave`: 15 a 25 palavras que ficam laranja (nomes de ferramenta, a ideia central, números, a palavra do CTA).
   - `--corrige`: nome que a transcrição escreveu errado (`errado=certo`, com `;` entre eles; duas palavras viram uma).
   - Confira a lista que ele imprime. Os tempos dali (início de cada palavra) são os que valem pra edição.
3. Olhe um quadro (`projetos/<nome>/quadros/v/0100.jpg`): ache onde fica o alto da cabeça e se a parede é laranja.

## 4. Roteiro e peças
Monte uma tabela pro criador: tempo, fala, peça. Depois edite o `edicao.html`, só entre
"A EDIÇÃO DESTE VÍDEO" e "FIM DAS PEÇAS". As peças prontas estão comentadas no próprio arquivo, e o exemplo completo
de um Reel aprovado está em `motion/exemplo-codex.js`:

| peça | quando usar |
|---|---|
| `HEADLINE` | **obrigatória em todo vídeo**: a frase principal em modo comando (verbo + o que a pessoa faz/ganha), caixa clara + faixa escura, do quadro 0 até uns 5 s |
| `ICONES` | gancho com ferramentas ("o Claude e o ChatGPT"), com fio ligando quando ele diz "conectados" |
| `RISCADOS` | "não é X, não é Y": linhas com ícone que levam risco laranja |
| `PRETA` | a frase mais forte (1 a 3 por vídeo): ele sai, ficam letras grandes no preto, a voz continua |
| `TEXTO` | uma frase curta branca acima da cabeça |
| `JANELAS` | dois aplicativos, com pasta no meio se for "o mesmo projeto" |
| `NOTIF` | novidade, lançamento, venda: notificação caindo |
| `CHAT` | "é só pedir pro Claude": caixa do Claude digitando o pedido |
| `ENTRA` | "X dentro de Y": um ícone voa e entra no outro |
| `DESENHO` | explicação de processo: caixas, setas e notas à mão num papel |
| `CODIGO` | erro e correção em código |
| `CARTAO` | material, lista de passos, oferta |
| `CTA` | "comenta PALAVRA": até o fim do vídeo |

Regras de visual:
- Todo vídeo começa com `HEADLINE`, inteira já no primeiro quadro (vira a capa). Sem headline o vídeo perde o gancho.
- Uma peça por frase, no máximo. Em 40 s: umas 10 peças e 2 telas pretas.
- Peças acima da cabeça (y 290 a 720). Tudo entre x 120 e 960, porque as redes cortam as laterais.
- Toda peça entra no "s" da palavra que ela ilustra.
- Parede laranja: texto branco, nunca laranja em cima dela.
- `ZOOM`: 1.05 a 1.1 no começo de frase forte, e volta pra 1.0 na próxima.
- Logos disponíveis: nomes dos arquivos em `motion/logos` (sem `.svg`).

## 5. Storyboard ANTES do render (obrigatório)
`$PY motion/storyboard.py projetos/<nome> t1,t2,...` com um tempo dentro de cada peça (12 a 16 momentos).
Abra o `storyboard.jpg`, confira (nada cortado, nada em cima do rosto, texto dentro dos quadros) e mostre ao criador
com a tabela do roteiro. Só renderize depois do ok. Ajuste pedido: mude o `edicao.html` e tire as fotos de novo.

## 6. Som (a voz na frente)
Escreva `projetos/<nome>/sons.json` (formato no topo do `motion/som.py`):
- Trilha: `"db": -42`. Se tiver tela preta, a trilha some 0,4 s antes dela e volta na pancada (`silencio` + `sobe`).
- Efeitos: um por peça, no máximo. Ganhos de 0,08 a 0,24. Nomes: fundo, pisao, apoc, soco, whoosh, whoosh2,
  varre, pop, bolha, erro, notif, ganhou, brilho, fada, tique, envio, braam.
- Rode `$PY motion/som.py projetos/<nome>`. A meta é a voz com mediana de 15 dB ou mais acima do resto. Se avisar
  que a voz está brigando, baixe a trilha ou os efeitos e rode de novo.

## 7. Render e entrega
1. `$PY motion/render.py projetos/<nome>` gera `video.mp4` e `final.mp4` (já com o som).
   Leva uns 6 s por segundo de vídeo.
2. Confira 8 quadros do `final.mp4`.
3. Copie pra `meus-videos/<nome>-editado.mp4`. Nunca grave por cima: se já existir, use `-v2`, `-v3`.
4. Diga em português, curto:
   - onde está o vídeo;
   - quanto durou antes e depois;
   - os dB da voz;
   - o que foi escolha sua (texto das peças, frases das telas pretas).
