Communitygithub.com

Pulupulu Motion

Dirige um filme de motion como linha de tempo HTML e GSAP, fotografa-o fotograma a fotograma no Chrome headless e mistura narração e música com ffmpeg.

O que é Pulupulu Motion?

Confirma Node, ffmpeg e a CLI pulupulu, e constrói cenas vetoriais planas, tipo, gráficos e mapas. Recusa uma cara real, lip-sync ou uma ação física contínua, e diz isso.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Alucard0x1/pulupulu-motion/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Pulupulu Motion faz?

Um filme aqui é uma linha do tempo em HTML que o Chrome renderiza frame a frame. Nada é um editor de vídeo: você escreve uma página, o CLI captura a tela em uma taxa de quadros fixa, e o ffmpeg muxa o som.

Este arquivo é o roteador. Ele responde: posso fazer este trabalho, o que executo primeiro, o que precisa passar e qual página tem os detalhes. Carregue uma página de referência apenas para a parte em que você está trabalhando.

1. Antes de prometer algo

python scripts/doctor.py                    # somente leitura: python, node, ffmpeg, o CLI, chave, disco
python scripts/doctor.py --project film/    # também: o contrato da página está presente

Código de saída 1 significa que um filme não pode ser feito nesta máquina. Não descubra isso depois de escrever cenas. Nunca chame npx por comando: uma viagem de ida e volta na rede a cada check, still e render é a desaceleração autoinfligida mais comum neste fluxo de trabalho.

Esta ferramenta é a escolha errada quando a história precisa de filmagem que ela não possui, do rosto ou semelhança de uma pessoa real, anatomia humana ou animal articulada, uma ação física realizada de forma contínua ou sincronia labial. Ela renderiza bem geometria vetorial plana, tipo, gráficos, mapas, ícones e objetos coloridos, e essas outras coisas mal. Diga isso em vez de produzir uma imitação: um substituto desenhado para material de arquivo é um problema de proveniência, não uma escolha de estilo.

2. O fluxo de trabalho, em ordem

Um batida = uma frase = um plano. O tempo vem da fala medida, nunca da invenção.

  1. Briefing. Assunto, público, plataforma, idioma, se há narração. Pergunte por um assunto ausente; não pergunte se deve narrar quando um vídeo foi solicitado.
  2. Storyboard antes do HTML — references/narration-and-captions.md. A legenda são as palavras faladas verbatim, não um resumo delas.
  3. Narrar e medir. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, depois gate para verificar cada frase por ASR. Roteiro, vozes e limites: references/narration/deepseek-tts.md.
  4. Construir a página a partir de timeline.json, não do storyboard. Contrato: references/cli.md. Quando a história precisa de objetos que nenhuma biblioteca de ícones carrega, gere-os primeiro como painéis de impressão — references/generated-assets.md — e monte-os; nunca desenhe à mão um substituto para uma fotografia.
  5. Verificar, depois olhar. pulupulu check ., depois pulupulu still . --at 2,12,24 --out .om/stills e abra os stills. Uma página que passa no check ainda pode renderizar em branco.
  6. Renderizar — pulupulu render . --format mp4 --fps 30. Travamentos, quadros pretos e comprimentos errados: references/render-traps.md.
  7. Mixar e muxar com mapeamento de stream explícito — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 muxa e valida em uma única chamada. Receita manual e a cadeia de ducking: references/workflow.md.
  8. Validar o arquivo que você entregará, não a saída mais recente do renderizador: python scripts/deliver_check.py out/film.mp4 --timeline timeline.json.
  9. Entregar com ressalvas honestas: o que foi desenhado em vez de originado, e o que a nota de QA diz.

3. Portões (Gates)

Apenas estes bloqueiam. Tudo o mais que uma ferramenta imprime é uma nota de leitura: responda com um argumento ou corrija, mas nunca relate como aprovado quando não foi.

portãocomandoo que provase falhar
preflightpython scripts/doctor.pya máquina pode renderizarpare, reporte o que está faltando
composiçãopulupulu check .contrato da página, nenhum arquivo ausentecorrija antes de renderizar
idiomapython scripts/lang-audit.py film/index.html --lang ennenhum texto no outro idioma, incluindo literais de string dentro de <script>traduza o literal, execute novamente
falapython scripts/deepseek_voice.py gate beats.json --voice stellatoda frase é transcrita de volta para suas próprias palavrasreescreva a frase; nunca envie um fragmento
arquivopython scripts/deliver_check.py out/film.mp4 --timeline timeline.json (ou --video/--audio/--out para muxar primeiro)tamanho do quadro, taxa de quadros, áudio presente e longo o suficiente, pico verdadeiro, tamanho de entregaremuxe ou recodifique
popspulupulu qa out/film.mp4sem pops de quadro únicoencontre o elemento de um quadro

pulupulu qa também relata movimento por segundo, still por ≥ 1 s e abertura plana. Esses são julgamentos sobre ritmo, medidos em uma comparação em escala de cinza 96×54, então um movimento lento de baixo contraste pode ser lido como parado. Use-os como motivo para olhar, não como veredito a ser obedecido.

O que nenhum portão prova: que o filme é bom, que o ASR ouviu o número correto (verifique dígitos e substantivos próprios como tokens), ou que uma legenda está onde a interface de uma plataforma não a cobrirá.

4. Armadilhas que custam uma renderização

Detalhes completos e correções em references/render-traps.md. As que param uma renderização completamente:

  • <g>/<rect>/<path> brutos escritos dentro de um <div> não renderizam nada e não avisam nada. Envolva cada fragmento de cena em seu próprio <svg viewBox>.
  • Uma webfont dentro de <text> SVG inline re-rasteriza essa camada a cada quadro. Coloque texto em HTML, ou desenhe-o como formas.
  • feTurbulence como um filtro por quadro — SVG inline ou um fundo CSS — trava o renderizador. Cozinhe o ruído em um tile PNG uma vez.
  • Uma escala GSAP de quadro inteiro em um SVG inline re-rasteriza a placa; translate compõe bem, e uma camada de bitmap pode ser dimensionada. Quando um push é impossível, anime pequenos grupos internos.
  • repeat: -1 torna a linha do tempo infinita: um filme de 87 s silenciosamente se torna 117 s. Compute voltas finitas.
  • Após uma renderização falha, mate apenas o Chrome headless que ela deixou para trás. taskkill //IM chrome.exe fecha o navegador do próprio usuário.

5. Onde os detalhes vivem

trabalhando empágina
comandos, contrato da página, instalaçãoreferences/cli.md
os nove passos, contrato do projeto, muxreferences/workflow.md
storyboard, legendas, portão de idioma únicoreferences/narration-and-captions.md
paleta, orçamento de elementos, personalidade, ritmoreferences/design-taste.md
linguagens de movimento, técnicas, camada 3Dreferences/motion-library.md
punch-up, demonstração de produto, talking head, gramáticasreferences/workflows-specialized.md
mundos musicais, compositor, sfx, síntese de narraçãoreferences/audio-and-music.md, references/narration/deepseek-tts.md
uma renderização em branco, travada ou com comprimento erradoreferences/render-traps.md
o que verificar e em que ordemreferences/verification.md
receitas de estilo, linguagem de câmerareferences/art-motion/INDEX.md
como obter ícones e vetores, licençasreferences/asset-sourcing.md
arte gerada por um modelo de imagem, recorte de impressões, montagemreferences/generated-assets.md
artesanato vetorial plano, mundos de rolagemreferences/2d-vector-motion.md
quais assuntos este renderizador pode carregarreferences/topic-fit.md
tempo e easing em nível de submilissegundoreferences/ui-motion/
publicar esta skill (um commit, v1.0)references/publishing-skills.md, references/publishing.md

A rota de receitas de estilo (scripts/art-motion/engine/) tem 20 MB de runtime vendido que deliberadamente não está neste repositório: uma skill não deve fazer cada agente buscar um motor que talvez nunca use, e uma árvore de 37 MB não pode ser revisada. Ele instala fixado e verificado por checksum, nos caminhos exatos que as páginas acima citam:

python scripts/install_art_motion.py --check                   # está lá?
python scripts/install_art_motion.py                           # núcleo: lib + demos + cenas, 20 MB
python scripts/install_art_motion.py --with-reference-films    # + material de estudo, mais 14 MB

Todo o resto — os portões Python, as especificações de clipe, a documentação — está no repositório e não precisa de instalação. Nunca commit a árvore buscada de volta: .gitignore já a cobre.

6. Scripts

scriptfaz
scripts/doctor.pypreflight, somente leitura
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — narração e sua linha do tempo medida
scripts/deliver_check.pyvalida o arquivo entregue: tamanho, taxa, áudio, pico, duração em relação à linha do tempo
scripts/lang-audit.pyportão de idioma único sobre marcação e literais de script
scripts/art-motion/icon_audit.pyfamílias de ícones, contagem de cores, folha de contato
scripts/art-motion/qa.pyheurísticas de ritmo e pop em um arquivo renderizado
scripts/stamp_credit.pyadiciona a linha por Alucard0x1 a arquivos de texto

7. Trabalhando com uma pessoa

Mostre quadros, não adjetivos. Um quadro herói por ato mata uma semana de trabalho errado. Quando eles te corrigirem, coloque a correção nesta skill em vez de em uma resposta de chat.

Transferências: tempo de narração e prosódia → skill tts-intonation · mesclar ou traduzir outra biblioteca → skill agent-skill-sourcing · direitos e semelhança antes de publicar → skill media-content-safety · obter um vídeo de referência → skill streaming-mirror-extraction · planos 3D ou baseados em filmagem → skills headless-three-video-render e cinetic · filmes prioritariamente tipográficos → skill kinetic-typography.

Habilidades Relacionadas