Communitygithub.com

Pulupulu Motion

Dirige un film de motion como línea de tiempo HTML y GSAP, lo captura fotograma a fotograma en Chrome headless y mezcla narración y música con ffmpeg.

¿Qué es Pulupulu Motion?

Comprueba Node, ffmpeg y la CLI pulupulu, y construye escenas vectoriales planas, tipo, gráficos y mapas. Rechaza una cara real, el lip-sync o una acción física continua.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Pulupulu Motion?

Una película aquí es una línea de tiempo en HTML que Chrome renderiza fotograma a fotograma. Nada es un editor de video: tú escribes una página, la CLI la captura a una frecuencia de fotogramas fija, ffmpeg multiplexa el sonido.

Este archivo es el enrutador. Responde: ¿puedo hacer este trabajo?, ¿qué ejecuto primero?, ¿qué tiene que pasar? y qué página tiene el detalle. Carga una página de referencia solo para la parte en la que estás trabajando.

1. Antes de prometer nada

python scripts/doctor.py                    # solo lectura: python, node, ffmpeg, la CLI, clave, disco
python scripts/doctor.py --project film/    # también: el contrato de la página está presente

Salida 1 significa que no se puede hacer una película en esta máquina. No lo descubras después de escribir escenas. Nunca llames npx por comando: un viaje de ida y vuelta de red en cada check, still y render es la ralentización autoinfligida más común en este flujo de trabajo.

Esta herramienta es la elección incorrecta cuando la historia necesita material de archivo que no tiene, el rostro o la apariencia de una persona real, anatomía humana o animal articulada, una acción física realizada de forma continua o sincronía de labios. Renderiza geometría vectorial plana, texto, gráficos, mapas, iconos y objetos codificados por colores bien, y esas otras cosas mal. Dilo en lugar de producir un sustituto: un dibujo sustituto para material de archivo es un problema de procedencia, no una elección de estilo.

2. El flujo de trabajo, en orden

Un latido = una oración = una toma. El tiempo proviene del habla medida, nunca de la invención.

  1. Brief. Tema, audiencia, plataforma, idioma, si hay narración. Pregunta por un tema faltante; no preguntes si narrar cuando se solicitó un video.
  2. Storyboard antes que HTML — references/narration-and-captions.md. El subtítulo son las palabras habladas literales, no un resumen de ellas.
  3. Narrar y medir. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, luego gate para verificar cada frase con ASR. Ruta, voces y límites: references/narration/deepseek-tts.md.
  4. Construir la página desde timeline.json, no desde el storyboard. Contrato: references/cli.md. Cuando la historia necesite objetos que ninguna biblioteca de iconos tenga, genéralos primero como paneles de impresión — references/generated-assets.md — y ensámblalos; nunca dibujes a mano un sustituto para una fotografía.
  5. Verificar, luego mirar. pulupulu check ., luego pulupulu still . --at 2,12,24 --out .om/stills y abre las imágenes fijas. Una página que pasa check aún puede renderizar en blanco.
  6. Renderizar — pulupulu render . --format mp4 --fps 30. Bloqueos, fotogramas negros y duraciones incorrectas: references/render-traps.md.
  7. Mezclar y multiplexar con mapeo de flujo explícito — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 multiplexa y valida en una sola llamada. Receta manual y la cadena de reducción de volumen: references/workflow.md.
  8. Validar el archivo que entregarás, no la salida más reciente del renderizador: python scripts/deliver_check.py out/film.mp4 --timeline timeline.json.
  9. Entregar con advertencias honestas: qué está dibujado en lugar de lo obtenido, y qué dice la nota de QA.

3. Puertas de verificación

Solo estas bloquean. Todo lo demás que imprima una herramienta es una nota de lectura: respóndela con un argumento o arréglalo, pero nunca lo reportes como aprobado cuando no lo estaba.

puertacomandoqué pruebasi falla
preflightpython scripts/doctor.pyla máquina puede renderizardetente, reporta qué falta
composiciónpulupulu check .contrato de página, ningún archivo faltantearregla antes de renderizar
idiomapython scripts/lang-audit.py film/index.html --lang enningún texto en el otro idioma, incluyendo literales de cadena dentro de <script>traduce el literal, vuelve a ejecutar
hablapython scripts/deepseek_voice.py gate beats.json --voice stellacada frase se transcribe de vuelta a sus propias palabrasreescribe la frase; nunca envíes un fragmento
archivopython scripts/deliver_check.py out/film.mp4 --timeline timeline.json (o --video/--audio/--out para multiplexar primero)tamaño de fotograma, frecuencia de fotogramas, audio presente y suficientemente largo, pico verdadero, tamaño de entregare-multiplexa o re-codifica
popspulupulu qa out/film.mp4sin pops de un solo fotogramaencuentra el elemento de un fotograma

pulupulu qa también reporta movimiento por segundo, still por ≥ 1 s y apertura plana. Esos son juicios sobre el ritmo, medidos en una comparación en escala de grises de 96×54, por lo que un movimiento lento de bajo contraste puede leerse como estático. Úsalos como una razón para mirar, no como un veredicto que obedecer.

Lo que ninguna puerta prueba: que la película es buena, que el ASR escuchó el número correcto (verifica dígitos y sustantivos propios como tokens), o que un subtítulo se encuentra donde la interfaz de usuario de una plataforma no lo cubrirá.

4. Trampas que cuestan un renderizado

Detalle completo y correcciones en references/render-traps.md. Las que detienen un renderizado en seco:

  • Escribir <g>/<rect>/<path> en bruto dentro de un <div> no renderiza nada y no advierte nada. Envuelve cada fragmento de escena en su propio <svg viewBox>.
  • Una fuente web dentro de <text> SVG en línea re-rasteriza esa capa cada fotograma. Pon el texto en HTML, o dibújalo como formas.
  • feTurbulence como filtro por fotograma — SVG en línea o un fondo CSS — paraliza el renderizador. Hornea el ruido en un mosaico PNG una vez.
  • Una escala de GSAP a fotograma completo en un SVG en línea re-rasteriza la placa; la composición con translate funciona bien, y una capa de mapa de bits se puede escalar. Cuando un push sea imposible, anima pequeños grupos internos.
  • repeat: -1 hace que la línea de tiempo sea infinita: una película de 87 s silenciosamente se convierte en 117 s. Calcula vueltas finitas.
  • Después de un renderizado fallido, mata solo el Chrome sin cabeza que dejó. taskkill //IM chrome.exe cierra el propio navegador del usuario.

5. Dónde vive el detalle

trabajando enpágina
comandos, contrato de página, instalaciónreferences/cli.md
los nueve pasos, contrato del proyecto, multiplexaciónreferences/workflow.md
storyboard, subtítulos, puerta de un solo idiomareferences/narration-and-captions.md
paleta, presupuesto de elementos, personalidad, ritmoreferences/design-taste.md
lenguajes de movimiento, técnicas, capa 3Dreferences/motion-library.md
mejora, demo de producto, cabeza parlante, gramáticasreferences/workflows-specialized.md
mundos musicales, compositor, efectos de sonido, síntesis de narraciónreferences/audio-and-music.md, references/narration/deepseek-tts.md
un renderizado en blanco, bloqueado o de duración incorrectareferences/render-traps.md
qué verificar, y en qué ordenreferences/verification.md
recetas de estilo, lenguaje de cámarareferences/art-motion/INDEX.md
obtención de iconos y vectores, licenciasreferences/asset-sourcing.md
arte generado por un modelo de imagen, recorte de impresiones, montajereferences/generated-assets.md
arte vectorial plano, mundos de desplazamientoreferences/2d-vector-motion.md
qué temas puede manejar este renderizadorreferences/topic-fit.md
sincronización y easing a nivel de subsegundoreferences/ui-motion/
publicación de esta habilidad (un commit, v1.0)references/publishing-skills.md, references/publishing.md

La ruta de receta de estilo (scripts/art-motion/engine/) es un tiempo de ejecución de 20 MB que deliberadamente no está en este repositorio: una habilidad no debería hacer que cada agente descargue un motor que quizás nunca use, y un árbol de 37 MB no puede ser revisado. Se instala fijado y verificado por suma de comprobación, en las rutas exactas que citan las páginas anteriores:

python scripts/install_art_motion.py --check                   # ¿está ahí?
python scripts/install_art_motion.py                           # núcleo: lib + demos + escenas, 20 MB
python scripts/install_art_motion.py --with-reference-films    # + material de estudio, 14 MB más

Todo lo demás — las puertas de verificación en Python, las especificaciones de clip, la documentación — está en el repositorio y no necesita instalación. Nunca hagas commit del árbol descargado: .gitignore ya lo cubre.

6. Scripts

scripthace
scripts/doctor.pypreflight, solo lectura
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — narración y su línea de tiempo medida
scripts/deliver_check.pyvalida el archivo entregado: tamaño, tasa, audio, pico, duración contra la línea de tiempo
scripts/lang-audit.pypuerta de un solo idioma sobre el marcado y los literales de script
scripts/art-motion/icon_audit.pyfamilias de iconos, conteo de colores, hoja de contactos
scripts/art-motion/qa.pyheurísticas de ritmo y pops en un archivo renderizado
scripts/stamp_credit.pyañade la línea by Alucard0x1 a los archivos de texto

7. Trabajar con una persona

Muestra fotogramas, no adjetivos. Un fotograma heroico por acto mata una semana de trabajo equivocado. Cuando te corrijan, pon la corrección en esta habilidad en lugar de en una respuesta de chat.

Traspasos: sincronización y prosodia de la narración → habilidad tts-intonation · fusionar o traducir otra biblioteca → habilidad agent-skill-sourcing · derechos e imagen antes de publicar → habilidad media-content-safety · obtención de un video de referencia → habilidad streaming-mirror-extraction · tomas 3D o basadas en material de archivo → habilidades headless-three-video-render y cinetic · películas basadas en texto → habilidad kinetic-typography.

Skills relacionados