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.
- 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.
- Storyboard avant le HTML —
references/narration-and-captions.md. La légende est le texte parlé mot à mot, pas un résumé. - Narrer et mesurer.
python scripts/deepseek_voice.py beats beats.json film/assets/voice.wav --voice stella --timeline timeline.json, puisgatepour vérifier chaque phrase par ASR. Routage, voix et limites :references/narration/deepseek-tts.md. - 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. - Vérifier, puis regarder.
pulupulu check ., puispulupulu still . --at 2,12,24 --out .om/stillset ouvrez les images. Une page qui passecheckpeut toujours rendre du noir. - Rendu —
pulupulu render . --format mp4 --fps 30. Blocages, images noires et longueurs erronées :references/render-traps.md. - 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.mp4muxe et valide en un seul appel. Recette manuelle et chaîne de ducking :references/workflow.md. - 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. - 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.
| point | commande | ce qu'il prouve | en cas d'échec |
|---|---|---|---|
| prévol | python scripts/doctor.py | la machine peut rendre | stop, signaler ce qui manque |
| composition | pulupulu check . | contrat de page, aucun fichier manquant | corriger avant le rendu |
| langue | python scripts/lang-audit.py film/index.html --lang en | pas de texte dans l'autre langue, y compris les littéraux de chaîne dans <script> | traduire le littéral, relancer |
| parole | python scripts/deepseek_voice.py gate beats.json --voice stella | chaque phrase se retranscrit par ses propres mots | réécrire la phrase ; ne jamais livrer un fragment |
| fichier | python 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 livraison | re-muxer ou re-encoder |
| pops | pulupulu qa out/film.mp4 | pas de pop sur une frame | trouver 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. feTurbulenceen 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: -1rend 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.exeferme le navigateur de l'utilisateur.
5. Où vit le détail
| vous travaillez sur | page |
|---|---|
| commandes, contrat de page, installation | references/cli.md |
| les neuf étapes, contrat de projet, mux | references/workflow.md |
| storyboard, légendes, point de contrôle unilingue | references/narration-and-captions.md |
| palette, budget d'éléments, personnalité, rythme | references/design-taste.md |
| langages de mouvement, techniques, couche 3D | references/motion-library.md |
| punch-up, démo produit, tête parlante, grammaires | references/workflows-specialized.md |
| univers musicaux, compositeur, effetti sonori, synthèse de narration | references/audio-and-music.md, references/narration/deepseek-tts.md |
| un rendu vierge, bloqué ou de longueur erronée | references/render-traps.md |
| quoi vérifier, et dans quel ordre | references/verification.md |
| recettes de style, langage de caméra | references/art-motion/INDEX.md |
| sourcing d'icônes et vecteurs, licences | references/asset-sourcing.md |
| art généré par un modèle d'image, recadrage d'impressions, montage | references/generated-assets.md |
| artisanat vectoriel plat, mondes défilants | references/2d-vector-motion.md |
| quels sujets ce moteur de rendu peut traiter | references/topic-fit.md |
| timing et easing au niveau sous-seconde | references/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
| script | fait |
|---|---|
scripts/doctor.py | prévol, lecture seule |
scripts/deepseek_voice.py | probe · speak · cost · lay · beats · asr · gate — narration et sa timeline mesurée |
scripts/deliver_check.py | valide le fichier livré : taille, débit, audio, pic, durée par rapport à la timeline |
scripts/lang-audit.py | point de contrôle unilingue sur le balisage et les littéraux de script |
scripts/art-motion/icon_audit.py | familles d'icônes, nombre de couleurs, planche contact |
scripts/art-motion/qa.py | heuristiques de rythme et de pop sur un fichier rendu |
scripts/stamp_credit.py | ajoute 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.