Motion graphics editorial (Remotion)
Transforma a história de um experimento, teste ou ideia em um vídeo de 15 a 30 segundos com foco em números e texto. A aparência é fixa e cuidada: título serifado elegante + palavra em itálico realçada (azul celeste), etiquetas em CAIXA ALTA mono espaçadas, números grotescos em negrito; moldura fina contínua (marca no canto superior esquerdo, "01 — CAPÍTULO" no canto superior direito, progresso dividido + tempo na parte inferior), grade sutil no fundo, vinheta, granulação fina. Você escreve a história em JSON, a imagem é gerada a partir dele.
Se precisar de desenho, personagens ou cenas feitas à mão, não é este o skill, use o skill animacao (PIL nanquim).
Exemplo: exemplos/x-animacao/exemplo.json ("Fiz o mesmo trabalho com três configurações diferentes"; números fictícios, na tela aparece "dados de exemplo").
Instalação (uma vez)
cd remotion && npm install # Node 18+; a pasta fontes/ é copiada para public/fonts automaticamente
A primeira renderização baixa o Chrome Headless Shell (~100 MB). Lado Python: numpy, Pillow, ffmpeg.
Use .venv/bin/python para comandos Python (Windows: .venv\Scripts\python).
Ciclo
1. Entenda a história
Qual é a afirmação em uma frase? Quais números existem e de onde vêm? Plataforma e proporção (X: 16:9, Reels/Shorts: 9:16, ou ambos), duração (X: 15-30 s). Se não houver números, não invente: ou peça ao usuário o número medido ou use cenas sem números (título, lista, pergunta).
2. Escreva a lista de cenas: trabalho/x-animacao/<nome>.json
Copie do exemplo. Regras:
- Cada cena = uma ideia, 3-7 palavras por linha, português natural e simples. Em vez de frase longa, use duas linhas.
*palavra*= destaque (itálico + azul na serifa). No máximo um destaque por cena.- Números só podem ser medidos. Se estiver usando números não medidos/exemplo, mantenha
"etiqueta": "dados de exemplo"no nível superior e avise o usuário. - Use o formato local adequado, ex.:
"prefixo": "R$"→R$ 80. Para dinheiro e duração, forneça texto pronto:"$0,61","5 min 12 s". capituloabre um novo capítulo (etiqueta no canto superior direito + parte da barra de progresso); 3-5 capítulos são suficientes.- Use emblemas de status como "aguardando", "em breve" e anotações para você mesmo; todo texto na tela é para o espectador.
tipo | Campos | Para que | Duração sugerida |
|---|---|---|---|
titulo | superior?, linhas | gancho: primeiros 2-3 s | 2,4-3 |
texto | linhas?, superior?, texto (≤160) | prompt/comando é digitado letra por letra, com som de teclado | 0,55 + letra × 0,09 + 0,9 |
contador | superior?, valor, inicio?, decimais?, prefixo?, sufixo?, inferior? | um único número grande que conta | 3 |
medidor | linhas, niveis[2-6] (nome, etiqueta?) | nível conceitual: preenche do baixo ao alto em ordem | 3-4 |
colunas | linhas, itens[2-6] (nome, valor, etiqueta?), prefixo/sufixo/decimais?, nota? | resultados medidos, etiqueta de ordem automática | 4-4,5 |
comparacao | linhas (uma linha), a, b (nome, superior?, valor, etiquetaInferior?, inferior?), diferenca? (valor, etiqueta?, inferior?) | A vs B: custo, duração | 4-5 |
lista | linhas, itens[2-5] | conclusão, regra, passo | 1,6 + 0,5 × item |
pergunta | linhas, inferior? | pergunta de encerramento / chamada para ação | 3 |
Em cada cena, duracao (s) é obrigatório, capitulo é opcional. Nível superior: marca (nome no canto superior esquerdo),
etiqueta?, tema?, cenas. Esquema: remotion/src/x/esquema.ts.
3. Rascunho (visualização rápida)
.venv/bin/python .claude/skills/x-animacao/ferramentas/gerar.py trabalho/x-animacao/<nome>.json --proporcao ambos --rascunho
Renderização em meia resolução, sem áudio + página de contato (<nome>-<proporcao>-rascunho-sem-som-pagina.jpg). ABRA a página e verifique: linha estourada, elemento sobreposto, etiqueta ilegível, grande área vazia. Corrija e gere outro rascunho. Para edição ao vivo: cd remotion && npx remotion studio.
4. Renderização + áudio
.venv/bin/python .claude/skills/x-animacao/ferramentas/gerar.py trabalho/x-animacao/<nome>.json --proporcao ambos
Saídas em trabalho/x-animacao/: <nome>-16x9.mp4 (1920×1080, 60 fps) e <nome>-9x16.mp4
(1080×1920, 30 fps), com áudio. Nível de áudio padrão: -26 LUFS: significativamente abaixo da
fala (-14..-16), para não abafar se houver narração ou locução. Se for enviar sozinho, use --lufs -18; se quiser sem música, use --sem-musica.
Passo a passo (mesma coisa):
cd remotion && npx remotion render XAnimacao16x9 ../trabalho/x-animacao/<nome>-16x9-sem-som.mp4 \
--props=../trabalho/x-animacao/<nome>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animacao/ferramentas/audio.py trabalho/x-animacao/<nome>.json \
--video trabalho/x-animacao/<nome>-16x9-sem-som.mp4 --saida trabalho/x-animacao/<nome>-16x9.mp4
5. Meça — você não pode assistir, não pode ouvir
Ao final, gerar.py executa medir.py (manual: medir.py <mp4> --json <json>):
- número de quadros e duração coincidem com o esperado pelo JSON? áudio e vídeo têm o mesmo tamanho?
- página de contato: dois quadros de cada cena (meio e imediatamente antes da saída) — ABRA e veja obrigatoriamente;
- LUFS integrado e pico verdadeiro; a quantos dB o whoosh está acima do leito em cada corte (aviso se abaixo de 2 dB). Em cortes imediatamente após uma cena de digitação, a diferença será pequena: há som de tecla na janela anterior, normal.
Deixe claro ao usuário o que você não pode medir (a música é agradável? o ritmo está correto?).
6. Entrega
Caminhos dos arquivos, duração, tempo de renderização e resumo das medições. Se dados de exemplo foram usados, informe novamente.
Personalizar a aparência
- Cor: no JSON,
"tema": {"destaque": "#38bdf8", "fundo": "#111113", "texto": "#ece7df", "suave": "#8b8883", "serie": [...]}. Mantenha uma única cor de destaque;seriesão as cores do medidor/colunas. Padrões emremotion/src/x/componentes.tsx. - Marca:
"marca"é o nome no canto superior esquerdo (nome do canal ou da série). - Fonte: apenas fontes de distribuição livre (como OFL). Coloque o TTF e o texto da licença na pasta
fontes/, adicione à lista emremotion/scripts/copiar-fontes.mjse aFACESemremotion/src/x/fontes.ts, executenpm run fontes. Fontes do sistema (fontes do macOS/Windows) não são colocadas no repositório nem distribuídas. - Layout: duas orientações em
usarLayout()(componentes.tsx). Na vertical, o conteúdo fica entre y 300-1320: a interface do Reels/Shorts cobre ~190 px no topo, ~520 px na parte inferior e o canto inferior direito. - Novo tipo de cena: adicione o esquema em
esquema.ts, o componente emcenas.tsx, o ramo emDesenharCena, e o nome emTIPOSnogerar.py. Se precisar de um som interno como teclado, calcule seu tempo comtempo.tse emferramentas/comum.pyusando a MESMA fórmula.
Armadilhas (medidas)
- Tempo é a única fonte:
remotion/src/x/tempo.tseferramentas/comum.pyfazem o mesmo cálculo (arredondamento de quadros, ritmo de digitação). Se alterar um e esquecer o outro, o whoosh vai se deslocar do corte, o som da tecla da letra. - Sem underlines no ID da composição; passe o caminho do arquivo para
--props, não incorpore o JSON. - Fontes são carregadas com a API FontFace;
document.fonts.readynão é aguardado (observado que em renderizações longas nunca é resolvido em uma aba). Se a fonte não carregar, a renderização para com erro, não cai silenciosamente em uma fonte substituta. - Granulação não é calculada com SVG
feTurbulenceem cada quadro (trava a renderização): um tile de ruído gerado uma vez é deslocado. - Maiúsculas do português são feitas com CSS (
lang="pt"+text-transform): Ç/Ã/É/Í/Ó/Ú funcionam corretamente. Não usetoUpperCase()em JS. - Não coloque animação de escala (zoom/pop) no texto: treme. Entrada = elevador de máscara + opacidade.
- Se a renderização longa de 60 fps travar, divida em partes como
--frames=0-899e una com ffmpeg concat. - Tempo de renderização medido (M1 Pro, 16 GB, simultaneidade padrão): exemplo de 27,4 s 16:9@60 ~67 s, 9:16@30 ~40 s; rascunho (meia resolução) 33 / 18 s.
Nota de licença: Remotion
O Remotion não é licenciado sob MIT. É gratuito para indivíduos e pequenas empresas; empresas acima de um determinado porte precisam adquirir uma licença paga. Antes de usar, verifique os termos atuais: https://www.remotion.dev/license — o código neste repositório é MIT, o próprio Remotion está sujeito à sua própria licença.