santanna-motion は何をしますか?
Gera motion graphics sincronizados com a narração, em fundo transparente, para aplicar no Premiere. Tudo roda localmente em Node: @napi-rs/canvas desenha cada quadro e ffmpeg-static codifica. Não use After Effects nem ExtendScript (veja "O que não funcionou").
Fluxo obrigatório (com aprovação em 3 etapas)
-
Coletar insumos
- Áudio final da narração. Se existir uma versão "reduzida" (sem trechos que já têm motion), use essa e confirme qual é.
- Formato e fps do projeto: leia um vídeo de teste da pasta do projeto com
ffmpeg -i(reels costumam ser 1080×1920 a 23,976 ou 30 fps). - Marca: procure
private/brands/<marca>/brand.json(clientes, fora do Git) oubrands/<marca>/brand.jsonnesta skill. Se não existir, crie a partir debrands/_template/usando a pasta de marca do cliente (logo SVG, fontes instaladas, peças publicadas). Detalhes em references/marcas.md. - Motions já feitos para o mesmo vídeo, para manter o estilo e não duplicar trechos.
-
Transcrever com tempo por palavra (local, sem enviar o áudio para fora):
node "$env:USERPROFILE\.claude\skills\santanna-motion\scripts\transcribe.mjs" "<audio.mp3>" "<pasta>\words.json"- Na primeira vez rode
scripts/setup.ps1(instala e libera os binários). - O Whisper pode errar nomes próprios (ex.: o nome da marca virando uma palavra comum, "Prints" → "Printes"); corrija pelo roteiro ou pelo áudio original.
- Se a narração foi gerada no Magnific (
audio_timing_get), compare a duração: o áudio editado pode ter outro tempo. Sempre use os tempos do áudio final.
- Na primeira vez rode
-
Etapa 1: planejamento. Envie ao usuário:
- A transcrição em tabela (tempo → fala), marcando pontos de corte/inserção.
- Base técnica (resolução, fps, cores, fontes, posição na tela).
- Uma seção por cena C1, C2… com grafismo + animação sincronizada às palavras-chave.
- O formato de resposta: uma linha por cena,
C1 ok,C3 ajustar: …ouC6 refazer: …(outudo ok). - Se o usuário aprovar só parte das cenas, pergunte o que fazer com as outras antes de seguir.
- Padrões de cena que funcionaram estão em references/padroes-de-cena.md.
-
Etapa 2: prints para aprovação.
- Crie
motion.jsna pasta do projeto (copie a estrutura deexamples/demo-dica-rapida/motion.js). - Gere um quadro "herói" de cada cena (todos os elementos já na tela) e monte a prancha:
node motion.js preview 2.9,3.9,6.42,7.6 "<pasta>\Prints para aprovacao" node "<skill>\scripts\sheet.js" "<pasta>\Prints para aprovacao" "<pasta>\Prints para aprovacao\Prancha.png" "C1|2.9|Legenda;C2|3.9|Legenda" - Olhe a prancha antes de enviar (Read na imagem) e corrija o que estiver colado nas bordas, sobreposto ou sobrando.
- Envie com SendUserFile e peça a aprovação no mesmo formato C1…Cn. Repita só com as cenas ajustadas.
- Crie
-
Etapa 3: render final (só depois do "tudo ok"):
node motion.js render- O render gera 3 arquivos em
outDir:<nome>_ALPHA.mov: codec PNG com alpha; vai direto na timeline. Fica na faixa de 40 a 50 MB para 20 s, porque as sombras suaves pesam.<nome>_COR.mp4+<nome>_MASCARA.mp4: versão leve (cerca de 5 MB), para usar com Track Matte Key.
- Verifique a versão leve: extraia um quadro de cada arquivo, junte cor + máscara e compare com o MOV.
- Guarde
motion.js,words.jsone afins em_fonte_motion/dentro da pasta de entrega. - Explique o uso no Premiere (references/premiere.md) e onde fica cada corte/inserção.
- O render gera 3 arquivos em
Regras de design aprendidas (feedback real de cliente)
- Nada perto das bordas (em 1080 de largura):
- Texto solto: até cerca de 940 px (
E.MAX_TEXT_W;fitSizeewordLinejá respeitam). - Pílula, caixa ou selo, incluindo linhas de impacto em volta: até cerca de 760 px (
E.MAX_BOX_W;highlightTextrespeita). - Reprovados pelo cliente: título com cerca de 1040 px, pílula CALMA! com linhas chegando a cerca de 1000 px, pílula TRANQUILIDADE! com cerca de 870 px.
- Texto solto: até cerca de 940 px (
- Conteúdo no terço central (y ≈ 600–1520), respeitando a interface do Reels: topo 220 px, rodapé ~400 px, coluna direita de ícones.
- Um elemento principal por cena; o texto reforça a palavra-chave da fala, não transcreve tudo.
- Não repetir o logo em cenas seguidas. No exemplo, o cliente tirou o logo do selo "Dica Rápida" e deixou só no fechamento. Sem numeração de episódio no selo se não pedirem.
- Selos e chamadas centralizados na tela (x=540, y≈960) quando estão sozinhos.
- Entradas com overshoot (
pop), saídas rápidas com ease-in (0,15–0,25 s), sincronizadas à palavra (entra ~0,05 s antes dela). - Sombra suave da cor escura da marca em tudo (
shadowno brand.json) para ler sobre qualquer fundo.
Motor (scripts/engine.js): resumo da API
const E = require('<skill>/scripts/engine.js'); E.loadBrand('<skill>/brands/<marca>/brand.json');
| Função | Uso |
|---|---|
kf(t, [[t0,v0],[t1,v1,'o'],…]) | keyframes; ease do segmento: o desacelera, i acelera, io suave, l linear, h segura |
pop(t0, pico, final) / fade(t0, d) / shake(t0, base, amp) | listas de keys prontas |
text(ctx, str, x, y, size, E.FONT.black, cor, 'center', tracking) | texto centrado pelas maiúsculas; tracking em 1/1000 em |
textW, fitSize | medir texto e reduzir até caber em MAX_TEXT_W |
wordLine(ctx, t, palavras, tempos, size, fonte, cor, y) | linha palavra a palavra no ritmo da fala |
highlightText(ctx, t, str, y, size, fonte, tBarra, tTexto, corBarra, corTexto, {pill, barH, pad}) | marca-texto/pílula atrás da palavra |
tagBar(...) | faixa escura com texto espaçado + linha de destaque |
rrc, circ, poly, roundPoly, check, cross, sparkle | formas |
T(ctx, x, y, rot, sx, sy) / group(ctx, alpha, fn) | transformar / opacidade de grupo |
drawLogo(ctx, t, x, y, largura, t0) | logo do brand.json; t0 anima peça a peça |
E.run({dur, name, outDir, scenes:[[fn, tIn, tOut]]}) | CLI preview / render |
Cada cena é function Cn(ctx, t) {…} em tempo global do áudio. Desenhe com o centro do elemento na origem (T + desenho em 0,0) para escalar e girar em torno do centro.
O que não funcionou (não repetir)
- After Effects via script (
AfterFX.exe -r script.jsx): em pelo menos uma instalação testada o AE abre e fecha em seguida sem rodar nada. Além disso, salvar arquivos por script exige liberar a preferência "Allow Scripts to Write Files". Não use esse caminho. onnx-community/whisper-smallcomreturn_timestamps:'word'dá erro "cross attentions". Usewhisper-small_timestamped.- O npm novo bloqueia scripts de instalação. Sem
npm approve-scripts ffmpeg-static onnxruntime-node, o ffmpeg e o ONNX não baixam. Isso já está nosetup.ps1. - O MOV com codec PNG não fica menor que o ProRes quando há sombra suave. Para arquivo pequeno, entregue também o par cor + máscara.
- No PowerShell, caminhos com
[](ex.:[Reel] Dica…) precisam de-LiteralPath. - Verificar compondo com
ffmpeg -filter_complexelavfi colorcomo fundo gerou quadro vazio. É mais confiável extrair PNGs e compor no canvas.