Communitygithub.com

Pulupulu Motion

Réalise un film motion en timeline HTML et GSAP, le capture image par image dans Chrome headless, et mélange voix et musique avec ffmpeg.

Qu'est-ce que Pulupulu Motion ?

Vérifie Node, ffmpeg et la CLI pulupulu, puis construit des scènes vectorielles plates, du texte, des graphiques et des cartes. Refuse un vrai visage, le lip-sync ou une action physique continue.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Pulupulu Motion ?

Un film est ici une timeline en HTML que Chrome rend image par image. Rien n'est un éditeur vidéo : vous écrivez une page, la CLI la capture à une fréquence d'images fixe, ffmpeg muxe le son.

Ce fichier est le routeur. Il répond : puis-je faire ce travail, que dois-je exécuter en premier, qu'est-ce qui doit passer, et quelle page contient le détail. Chargez une page de référence uniquement pour la partie sur laquelle vous travaillez.

1. Avant de promettre quoi que ce soit

python scripts/doctor.py                    # lecture seule : python, node, ffmpeg, la CLI, la clé, le disque
python scripts/doctor.py --project film/    # vérifie aussi : le contrat de page est présent

Une sortie 1 signifie qu'un film ne peut pas être fabriqué sur cette machine. Ne le découvrez pas après avoir écrit des scènes. N'appelez jamais npx par commande : un aller-retour réseau à chaque check, still et render est le ralentissement auto-infligé le plus courant dans ce workflow.

Cet outil est le mauvais choix lorsque l'histoire nécessite des séquences qu'il ne possède pas, le visage ou l'effigie d'une personne réelle, une anatomie humaine ou animale articulée, une action physique réalisée en continu, ou un lip-sync. Il rend bien les géométries vectorielles plates, le texte, les diagrammes, les cartes, les icônes et les objets codés par couleur, et mal ces autres choses. Dites-le plutôt que de produire un simulacre : un dessin de substitution pour un document d'archive est un problème de provenance, pas un choix de style.

2. Le workflow, dans l'ordre

Un battement = une phrase = un plan. Le rythme vient de la parole mesurée, jamais de l'invention.

  1. Brief. Sujet, public, plateforme, langue, présence ou non d'une narration. Demandez un sujet manquant ; ne demandez pas s'il faut narrer quand une vidéo a été demandée.
  2. Storyboard avant le HTML — references/narration-and-captions.md. La légende est le texte parlé mot à mot, pas un résumé.
  3. Narrer et mesurer. python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, puis gate pour vérifier chaque phrase par ASR. Routage, voix et limites : references/narration/deepseek-tts.md.
  4. Construire la page à partir de timeline.json, pas du storyboard. Contrat : references/cli.md. Quand l'histoire nécessite des objets qu'aucune bibliothèque d'icônes ne propose, générez-les d'abord en tant que panneaux d'impression — references/generated-assets.md — et assemblez-les ; ne dessinez jamais à la main un substitut pour une photographie.
  5. Vérifier, puis regarder. pulupulu check ., puis pulupulu still . --at 2,12,24 --out .om/stills et ouvrez les images. Une page qui passe check peut toujours rendre du noir.
  6. Rendu — pulupulu render . --format mp4 --fps 30. Blocages, images noires et longueurs erronées : references/render-traps.md.
  7. Mixer et muxer avec un mappage de flux explicite — scripts/deliver_check.py --video out/film-vN.mp4 --audio assets/mix.wav --out out/final.mp4 muxe et valide en un seul appel. Recette manuelle et chaîne de ducking : references/workflow.md.
  8. Validez le fichier que vous allez livrer, pas le dernier résultat du moteur de rendu : python scripts/deliver_check.py out/film.mp4 --timeline timeline.json.
  9. Livrer avec des réserves honnêtes : ce qui est dessiné plutôt que sourcé, et ce que dit la note QA.

3. Points de contrôle

Seuls ceux-ci bloquent. Tout ce qu'un outil imprime est une note de lecture : répondez-y avec un argument ou corrigez-le, mais ne le signalez jamais comme réussi quand il ne l'était pas.

pointcommandece qu'il prouveen cas d'échec
prévolpython scripts/doctor.pyla machine peut rendrestop, signaler ce qui manque
compositionpulupulu check .contrat de page, aucun fichier manquantcorriger avant le rendu
languepython scripts/lang-audit.py film/index.html --lang enpas de texte dans l'autre langue, y compris les littéraux de chaîne dans <script>traduire le littéral, relancer
parolepython scripts/deepseek_voice.py gate beats.json --voice stellachaque phrase se retranscrit par ses propres motsréécrire la phrase ; ne jamais livrer un fragment
fichierpython scripts/deliver_check.py out/film.mp4 --timeline timeline.json (ou --video/--audio/--out pour muxer d'abord)taille d'image, fréquence d'images, audio présent et assez long, pic vrai, taille de livraisonre-muxer ou re-encoder
popspulupulu qa out/film.mp4pas de pop sur une frametrouver l'élément d'une frame

pulupulu qa rapporte aussi le mouvement par seconde, immobile pendant ≥ 1 s et ouverture plate. Ce sont des jugements sur le rythme, mesurés sur une comparaison en niveaux de gris 96×54, donc un mouvement lent à faible contraste peut être lu comme immobile. Utilisez-les comme une raison de regarder, pas comme un verdict à respecter.

Ce qu'aucun point de contrôle ne prouve : que le film est bon, que l'ASR a entendu le bon nombre (vérifiez les chiffres et les noms propres en tant que jetons), ou qu'une légende se trouve là où l'interface d'une plateforme ne la couvrira pas.

4. Pièges qui coûtent un rendu

Détail complet et correctifs dans references/render-traps.md. Ceux qui bloquent un rendu net :

  • Un <g>/<rect>/<path> brut écrit dans un <div> ne rend rien et n'avertit de rien. Enveloppez chaque fragment de scène dans son propre <svg viewBox>.
  • Une police web dans un <text> SVG en ligne ré-rasterise cette couche à chaque frame. Mettez le texte en HTML, ou dessinez-le sous forme de formes.
  • feTurbulence en tant que filtre par frame — SVG en ligne ou fond CSS — bloque le rendu. Cuisez le bruit dans une tuile PNG une fois.
  • Un scale GSAP plein écran sur un SVG en ligne ré-rasterise le plan ; translate compose bien, et une couche bitmap peut être mise à l'échelle. Quand un push est impossible, animez de petits groupes internes.
  • repeat: -1 rend la timeline infinie : un film de 87 s devient silencieusement 117 s. Calculez des tours finis.
  • Après un rendu échoué, tuez uniquement le headless Chrome qu'il a laissé derrière lui. taskkill //IM chrome.exe ferme le navigateur de l'utilisateur.

5. Où vit le détail

vous travaillez surpage
commandes, contrat de page, installationreferences/cli.md
les neuf étapes, contrat de projet, muxreferences/workflow.md
storyboard, légendes, point de contrôle unilinguereferences/narration-and-captions.md
palette, budget d'éléments, personnalité, rythmereferences/design-taste.md
langages de mouvement, techniques, couche 3Dreferences/motion-library.md
punch-up, démo produit, tête parlante, grammairesreferences/workflows-specialized.md
univers musicaux, compositeur, effetti sonori, synthèse de narrationreferences/audio-and-music.md, references/narration/deepseek-tts.md
un rendu vierge, bloqué ou de longueur erronéereferences/render-traps.md
quoi vérifier, et dans quel ordrereferences/verification.md
recettes de style, langage de camérareferences/art-motion/INDEX.md
sourcing d'icônes et vecteurs, licencesreferences/asset-sourcing.md
art généré par un modèle d'image, recadrage d'impressions, montagereferences/generated-assets.md
artisanat vectoriel plat, mondes défilantsreferences/2d-vector-motion.md
quels sujets ce moteur de rendu peut traiterreferences/topic-fit.md
timing et easing au niveau sous-secondereferences/ui-motion/
publication de cette compétence (un commit, v1.0)references/publishing-skills.md, references/publishing.md

Le chemin des recettes de style (scripts/art-motion/engine/) est un runtime vendu de 20 Mo qui est délibérément absent de ce dépôt : une compétence ne devrait pas forcer chaque agent à télécharger un moteur qu'il n'utilisera peut-être jamais, et un arbre de 37 Mo ne peut pas être revu. Il s'installe épinglé et vérifié par somme de contrôle, exactement sur les chemins que les pages ci-dessus citent :

python scripts/install_art_motion.py --check                   # est-il là ?
python scripts/install_art_motion.py                           # cœur : lib + démos + scènes, 20 Mo
python scripts/install_art_motion.py --with-reference-films    # + matériel d'étude, 14 Mo supplémentaires

Tout le reste — les points de contrôle Python, les spécifications de plans, la documentation — se trouve dans le dépôt et ne nécessite aucune installation. Ne jamais committer l'arbre téléchargé : .gitignore le couvre déjà.

6. Scripts

scriptfait
scripts/doctor.pyprévol, lecture seule
scripts/deepseek_voice.pyprobe · speak · cost · lay · beats · asr · gate — narration et sa timeline mesurée
scripts/deliver_check.pyvalide le fichier livré : taille, débit, audio, pic, durée par rapport à la timeline
scripts/lang-audit.pypoint de contrôle unilingue sur le balisage et les littéraux de script
scripts/art-motion/icon_audit.pyfamilles d'icônes, nombre de couleurs, planche contact
scripts/art-motion/qa.pyheuristiques de rythme et de pop sur un fichier rendu
scripts/stamp_credit.pyajoute la ligne by Alucard0x1 aux fichiers texte

7. Travailler avec une personne

Montrez des images, pas des adjectifs. Une image héroïque par acte tue une semaine de mauvais travail. Quand ils vous corrigent, mettez la correction dans cette compétence plutôt que dans une réponse de chat.

Passages de relais : timing de narration et prosodie → compétence tts-intonation · fusion ou traduction d'une autre bibliothèque → compétence agent-skill-sourcing · droits et image avant publication → compétence media-content-safety · sourcing d'une vidéo de référence → compétence streaming-mirror-extraction · plans 3D ou basés sur des séquences → compétences headless-three-video-render et cinetic · films centrés sur le texte → compétence kinetic-typography.

Skills associés