Communitygithub.com

santanna-motion

Cria motion graphics com fundo transparente para o Premiere a partir de um áudio de narração (reels/stories 9:16 de qualquer marca), animado em código Node (canvas + ffmpeg), sem After Effects. Transcreve o áudio com Whisper local, planeja cena a cena, envia prints para aprovação e renderiza MOV com alpha + versão leve cor/máscara. Use quando pedirem "motion", "grafismo animado", "animação para o Premiere", "motion em fundo transparente" ou "motion de acordo com o áudio/narração".

santanna-motion 是什麼?

santanna-motion is a Claude Code agent skill that cria motion graphics com fundo transparente para o Premiere a partir de um áudio de narração (reels/stories 9:16 de qualquer marca), animado em código Node (canvas + ffmpeg), sem After Effects. Transcreve o áudio com Whisper local, planeja cena a cena, envia prints para aprovação e renderiza MOV com alpha + versão leve cor/máscara. Use quando pedirem "motion", "grafismo animado", "animação para o Premiere", "motion em fundo transparente" ou "motion de acordo com o áudio/narração".

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kirasantanna/santanna-motion/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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)

  1. 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) ou brands/<marca>/brand.json nesta skill. Se não existir, crie a partir de brands/_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.
  2. 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.
  3. 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: … ou C6 refazer: … (ou tudo 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.
  4. Etapa 2: prints para aprovação.

    • Crie motion.js na pasta do projeto (copie a estrutura de examples/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.
  5. 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.json e afins em _fonte_motion/ dentro da pasta de entrega.
    • Explique o uso no Premiere (references/premiere.md) e onde fica cada corte/inserção.

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; fitSize e wordLine já respeitam).
    • Pílula, caixa ou selo, incluindo linhas de impacto em volta: até cerca de 760 px (E.MAX_BOX_W; highlightText respeita).
    • 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.
  • 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 (shadow no 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çãoUso
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, fitSizemedir 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, sparkleformas
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-small com return_timestamps:'word' dá erro "cross attentions". Use whisper-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á no setup.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_complex e lavfi color como fundo gerou quadro vazio. É mais confiável extrair PNGs e compor no canvas.

相關技能